抖音云SDK最低版本要求

我的收藏

介绍

目前，抖音云提供的小程序，小游戏，小玩法等API，都有抖音的客户端版本限制，在某些低版本客户端上可能无法使用，开发者在使用抖音云相关API 时，建议根据应用的实际基础库分布情况，设置应用对应的最低级基础库版本要求。随后在业务代码中可采用 tt.canIuse 判断抖音云相关 API 是否可用，若不可用提示用户进行客户端升级。若可用的情况下，再开发后续的业务逻辑。

操作指引

名词解释

小程序基础库：抖音客户端内置的小程序容器，为小程序，小游戏等提供运行时容器。

查看应用中基础库的分布情况

所有小程序用户版本分布详情见版本分布及各 APP 对应关系，如何查看当前应用内基础库分布情况步骤如下：

开发者在抖音开放平台登录后，可点击进入应用对应的控制台，打开「基础设置」页面。

点击基础设置后，滚动至小程序基础库版本，点击修改后（管理员才可点击）。可查看当前应用的基础库分布情况。

可点击对应版本，设置小程序最低的基础库要求，这样在用户首次进入小程序时，若小程序基础库版本过低会提示用户需要手动升级客户端。详见：兼容性说明

Android	IOS

建议采用 canIuse 对抖音云相关 API 进行判断，当为 false 时，表示版本过低，该 API 无法使用，建议开发者提示用户升级抖音客户端版本。

以 tt.createCloud 为例。

通过 canIuse 这个 API 来判断当前版本下的抖音客户端是否可用 tt.createCloud。若不可用可通过modal 弹窗提示用户升级。

if (!tt.canIUse('createCloud')) {
            console.log(e.type);
        }

调试结果如下：

true 表示该API 可用，false 表示不可用，需开发者提示用户进行抖音客户端升级，语句如下：

if (!tt.canIUse('createCloud')) {
           tt.showModal({
              title: "提示",
              content: "当前客户端版本过低，无法使用该功能，请升级客户端或关闭后重启更新。",
       });
      }

查看基础库版本，点击关于进入小程序详情介绍，随后应用名称连续点4下获取baseBundleVersion，为小程序基础库版本，可到对应 API 下查看支持的基础库和抖音客户端版本号。

抖音云相关API 兼容判断处理

各个 API 兼容判断语句如下：

callContainer

console.log('caniuse', tt.canIUse("createCloud.return.callContainer"));

CloudID

console.log('caniuse', tt.canIUse("createCloud.return.CloudID"));

uploadFile

console.log('caniuse', tt.canIUse("createCloud.return.uploadFile"));

downloadFile

console.log('caniuse', tt.canIUse("createCloud.return.downloadFile"));

deleteFile

console.log('caniuse', tt.canIUse("createCloud.return.deleteFile"));

getTempFileURL

console.log('caniuse', tt.canIUse("createCloud.return.getTempFileURL"));

connectContainer

console.log('caniuse', tt.canIUse("createCloud.return.connectContainer"));

云数据库

console.log('caniuse', tt.canIUse("createCloud.return.database"));