更新记录

1.0.0（2026-08-24）

支持 Android、iOS、HarmonyOS 平台抖音授权登录

平台兼容性

uni-app(5.15)

uni-app x(5.15)

tt-douyin-login

抖音开放平台 UTS 原生授权登录插件，支持 uni-app x 与 uni-app 的 Android、iOS、HarmonyOS App。仅提供 SDK 初始化和授权登录，不包含投稿或分享能力。

官方文档：抖音开放平台 - 移动应用 SDK

如需媒体分享、私信分享、发布或投稿能力，请使用完整功能插件：抖音授权登录、分享、发布投稿。

接入前必读

• 仅支持 App 真机、自定义基座或云打包环境，浏览器和小程序不能调用。
• 在抖音开放平台创建移动应用，确保 ClientKey、Android 包名与签名、iOS Bundle ID、HarmonyOS 应用信息和当前安装包一致。
• 调用 login() 前必须成功调用 register()。
• 登录成功返回的 code 应发送到业务服务端换取 access_token，不能在客户端保存 Client Secret。

平台配置

iOS

编辑 uni_modules/tt-douyin-login/utssdk/app-ios/Info.plist：将 DouyinAppID 和 URL Scheme 中的 your_client_key 替换为抖音开放平台 ClientKey。保留 douyinopensdk、douyinliteopensdk、snssdk1128 查询 Scheme。

Android

在抖音开放平台配置当前应用的包名和签名。插件已声明回调 Activity，并在 config.json 中配置 AwemeOpenSDK Maven 仓库；构建环境须能访问该仓库。

HarmonyOS

在 harmony-configs/.ohpmrc 配置字节仓库，并在 module.json5 中声明抖音相关 querySchemes、网络权限和 https applinks。调用登录时的 redirectUri 必须与 applinks 配置一致。

registry=https://ohpm.byted.org/repos/ohpm/,http://artifact.bytedance.com/repository/byted-ohpm/

快速开始

import * as douyinSDK from '@/uni_modules/tt-douyin-login';

const sdk = douyinSDK.getTTDouyinSDK();

sdk.register({
  appid: '你的ClientKey',
  success: () => {
    sdk.login({
      state: '业务请求标识',
      permissions: ['user_info'],
      // HarmonyOS 必填，Android / iOS 传 null。
      redirectUri: null,
      // HarmonyOS 可选，默认 EntryAbility。
      callerLocalEntry: null,
      success: (result) => {
        console.log('授权码', result.code);
        console.log('状态', result.state);
        // 将 result.code 提交到业务服务端换取 access_token。
      },
      fail: (error) => console.error('授权失败', error),
      complete: null
    } as douyinSDK.TTDouyinLoginOptions);
  },
  fail: (error) => console.error('初始化失败', error),
  complete: null
} as douyinSDK.TTDouyinRegisterOptions);

API 参考

register(options)

login(options)

错误处理

失败回调为 IUniError，常用字段为 errCode、errMsg。errCode: 101 表示 SDK 未初始化或初始化失败；其它抖音 SDK 错误会通过 cause.code 和 cause.message 保留原始信息。