Skip to content

getCoreVersion

获取 Core 模块版本号

getCoreVersion 用于查询当前已加载的 Runtime Core(内核引擎) 的具体版本号。

需要注意的是,SDK 的外层封装版本(通过 SUDRTGameRuntime.getRuntimeVersion() 获取)与内核引擎版本(通过此接口获取)可能不同。在进行底层渲染排查或向技术支持反馈问题时,此版本号更具参考价值。


方法声明

java
/**
 * 返回 Runtime Core 模块的版本号。
 * * @return 字符串形式的内核版本号(例如 "2.3.15")。
 */
String getCoreVersion();

运行行为

  1. 内核追溯:该版本号直接反映了底层 JS 引擎、渲染管线和 Native 核心逻辑的迭代状态。
  2. 兼容性基础:许多高级特性(如特定的 Shader 支持或多线程优化)是基于内核版本号开启的。
  3. 零延迟:该信息在 loadCore 成功后已常驻内存,调用时无任何性能开销。

代码示例

java
// 从核心句柄中获取内核版本
String coreVersion = coreHandle.getCoreVersion();

// 打印版本信息
Log.i("SUDOP", "SUD Runtime Core Version: " + coreVersion);

// 业务逻辑应用:针对特定内核版本进行功能降级或开启
if (isVersionBelow(coreVersion, "2.0.0")) {
    Log.w("SUDOP", "Low core version detected, disabling advanced lighting effects.");
}

注意事项

  • 版本独立性:内核版本(Core Version)升级通常意味着渲染性能或脚本执行效率的提升,而 SDK 版本(Runtime Version)升级可能仅是增加了 Java 层的新接口。
  • 日志规范:在应用发生 Crash 并上报日志时,建议同时记录 RuntimeVersionCoreVersion