抖音开放平台Logo
开发者文档
“/”唤起搜索
控制台
  • 开发指南
  • 运行时
  • 运行环境
  • JS 支持情况
  • 运行机制
  • 更新机制
  • 基础库
  • 版本分布
  • 低版本兼容
  • 调试
  • Adapter
  • 游戏引擎
  • 开放能力
  • 基础能力
  • 性能优化
  • 开放接口
  • AI
  • 安全指引
  • 安全指引
  • 低版本兼容

    收藏
    我的收藏
    抖音小游戏目前迭代比较快,各个 app 之间差异也比较大,开发者需要做好兼容工作,避免因为在低版本上使用了一个不兼容的 api 而出现体验问题。一般可以通过版本号比较、api 存在判断、tt.canIUse 三种方式进行兼容处理。另外上线发布的时候也可以选择支持小游戏的最低基础库版本。

    版本号比较

    可以通过tt.getSystemInfo或者tt.getSystemInfoSync得到SDKVersionSDKVersion是三位版本号,由[大版本].[小版本].[修订版本]三部分组成,例如:1.11.1。一般会在 api 文档上标注支持该 api 的最低版本,或者在组件文档上标注支持某个属性的最低版本。

    api 存在判断

    一般新增的 api 在低版本基础库上是不存在的,贸然调用会导致错误。建议做如下判断:
    if (tt.navigateToMiniProgram) { tt.navigateToMiniProgram(); } else { tt.showModal({ title: "提示", content: "当前客户端版本过低,无法使用该功能,请升级客户端或关闭后重启更新。", }); }

    基础库最低版本限制

    可在 小游戏管理页 【设置】-【基础设置】- 【服务与功能】-【基础库最低版本号】中设置