抖音云SDK最低版本要求
收藏
我的收藏介绍
目前,抖音云提供的小程序,小游戏,小玩法等API,都有抖音的客户端版本限制,在某些低版本客户端上可能无法使用,开发者在使用抖音云相关API 时,建议根据应用的实际基础库分布情况,设置应用对应的最低级基础库版本要求。随后在业务代码中可采用 tt.canIuse 判断抖音云相关 API 是否可用,若不可用提示用户进行客户端升级。若可用的情况下,再开发后续的业务逻辑。
操作指引
名词解释
小程序基础库:抖音客户端内置的小程序容器,为小程序,小游戏等提供运行时容器。
查看应用中基础库的分布情况
- 1.开发者在抖音开放平台登录后,可点击进入应用对应的控制台,打开「基础设置」页面。
- 2.点击基础设置后,滚动至小程序基础库版本,点击修改后(管理员才可点击)。可查看当前应用的基础库分布情况。
- 3.可点击对应版本,设置小程序最低的基础库要求,这样在用户首次进入小程序时,若小程序基础库版本过低会提示用户需要手动升级客户端。详见:兼容性说明
Android | IOS |
| |
- 4.建议采用 canIuse 对抖音云相关 API 进行判断,当为 false 时,表示版本过低,该 API 无法使用,建议开发者提示用户升级抖音客户端版本。
- 5.以 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: "当前客户端版本过低,无法使用该功能,请升级客户端或关闭后重启更新。", }); }
- 1.查看基础库版本,点击关于进入小程序详情介绍,随后应用名称连续点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"));