目录— 个文件
⌕
目录加载中…
…/core/resource/ResourceFrameConfig.ts
1import { Enum } from 'cc';
2// 框架资源类型与通用策略;项目具体配置只在 Bridge 的 ResourceConfig.ts 创建。
3/**
4 * 资源加载模式
5 */
6export enum ResourceMode {
7 Local, //本地加载
8 Remote, //远程加载
9 LocalSimulateRemote, //本地模拟远程加载
10}
11
12
13Enum(ResourceMode)
14
15/** Bundle 名称到 Cocos 编辑器版本码的映射;空字符串表示配置文件为 config.json。 */
16export type BundleVersionConfig = Record<string, string>;
17
18
19/** 通用资源配置结构;具体项目值由入口在编辑器配置同步前提供。 */
20export interface ResourceSettings {
21 RemoteUrl: string;
22 LocalSimulateUrl: string;
23 ResourceMode: ResourceMode;
24 BundleVersion: string;
25}
26
27/**
28 * 资源加载重试配置
29 */
30export const ResourceRetryConfig = {
31 /** 最大重试次数(默认3次,总计最多执行4次) */
32 maxRetryCount: 3,
33 /** 重试间隔(毫秒),默认5000ms */
34 retryInterval: 5000,
35}
36
37/**
38 * Bundle 全量加载配置
39 */
40export const ResourceBundleLoadConfig = {
41 /** Bundle 加载完成后是否全量预加载 Bundle 内所有资源 */
42 preloadAllBundleAssets: false,
43}
讲解44 行
资源配置与通用策略常量人工通读
ResourceFrameConfig.ts
定义资源加载模式枚举、项目资源配置结构、重试策略和 Bundle 全量预加载开关。具体 RemoteUrl、版本表等值由入口注入,本文件只提供框架通用默认值。
先看 ResourceMode 三种模式,再看 ResourceRetryConfig 与 ResourceBundleLoadConfig 的默认值。
特殊处理与易错点
- 设计maxRetryCount 为 3,配合循环从 0 开始,实际最多尝试 4 次,重试间隔默认 5000ms。
- 设计preloadAllBundleAssets 默认 false,只有调用方显式开启才会在 Bundle 加载后全量预加载。
- 易错点BundleVersion 为空字符串时远程配置直接读 config.json,非空时才拼 config.<version>.json。
6注释框架资源类型与通用策略;项目具体配置只在 Bridge 的 ResourceConfig.ts 创建。
16注释Bundle 名称到 Cocos 编辑器版本码的映射;空字符串表示配置文件为 config.json。
20注释通用资源配置结构;具体项目值由入口在编辑器配置同步前提供。
21属性通用资源配置结构;具体项目值由入口在编辑器配置同步前提供。
22属性通用资源配置结构;具体项目值由入口在编辑器配置同步前提供。
23属性资源加载模式枚举,Local 本地、Remote 远程、LocalSimulateRemote 本地模拟远程。
24属性资源包 Version(string):该模块的运行态字段。
30注释资源加载重试配置
32注释最大重试次数(默认3次,总计最多执行4次)
34注释重试间隔(毫秒),默认5000ms
40注释Bundle 全量加载配置
42注释Bundle 加载完成后是否全量预加载 Bundle 内所有资源