更新记录

1.0.0（2026-09-29）

支持 安卓/iOS TikTok OpenSDK

平台兼容性

uni-app(5.0)

uni-app x(5.0)

tt-tiktok-sdk

TikTok OpenSDK UTS 插件，为 uni-app / uni-app x 提供 TikTok 登录、安装检测及图片/视频分享能力。

目录

• SDK 版本
• 重要提示
• 环境配置
• 快速开始
• 功能介绍
• API
• 错误码
• 常见问题

SDK 版本

重要提示

• 必须使用 App 真机和自定义基座或云打包运行。
• 需要先在 TikTok for Developers 添加 Login Kit；使用分享功能时还需添加 Share Kit。
• redirectUri 必须与 TikTok 开放平台配置完全一致。
• 登录返回的 code 和 codeVerifier 应发送到服务端换取 token，Client Secret 不要写入 App。
• 修改原生配置后需要重新制作自定义基座或重新云打包。

环境配置

前置条件

1. 在 TikTok for Developers 创建应用并获取 Client Key。
2. 配置 Android 包名、签名和 iOS Bundle ID。
3. 添加 Login Kit / Share Kit，并申请业务需要的 scopes。
4. 配置 HTTPS Redirect URI。

iOS 配置

编辑插件内的 uni_modules/tt-tiktok-sdk/utssdk/app-ios/Info.plist，将两处 your_client_key 替换为实际 Client Key：

<key>TikTokClientKey</key>
<string>你的 Client Key</string>

<key>CFBundleURLSchemes</key>
<array>
    <string>你的 Client Key</string>
</array>

同时在应用签名能力中配置与 Redirect URI 域名对应的 Associated Domains：

applinks:example.com

iOS 的 Redirect URI 必须是已正确配置的 Universal Link。

Android 配置

插件已经配置 OpenSDK 依赖、网络权限、TikTok 包可见性和回调 Activity。

如果使用自己的 Redirect URI，请修改插件内的 uni_modules/tt-tiktok-sdk/utssdk/app-android/AndroidManifest.xml：

<data
    android:scheme="https"
    android:host="example.com"
    android:pathPrefix="/tiktok/callback" />

同时确保该域名的 App Link / Digital Asset Links 已正确配置。

快速开始

获取并初始化 SDK

import * as tiktok from '@/uni_modules/tt-tiktok-sdk'

const sdk = tiktok.getTTTikTokSDK()

sdk.register({
  clientKey: '你的 Client Key',
  success: () => {
    console.log('TikTok SDK 初始化成功')
  },
  fail: (error) => {
    console.error('初始化失败', error)
  }
})

功能介绍

检测 TikTok 是否安装

const installed = sdk.isTikTokInstalled()
console.log('TikTok 是否安装：', installed)

TikTok 登录

sdk.login({
  redirectUri: 'https://example.com/tiktok/callback',
  scopes: ['user.info.basic'],
  state: Date.now().toString(),
  authMethod: 'tiktokApp',
  success: (result) => {
    console.log('授权 code：', result.code)
    console.log('PKCE codeVerifier：', result.codeVerifier)
    console.log('已授权权限：', result.grantedPermissions)
  },
  fail: (error) => {
    console.error('登录失败', error)
  }
})

authMethod 支持：

• tiktokApp：优先使用 TikTok App 授权。
• chromeTab：Android 使用浏览器授权，iOS 使用 Web Auth。

分享图片或视频

Android 使用本地绝对路径或 content:// URI：

sdk.share({
  mediaType: 'video',
  mediaPaths: ['/storage/emulated/0/Movies/demo.mp4'],
  redirectUri: 'https://example.com/tiktok/callback',
  success: (result) => {
    console.log('分享成功', result.state)
  },
  fail: (error) => {
    console.error('分享失败', error)
  }
})

iOS 使用系统相册资源的 PHAsset.localIdentifier：

sdk.share({
  mediaType: 'image',
  mediaPaths: ['PHAsset.localIdentifier'],
  redirectUri: 'https://example.com/tiktok/callback',
  format: 'normal',
  success: (result) => {
    console.log('分享成功', result.state)
  },
  fail: (error) => {
    console.error('分享失败', error)
  }
})

format 支持：

• normal：普通分享，默认值。
• greenScreen：绿幕分享，只能传入一个媒体。

API

getTTTikTokSDK()

获取 SDK 单例。

register(options)

isTikTokInstalled()

同步返回 TikTok 是否安装，返回类型为 boolean。

login(options)

成功结果包含：

share(options)

错误码

TikTok 原生 SDK 的错误码也可能直接通过 errCode 返回。

常见问题

登录后无法返回 App

• 确认 Redirect URI 与 TikTok 后台配置完全一致。
• Android 检查 App Link 和 AndroidManifest.xml。
• iOS 检查 Universal Link、Associated Domains 和 Client Key。

iOS 分享失败

iOS 只能传入照片库资源的 PHAsset.localIdentifier，不能传普通文件路径。

修改配置后没有生效

删除旧构建缓存，并重新制作自定义基座或重新云打包。

官方文档

• TikTok Login Kit
• TikTok Access Token
• Android OpenSDK
• iOS OpenSDK