bd21ad9b63d9e3cba9431abca9625ce120a237d7.js 14 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480
  1. System.register(["cc"], function (_export, _context) {
  2. "use strict";
  3. var _cclegacy, __checkObsolete__, __checkObsoleteInNamespace__, Asset, assetManager, error, js, resources, warn, ResLoader, _crd, resLoader;
  4. _export("ResLoader", void 0);
  5. return {
  6. setters: [function (_cc) {
  7. _cclegacy = _cc.cclegacy;
  8. __checkObsolete__ = _cc.__checkObsolete__;
  9. __checkObsoleteInNamespace__ = _cc.__checkObsoleteInNamespace__;
  10. Asset = _cc.Asset;
  11. assetManager = _cc.assetManager;
  12. error = _cc.error;
  13. js = _cc.js;
  14. resources = _cc.resources;
  15. warn = _cc.warn;
  16. }],
  17. execute: function () {
  18. _crd = true;
  19. _cclegacy._RF.push({}, "1a2e4jFffpHrYjrpxbnC760", "ResLoader", undefined);
  20. __checkObsolete__(['Asset', 'AssetManager', '__private', 'assetManager', 'error', 'js', 'resources', 'warn']);
  21. /**
  22. * 游戏资源管理
  23. * 1、加载默认resources文件夹中资源
  24. * 2、加载默认bundle远程资源
  25. * 3、主动传递bundle名时,优先加载传递bundle名资源包中的资源
  26. *
  27. * @help https://gitee.com/dgflash/oops-framework/wikis/pages?sort_id=12037901&doc_id=2873565
  28. */
  29. _export("ResLoader", ResLoader = class ResLoader {
  30. constructor() {
  31. //#region 资源配置数据
  32. /** 全局默认加载的资源包名 */
  33. this.defaultBundleName = "resources";
  34. /** 是否使用远程 CDN 资源 */
  35. this.cdn = false;
  36. /** 资源包配置 */
  37. this.bundles = new Map();
  38. }
  39. /** 下载时的最大并发数 - 项目设置 -> 项目数据 -> 资源下载并发数,设置默认值;初始值为15 */
  40. get maxConcurrency() {
  41. return assetManager.downloader.maxConcurrency;
  42. }
  43. set maxConcurrency(value) {
  44. assetManager.downloader.maxConcurrency = value;
  45. }
  46. /** 下载时每帧可以启动的最大请求数 - 默认值为15 */
  47. get maxRequestsPerFrame() {
  48. return assetManager.downloader.maxRequestsPerFrame;
  49. }
  50. set maxRequestsPerFrame(value) {
  51. assetManager.downloader.maxRequestsPerFrame = value;
  52. }
  53. /** 失败重试次数 - 默认值为0 */
  54. get maxRetryCount() {
  55. return assetManager.downloader.maxRetryCount;
  56. }
  57. set maxRetryCount(value) {
  58. assetManager.downloader.maxRetryCount = value;
  59. }
  60. /** 重试的间隔时间,单位为毫秒 - 默认值为2000毫秒 */
  61. get retryInterval() {
  62. return assetManager.downloader.retryInterval;
  63. }
  64. set retryInterval(value) {
  65. assetManager.downloader.retryInterval = value;
  66. }
  67. //#endregion
  68. init(config) {
  69. this.cdn = config.enable;
  70. for (let bundleName in config.packages) {
  71. this.bundles.set(bundleName, config.packages[bundleName]);
  72. }
  73. } //#region 加载远程资源
  74. /**
  75. * 加载远程资源
  76. * @param url 资源地址
  77. * @param options 资源参数,例:{ ext: ".png" }
  78. * @param onComplete 加载完成回调
  79. * @example
  80. var opt: IRemoteOptions = { ext: ".png" };
  81. var onComplete = (err: Error | null, data: ImageAsset) => {
  82. const texture = new Texture2D();
  83. texture.image = data;
  84. const spriteFrame = new SpriteFrame();
  85. spriteFrame.texture = texture;
  86. var sprite = this.sprite.addComponent(Sprite);
  87. sprite.spriteFrame = spriteFrame;
  88. }
  89. oops.res.loadRemote<ImageAsset>(this.url, opt, onComplete);
  90. */
  91. loadRemote(url, ...args) {
  92. let options = null;
  93. let onComplete = null;
  94. if (args.length == 2) {
  95. options = args[0];
  96. onComplete = args[1];
  97. } else {
  98. onComplete = args[0];
  99. }
  100. assetManager.loadRemote(url, options, onComplete);
  101. } //#endregion
  102. //#region 资源包管理
  103. /**
  104. * 加载资源包
  105. * @param url 资源地址
  106. * @param v 资源MD5版本号
  107. * @example
  108. var serverUrl = "http://192.168.1.8:8080/"; // 服务器地址
  109. var md5 = "8e5c0"; // Cocos Creator 构建后的MD5字符
  110. await oops.res.loadBundle(serverUrl,md5);
  111. */
  112. loadBundle(url, v) {
  113. return new Promise((resolve, reject) => {
  114. assetManager.loadBundle(url, {
  115. version: v
  116. }, (err, bundle) => {
  117. if (err) {
  118. return error(err);
  119. }
  120. resolve(bundle);
  121. });
  122. });
  123. }
  124. /**
  125. * 释放资源包与包中所有资源
  126. * @param bundleName 资源地址
  127. */
  128. removeBundle(bundleName) {
  129. let bundle = assetManager.bundles.get(bundleName);
  130. if (bundle) {
  131. bundle.releaseAll();
  132. assetManager.removeBundle(bundle);
  133. }
  134. } //#endregion
  135. //#region 预加载资源
  136. /**
  137. * 加载一个资源
  138. * @param bundleName 远程包名
  139. * @param paths 资源路径
  140. * @param type 资源类型
  141. * @param onProgress 加载进度回调
  142. * @param onComplete 加载完成回调
  143. */
  144. preload(bundleName, paths, type, onProgress, onComplete) {
  145. let args = null;
  146. if (typeof paths === "string" || paths instanceof Array) {
  147. args = this.parseLoadResArgs(paths, type, onProgress, onComplete);
  148. args.bundle = bundleName;
  149. } else {
  150. args = this.parseLoadResArgs(bundleName, paths, type, onProgress);
  151. args.bundle = this.defaultBundleName;
  152. }
  153. args.preload = true;
  154. this.loadByArgs(args);
  155. }
  156. /**
  157. * 异步加载一个资源
  158. * @param bundleName 远程包名
  159. * @param paths 资源路径
  160. * @param type 资源类型
  161. */
  162. preloadAsync(bundleName, paths, type) {
  163. return new Promise((resolve, reject) => {
  164. this.preload(bundleName, paths, type, (err, data) => {
  165. if (err) {
  166. warn(err.message);
  167. }
  168. resolve(data);
  169. });
  170. });
  171. }
  172. /**
  173. * 预加载文件夹中的资源
  174. * @param bundleName 远程包名
  175. * @param dir 文件夹名
  176. * @param type 资源类型
  177. * @param onProgress 加载进度回调
  178. * @param onComplete 加载完成回调
  179. */
  180. preloadDir(bundleName, dir, type, onProgress, onComplete) {
  181. let args = null;
  182. if (typeof dir === "string") {
  183. args = this.parseLoadResArgs(dir, type, onProgress, onComplete);
  184. args.bundle = bundleName;
  185. } else {
  186. args = this.parseLoadResArgs(bundleName, dir, type, onProgress);
  187. args.bundle = this.defaultBundleName;
  188. }
  189. args.dir = args.paths;
  190. args.preload = true;
  191. this.loadByArgs(args);
  192. } //#endregion
  193. //#region 资源加载、获取、释放
  194. /**
  195. * 加载一个资源
  196. * @param bundleName 远程包名
  197. * @param paths 资源路径
  198. * @param type 资源类型
  199. * @param onProgress 加载进度回调
  200. * @param onComplete 加载完成回调
  201. * @example
  202. oops.res.load("spine_path", sp.SkeletonData, (err: Error | null, sd: sp.SkeletonData) => {
  203. });
  204. */
  205. load(bundleName, paths, type, onProgress, onComplete) {
  206. let args = null;
  207. if (typeof paths === "string" || paths instanceof Array) {
  208. args = this.parseLoadResArgs(paths, type, onProgress, onComplete);
  209. args.bundle = bundleName;
  210. } else {
  211. args = this.parseLoadResArgs(bundleName, paths, type, onProgress);
  212. args.bundle = this.defaultBundleName;
  213. }
  214. this.loadByArgs(args);
  215. }
  216. /**
  217. * 异步加载一个资源
  218. * @param bundleName 远程包名
  219. * @param paths 资源路径
  220. * @param type 资源类型
  221. */
  222. loadAsync(bundleName, paths, type) {
  223. return new Promise((resolve, reject) => {
  224. this.load(bundleName, paths, type, (err, asset) => {
  225. if (err) {
  226. warn(err.message);
  227. }
  228. resolve(asset);
  229. });
  230. });
  231. }
  232. /**
  233. * 加载文件夹中的资源
  234. * @param bundleName 远程包名
  235. * @param dir 文件夹名
  236. * @param type 资源类型
  237. * @param onProgress 加载进度回调
  238. * @param onComplete 加载完成回调
  239. * @example
  240. // 加载进度事件
  241. var onProgressCallback = (finished: number, total: number, item: any) => {
  242. console.log("资源加载进度", finished, total);
  243. }
  244. // 加载完成事件
  245. var onCompleteCallback = () => {
  246. console.log("资源加载完成");
  247. }
  248. oops.res.loadDir("game", onProgressCallback, onCompleteCallback);
  249. */
  250. loadDir(bundleName, dir, type, onProgress, onComplete) {
  251. let args = null;
  252. if (typeof dir === "string") {
  253. args = this.parseLoadResArgs(dir, type, onProgress, onComplete);
  254. args.bundle = bundleName;
  255. } else {
  256. args = this.parseLoadResArgs(bundleName, dir, type, onProgress);
  257. args.bundle = this.defaultBundleName;
  258. }
  259. args.dir = args.paths;
  260. this.loadByArgs(args);
  261. }
  262. /**
  263. * 通过资源相对路径释放资源
  264. * @param path 资源路径
  265. * @param bundleName 远程资源包名
  266. */
  267. release(path, bundleName = this.defaultBundleName) {
  268. const bundle = assetManager.getBundle(bundleName);
  269. if (bundle) {
  270. const asset = bundle.get(path);
  271. if (asset) {
  272. this.releasePrefabtDepsRecursively(asset);
  273. }
  274. }
  275. }
  276. /**
  277. * 通过相对文件夹路径删除所有文件夹中资源
  278. * @param path 资源文件夹路径
  279. * @param bundleName 远程资源包名
  280. */
  281. releaseDir(path, bundleName = this.defaultBundleName) {
  282. const bundle = assetManager.getBundle(bundleName);
  283. if (bundle) {
  284. var infos = bundle.getDirWithPath(path);
  285. if (infos) {
  286. infos.map(info => {
  287. this.releasePrefabtDepsRecursively(info.uuid);
  288. });
  289. }
  290. if (path == "" && bundleName != "resources") {
  291. assetManager.removeBundle(bundle);
  292. }
  293. }
  294. }
  295. /** 释放预制依赖资源 */
  296. releasePrefabtDepsRecursively(uuid) {
  297. if (uuid instanceof Asset) {
  298. uuid.decRef(); // assetManager.releaseAsset(uuid);
  299. } else {
  300. const asset = assetManager.assets.get(uuid);
  301. if (asset) {
  302. asset.decRef(); // assetManager.releaseAsset(asset);
  303. }
  304. }
  305. }
  306. /**
  307. * 获取资源
  308. * @param path 资源路径
  309. * @param type 资源类型
  310. * @param bundleName 远程资源包名
  311. */
  312. get(path, type, bundleName = this.defaultBundleName) {
  313. var bundle = assetManager.getBundle(bundleName);
  314. return bundle.get(path, type);
  315. } //#endregion
  316. parseLoadResArgs(paths, type, onProgress, onComplete) {
  317. let pathsOut = paths;
  318. let typeOut = type;
  319. let onProgressOut = onProgress;
  320. let onCompleteOut = onComplete;
  321. if (onComplete === undefined) {
  322. const isValidType = js.isChildClassOf(type, Asset);
  323. if (onProgress) {
  324. onCompleteOut = onProgress;
  325. if (isValidType) {
  326. onProgressOut = null;
  327. }
  328. } else if (onProgress === undefined && !isValidType) {
  329. onCompleteOut = type;
  330. onProgressOut = null;
  331. typeOut = null;
  332. }
  333. if (onProgress !== undefined && !isValidType) {
  334. onProgressOut = type;
  335. typeOut = null;
  336. }
  337. }
  338. return {
  339. paths: pathsOut,
  340. type: typeOut,
  341. onProgress: onProgressOut,
  342. onComplete: onCompleteOut
  343. };
  344. }
  345. loadByBundleAndArgs(bundle, args) {
  346. if (args.dir) {
  347. if (args.preload) {
  348. bundle.preloadDir(args.paths, args.type, args.onProgress, args.onComplete);
  349. } else {
  350. bundle.loadDir(args.paths, args.type, args.onProgress, args.onComplete);
  351. }
  352. } else {
  353. if (args.preload) {
  354. bundle.preload(args.paths, args.type, args.onProgress, args.onComplete);
  355. } else {
  356. bundle.load(args.paths, args.type, args.onProgress, args.onComplete);
  357. }
  358. }
  359. }
  360. async loadByArgs(args) {
  361. if (args.bundle) {
  362. let bundle = assetManager.bundles.get(args.bundle); // 获取缓存中的资源包
  363. if (bundle) {
  364. this.loadByBundleAndArgs(bundle, args);
  365. } // 自动加载资源包
  366. else {
  367. const v = this.cdn ? this.bundles.get(args.bundle) : "";
  368. bundle = await this.loadBundle(args.bundle, v);
  369. if (bundle) this.loadByBundleAndArgs(bundle, args);
  370. }
  371. } // 默认资源包
  372. else {
  373. this.loadByBundleAndArgs(resources, args);
  374. }
  375. }
  376. /** 打印缓存中所有资源信息 */
  377. dump() {
  378. assetManager.assets.forEach((value, key) => {
  379. console.log(assetManager.assets.get(key));
  380. });
  381. console.log(`当前资源总数:${assetManager.assets.count}`);
  382. }
  383. });
  384. _export("resLoader", resLoader = new ResLoader());
  385. _cclegacy._RF.pop();
  386. _crd = false;
  387. }
  388. };
  389. });
  390. //# sourceMappingURL=bd21ad9b63d9e3cba9431abca9625ce120a237d7.js.map