getMiniGameVersion:获取小游戏版本号

更新时间:2026/04/30 访问次数:170

概述

getMiniGameVersion 用于获取当前小游戏的开发者版本号(即发布时设置的版本号)。开发者可以通过该接口在运行时获取当前游戏版本,用于版本展示、日志上报、灰度控制等场景。

注意:

仅高性能模式支持:该接口目前仅在高性能模式下可用。在普通模式下调用不会报错,但始终返回空字符串 ''

使用方式

const sdk = my.tb.getInteractiveSDK();
const version = sdk.getMiniGameVersion();
console.log(version); // 例如 '1.2.3'

返回值

返回值

类型

说明

版本号字符串

string

当前小游戏的开发者版本号,例如 '1.2.3'

''

string

无法获取版本号时返回空字符串

场景假设

开发者需要在游戏界面展示当前版本号,或者根据版本号做灰度发布控制,仅对特定版本启用新功能。

详细过程

步骤一

获取当前小游戏版本号

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、版本号比较建议使用语义化版本比较库,而非简单的字符串比较。

FAQ

关于此文档暂时还没有FAQ
返回
顶部