更新记录

1.0.8（2025-05-20）

增加授权登录codeVerifier字段返回。

1.0.7（2025-05-19）

增加图片和视频分享接口。

1.0.6（2025-05-09）

优化iOS端回调处理。

平台兼容性

uni-app

uni-app x

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
});