目录— 个文件
⌕
目录加载中…
…/resource/findobjects/ResourceBundleLoaderFindObjects.ts
1import { ResourceBundleLoader } from "../loader/ResourceBundleLoader";
2import { ScriptlessLevelBundleDownloader } from "./ScriptlessLevelBundleDownloader";
3import { ResourceInfo } from "../ResourceInfo";
4import { BundleVersionConfig } from "../ResourceFrameConfig";
5import { GetCommonResourcePath, GetProjectResourcePath, ResourceConfigFindObjects } from "./ResourceConfigFindObjects";
6import { Framework } from "../../../Framework";
7import { ProjectEnv, SdkChannel } from "../../../module/sdk/SdkChannel";
8import { SdkConfig } from "../../../module/sdk/SdkConfig";
9
10/** 公司寻物游戏共用的资源规则;不复制通用加载、缓存和释放流程。 */
11export class ResourceBundleLoaderFindObjects extends ResourceBundleLoader {
12 /** 项目传入版本表标识;构造时不读取配置、不加载资源,也不提供默认项目名称。 */
13 constructor(
14 private readonly bundleVersionWechatConfigName: string,
15 private readonly bundleVersionWebConfigName: string,
16 ) {
17 super();
18 }
19
20 /** 只有选用寻物加载器才安装无脚本关卡包适配,保持原管理器初始化时机。 */
21 public Init(): void {
22 ScriptlessLevelBundleDownloader.Register();
23 }
24
25 /** 退出寻物资源生命周期时恢复下载器,避免影响后续通用项目。 */
26 public DeInit(): void {
27 ScriptlessLevelBundleDownloader.Unregister();
28 }
29
30 /** 寻物远程和模拟模式共用相同的渠道版本表。 */
31 private get BundleVersionConfigName(): string {
32 if (SdkConfig.Channel === SdkChannel.TalentWeb
33 || SdkConfig.Channel === SdkChannel.Test
34 || SdkConfig.Channel === SdkChannel.Try) {
35 return this.bundleVersionWebConfigName;
36 }
37 return this.bundleVersionWechatConfigName;
38 }
39
40 /**
41 * 按关卡资源命名规则解析 ResourceInfo。
42 * 关卡资源不写入 resource_config.json,命名约定如下:
43 * - 物件/大图:30001_x...、30001_1_x... -> 定位 level30001/level30001_1
44 * - 图集:level30001-1、level30001_1-1 -> 定位 level30001/level30001_1
45 */
46 public ResolveResourceInfoByName(assetName: string): ResourceInfo | null {
47 if (!assetName) {
48 return null;
49 }
50 const targetName = assetName.trim();
51 if (!targetName) {
52 return null;
53 }
54
55 const levelBundleName = this.ResolveLevelBundleName(targetName);
56 if (!levelBundleName) {
57 return null;
58 }
59
60 return {
61 Name: targetName,
62 Path: `${levelBundleName}/${targetName}`,
63 Bundle: levelBundleName,
64 InBundlePath: targetName,
65 Type: "",
66 };
67 }
68
69 /**
70 * 解析关卡 Bundle 名称
71 * @param assetName 资源名称
72 * @returns Bundle名称
73 */
74 private ResolveLevelBundleName(assetName: string): string | null {
75 const levelAtlasMatch = assetName.match(/^level(\d{5,}(?:_\d+)?)(?:-\d+)?$/i);
76 if (levelAtlasMatch) {
77 return `level${levelAtlasMatch[1]}`;
78 }
79
80 const levelSpriteMatch = assetName.match(/^(\d{5,}(?:_\d+)?)(?:_|-)/);
81 if (levelSpriteMatch) {
82 return `level${levelSpriteMatch[1]}`;
83 }
84
85 return null;
86 }
87
88
89 /** 保留关卡与项目包各自的目录版本规则。 */
90 protected GetRemoteBundlePath(bundleName: string): string {
91 if (/^level\d+(?:_\d+)?$/i.test(bundleName)) {
92 return GetCommonResourcePath(`LevelBundle/${ResourceConfigFindObjects.Config.LevelBundleVersion}/${bundleName}`);
93 }
94 const dir = SdkConfig.Env === ProjectEnv.Online ? "Online" : "Test";
95 return GetProjectResourcePath(`${dir}/${Framework.Res.Config.BundleVersion}/Bundle/${bundleName}`);
96 }
97
98 /** 仅关卡包查询版本表;缺失/空版本保持原提示与调用方参数优先级。 */
99 protected GetBundleVersion(bundleName: string): string {
100 if (!/^level\d+(?:_\d+)?$/i.test(bundleName)) {
101 return "";
102 }
103 const versions = Framework.Config.GetConfig<BundleVersionConfig>(this.BundleVersionConfigName);
104 if (versions[bundleName] === undefined) {
105 Framework.Log.Error("ResourceBundleLoader", "Bundle 版本配置不存在", bundleName);
106 }
107 return versions[bundleName] ?? "";
108 }
109
110 /** 寻物只模拟关卡包与 findConfig,其他包保持本地加载。 */
111 protected IsSimulatedBundle(bundleName: string): boolean {
112 return /^level\d+(?:_\d+)?$/i.test(bundleName) || bundleName === "findConfig";
113 }
114}
讲解115 行
寻物项目 Bundle 加载器人工通读
ResourceBundleLoaderFindObjects.ts
继承通用 Bundle 加载器,只覆写项目相关的路径、版本和模拟范围,并安装纯资源关卡包的下载适配。入口把它注入 ResourceManager,使关卡包 URL 与配置版本按寻物规则生成。
先看 ResolveResourceInfoByName 的关卡命名规则,再看 GetRemoteBundlePath、GetBundleVersion 与 IsSimulatedBundle。
特殊处理与易错点
- 初始化顺序依赖Init 才注册无脚本下载器,DeInit 撤销;加载器必须在 ResourceManager.Init 前注入,否则适配不会安装。L21
- 特殊处理TalentWeb、Test、Try 三个渠道读 Web 版本表,其余渠道读微信版本表,选择发生在每次取值时。L31
- 易错点只有关卡包查询版本表,项目包一律返回空版本,调用方传入的 version 不会被覆盖。L99
- 设计模拟远程只覆盖关卡包和 findConfig,其他包仍走本地加载,避免把大厅资源错误指向模拟服务器。L110
11注释ResourceBundleLoaderFindObjects:公司寻物游戏共用的资源规则;不复制通用加载、缓存和释放流程。
13方法只保存两个版本配置名并调用父类构造,不读取配置也不加载资源。
21方法调用无脚本下载器的 Register 安装关卡包适配,保持管理器原初始化时机。
26方法调用无脚本下载器的 Unregister 撤销适配,避免影响后续通用项目。
31方法按当前渠道选择版本表配置名,Web 类渠道返回 Web 表名,其余返回微信表名。
46方法去空白后按关卡命名推导 Bundle 名,命中即构造包内路径相同的资源条目。
74方法先用图集正则匹配 level 前缀,再用物件正则匹配纯数字前缀,命中都补 level 前缀返回。
90方法关卡包走 Common 下按关卡版本拼路径,项目包按 Online 或 Test 加项目版本拼路径。
99方法非关卡包返回空串,关卡包从版本表读取版本,缺失时打错误并返回空串。
111方法判断是否为关卡包或 findConfig,是则允许在模拟远程模式下走模拟服务器。