目录— 个文件
⌕
目录加载中…
…/resource/findobjects/ResourceConfigFindObjects.ts
1import { Framework } from "../../../Framework";
2import { CHANNEL_RESOURCE_DIRECTORY, ProjectEnv } from '../../../module/sdk/SdkChannel';
3import { SdkConfig } from '../../../module/sdk/SdkConfig';
4
5/** 寻物资源布局配置;项目目录和关卡版本由 Bridge 提供。 */
6export interface ResourceFindObjectsSettings {
7 BasePath: string;
8 ProjectPath: string;
9 LevelBundleVersion: string;
10}
11
12/** 寻物配置接入点:只持有 Bridge 原引用,不创建默认配置或副本。 */
13export class ResourceConfigFindObjects {
14 private static config: ResourceFindObjectsSettings | null = null;
15
16 /** 返回项目原对象;遗漏启动注入时直接报错,不用空路径继续加载。 */
17 public static get Config(): ResourceFindObjectsSettings {
18 if (!this.config) {
19 throw new Error("[ResourceConfigFindObjects] 请先通过 SetConfig 设置寻物资源配置");
20 }
21 return this.config;
22 }
23
24 /** 项目入口在配置同步、加载器初始化前注入;重启时仍传递同一项目对象。 */
25 public static SetConfig(config: ResourceFindObjectsSettings): void {
26 this.config = config;
27 }
28}
29
30/** 渠道目录规则属于公司寻物模块,读取实时配置以保持配置同步/重启行为。 */
31function GetChannelResourceRootPath(): string {
32 const channelDirectory = CHANNEL_RESOURCE_DIRECTORY[SdkConfig.Channel];
33 return `${Framework.Res.Config.RemoteUrl}${ResourceConfigFindObjects.Config.BasePath}${channelDirectory}/`;
34}
35
36/** 项目资源沿用渠道目录下的项目子目录。 */
37export function GetProjectResourcePath(relativePath: string): string {
38 return `${GetChannelResourceRootPath()}${ResourceConfigFindObjects.Config.ProjectPath}${relativePath}`;
39}
40
41/** 当前渠道、项目和环境的 OSS 目录;启动配置及单关点位共用,实时读取最终配置。 */
42export function GetOSSRootPath(): string {
43 const directory = SdkConfig.Env === ProjectEnv.Online ? "Online" : "Test";
44 return GetProjectResourcePath(`${directory}/`);
45}
46
47/** 多个寻物项目共用的资源固定存放于 Common 目录。 */
48export function GetCommonResourcePath(relativePath: string): string {
49 return `${GetChannelResourceRootPath()}Common/${relativePath}`;
50}
讲解51 行
寻物资源路径规则人工通读
ResourceConfigFindObjects.ts
保存寻物项目的 BasePath、ProjectPath 与关卡版本,并提供拼接渠道目录、项目目录、OSS 根目录和 Common 目录的函数。Bundle 加载器与业务侧通过它生成远程资源地址。
先看 Config 与 SetConfig 的报错约束,再看四个路径函数如何依赖渠道目录。
特殊处理与易错点
- 异常兜底未注入配置时读取 Config 直接抛错,不提供空路径默认值,启动装配遗漏会立刻暴露。L16
- 初始化顺序依赖SetConfig 不限制时机,但必须在任何路径拼接前调用,注入的是项目原对象而非副本。L25
- 易错点渠道目录按当前 SdkConfig.Channel 实时查表,渠道未登记时会拼出 undefined 字符串。L32
6注释寻物资源布局配置;项目目录和关卡版本由 Bridge 提供。
7属性Base 路径(string):该模块的运行态字段。
8属性Project 路径(string):该模块的运行态字段。
9属性关卡 资源包 Version(string):该模块的运行态字段。
13注释ResourceConfigFindObjects:寻物配置接入点:只持有 Bridge 原引用,不创建默认配置或副本。
17方法静态取值器,未设置时抛错,已设置则原样返回项目配置对象。
25方法静态方法,把项目传入的配置对象引用直接保存,不做校验也不复制。
31方法拼接远程根地址、BasePath 与当前渠道目录,形成渠道资源根路径。
37方法在渠道根路径后追加项目目录和相对路径,生成项目资源地址。
42方法按环境选择 Online 或 Test 目录,再拼到项目路径下作为 OSS 根目录。
48方法在渠道根路径后拼 Common 与相对路径,供多个寻物项目共用资源。