getMiniGameVersion 用于获取当前小游戏的开发者版本号(即发布时设置的版本号)。开发者可以通过该接口在运行时获取当前游戏版本,用于版本展示、日志上报、灰度控制等场景。
注意:
仅高性能模式支持:该接口目前仅在高性能模式下可用。在普通模式下调用不会报错,但始终返回空字符串 ''。
const sdk = my.tb.getInteractiveSDK(); const version = sdk.getMiniGameVersion(); console.log(version); // 例如 '1.2.3'
返回值 |
类型 |
说明 |
版本号字符串 |
|
当前小游戏的开发者版本号,例如 |
|
|
无法获取版本号时返回空字符串 |
开发者需要在游戏界面展示当前版本号,或者根据版本号做灰度发布控制,仅对特定版本启用新功能。
const sdk = my.tb.getInteractiveSDK();
const version = sdk.getMiniGameVersion();
console.log('当前版本:', version);
const sdk = my.tb.getInteractiveSDK();
const version = sdk.getMiniGameVersion();
if (version) {
// 在游戏中展示版本号
showVersionLabel(`v${version}`);
// 或者根据版本做灰度控制
if (version >= '2.0.0') {
enableNewFeature();
}
} else {
// 无法获取版本号,使用默认逻辑
console.warn('无法获取小游戏版本号');
}
1、该接口为同步接口,无需 await。
2、在普通模式下或版本信息尚未初始化时,返回空字符串 '',不会抛出异常。
3、版本号比较建议使用语义化版本比较库,而非简单的字符串比较。