更新记录
1.0.8(2025-05-20)
增加授权登录codeVerifier字段返回。
1.0.7(2025-05-19)
增加图片和视频分享接口。
1.0.6(2025-05-09)
优化iOS端回调处理。
查看更多平台兼容性
uni-app
Vue2 | Vue3 | Chrome | Safari | app-vue | app-nvue | Android | iOS | 鸿蒙 |
---|---|---|---|---|---|---|---|---|
√ | √ | - | - | - | - | 5.0 | 12 | - |
微信小程序 | 支付宝小程序 | 抖音小程序 | 百度小程序 | 快手小程序 | 京东小程序 | 鸿蒙元服务 | QQ小程序 | 飞书小程序 | 快应用-华为 | 快应用-联盟 |
---|---|---|---|---|---|---|---|---|---|---|
- | - | - | - | - | - | - | - | - | - | - |
uni-app x
Chrome | Safari | Android | iOS | 鸿蒙 | 微信小程序 |
---|---|---|---|---|---|
- | - | 5.0 | 12 | - | - |
TikTok授权登录 UTS插件接口文档
注意事项:
1、Android 11以上需要配置通用链接,不然会导致 sdk找不到 tiktokapp 所以就会默认打开浏览器授权。
2、部分国产手机可能国产系统做过很多权限限制,也会默认打开浏览器授权,用 google 虚拟机就没问题。
1. UTS插件
<script>
//UTS插件
import * as TikTok from "@/uni_modules/Lizii-TikTok";
export default {
}
</script>
2. 检查TikTok是否安装
var ret = TikTok.isAppInstalled();
if (res == true) {
//已安装TikTok
} else {
//未安装TikTok
}
3. 授权登录
//授权登录
TikTok.authorize({
clientKey:"awqb20yd4h43j011",//仅Android有效,iOS通过在info.plist里配置
scopes:["user.info.basic"],// 用户授权时必选权限
redirectUri:"https://xxx.xxx.com",//通用链接,Android端redirectUri字段、TikTok后台设置和Manifest.xml里配置scheme + host 三者保持一致, iOS端redirectUri字段、TikTok后台设置和UTS.entitlements里配置 三者保持一致
state:"123"//用于保持请求和回调的状态,授权请求后原样带回给第三方,可传任意String
}, function(res){
console.log(res);
uni.showModal({
content:JSON.stringify(res)
});
//res.errorCode //OK = 0 授权成功, ERROR_UNKNOW = -1 未知错误, ERROR_CANCEL = -2 用户手动取消 更多错误码请参考CommonConstants.java
//res.errorMsg //错误消息
//res.authCode //临时票据code,用来换取access_token
//res.codeVerifier //codeVerifier,用来换取access_token
//res.state //第三方程序发送时用于表示其请求的唯一性标志,由第三方程序调openApi.authorize(request)时传入,由抖音终端回传。
//res.grantedPermissions //第三方通过用户授权取得的授权域
});
4. 检查相册权限(仅iOS端支持)
//检查授权相册权限
TikTok.checkAlbumPermission(function(res){
console.log(res);
});
5. 分享图片或视频
注:不支持分享网络路径的图片和视频,需要先下载到本地,转换成原生平台的路径,ios无需再次保存相册
var path = plus.io.convertLocalFileSystemURL("uniapp路径");
//分享图片
var imagePath = plus.io.convertLocalFileSystemURL("_doc/9577.jpg");
TikTok.share({
clientKey:"awqb20yd4h43j011",//仅Android有效,iOS通过插件下面的TikTokClientKey配置
redirectUri:"https://xxx.xxx.com",//仅iOS有效,iOS端redirectUri字段、TikTok后台设置和Manifest里通用链接配置 三者保持一致
mediaType:0,//类型 0:图片 1:视频
mediaPaths:[
imagePath
],
//shareFormat:0,//默认0, 0:DEFAULT, 1:GREEN_SCREEN
state:""//用于保持请求和回调的状态,授权请求后原样带回给第三方,可传任意String
}, function(res){
console.log(res);
//res.errorCode //参照官方文档说明
//res.errorMsg
//res.state
});
//分享视频
var videoPath = plus.io.convertLocalFileSystemURL("_doc/9577.mp4");
TikTok.share({
clientKey:"awqb20yd4h43j011",//仅Android有效,iOS通过插件下面的TikTokClientKey配置
redirectUri:"https://xxx.xxx.com",//仅iOS有效,iOS端redirectUri字段、TikTok后台设置和Manifest里通用链接配置 三者保持一致
mediaType:1,//类型 0:图片 1:视频
mediaPaths:[
videoPath
],
//shareFormat:0,//默认0, 0:DEFAULT, 1:GREEN_SCREEN
state:""//用于保持请求和回调的状态,授权请求后原样带回给第三方,可传任意String
}, function(res){
console.log(res);
//res.errorCode //参照官方文档说明
//res.errorMsg
//res.state
});