更新记录

1.0.0（2026-08-04）

1.0.0

• 首版：对齐原生 TikTokManager.loginTikTok
• iOS：TikTokOpenAuthSDK 2.5.0 授权 + 换 token
• Android：内置 OpenSDK Auth/Core 2.4.0，同名 API；回跳防重入

平台兼容性

其他

tiktok-login

UTS 插件：TikTok（国际版 Open Platform）授权登录，对齐原生 TikTokManager.loginTikTok。

安装

市场安装，或解压后拷到工程：

你的项目/uni_modules/tiktok-login

需制作自定义基座 / 云打包。

调用（双端统一）

import { loginTikTok, isAvailable } from '@/uni_modules/tiktok-login'

loginTikTok({
  clientKey: '你的 Client Key',      // Android 必填；iOS 若 Info.plist 已配 TikTokClientKey 可省略逻辑上仍建议传
  redirectURI: 'https://your.domain/path',
  clientSecret: '你的 Client Secret', // 建议仅测试；生产宜服务端换 token
  scopes: 'user.info.basic'
}, (res) => {
  if (res.status !== 'success') {
    console.log(res.message)
    return
  }
  console.log(res.open_id, res.access_token)
})

iOS 必配

1. Info.plist：TikTokClientKey、URL Scheme（= Client Key）、QueriesSchemes（tiktok 等）
2. Associated Domains：与 redirectURI 域名一致（宿主自配，插件不写 entitlements）
3. HBuilderX ≥ 3.8.5（CocoaPods：TikTokOpenSDKCore / TikTokOpenAuthSDK 2.5.0）

Android 必配

1. TikTok 开放平台登记 Android 包名、签名证书、Login Kit Redirect URI（https App Link）
2. 宿主工程为 主 Activity 配置与 redirectURI 一致的 intent-filter（见插件内 AndroidManifest.xml 注释示例）
3. clientKey / redirectURI / clientSecret 调用时传入
4. 插件已内置 tiktok-open-sdk-core/auth 2.4.0 aar（无需额外 maven）

回跳：Application Hook 会在 Activity resume 时自动解析；也可主动调用 handleAuthCallback()。

回调字段

注意

• clientSecret 放客户端有泄露风险。
• Android 需真机 + 正确 App Link / 签名配置，否则授权无法回跳。