Skip to content

getCoreAssetsPath

获取 Core 资源根路径

getCoreAssetsPath 返回 Runtime Core 模块使用到的静态资源根路径。这些资源通常包括引擎运行所需的着色器文件(Shaders)、基础字体、默认贴图等内置素材。

该路径是在调用 loadCore 时,通过 KEY_CORE_ASSETS_PATH 传入的。


方法声明

java
/**
 * 返回 Runtime Core 模块使用到资源的根路径。
 * * @return 核心资源所在的绝对路径字符串
 */
String getCoreAssetsPath();

运行行为

  1. 资源定位:引擎在渲染每一帧或初始化基础组件时,会根据此路径寻找必需的底层二进制资源。
  2. 路径验证:如果该路径指向错误或文件缺失,游戏通常会表现为黑屏、文字乱码或渲染异常。
  3. 独立性:此路径通常位于 getCoreRootPath 的子目录下,但在某些自定义部署中也可以配置为独立的物理位置。

代码示例

java
// 从核心句柄中获取资源路径
String assetsPath = coreHandle.getCoreAssetsPath();

// 打印日志以便排查资源加载问题
Log.i("SUDOP", "Core internal assets are located at: " + assetsPath);

// 业务逻辑检查:确保该路径确实存在
File assetsDir = new File(assetsPath);
if (!assetsDir.exists()) {
    Log.e("SUDOP", "Critical Error: Core assets directory is missing!");
}

注意事项

  • 只读性:该路径由 SDK 引擎内部使用,业务层应避免直接修改或删除该目录下的任何内容。
  • 与游戏包资源区分:此路径存放的是“引擎级别”的资源,而具体的游戏素材(如模型、关卡图片)存放在 SUDRTLoadGameParamModel 指定的路径中。