更新记录

1.2.0（2026-04-15）

支持 抖音分享、发布投稿等功能

1.1.1（2026-02-22）

修复 iOS审核问题

1.1.0（2026-02-22）

修复iOS审核问题

平台兼容性

uni-app(4.36)

uni-app x(4.36)

tt-douyin-open

抖音开放平台 UTS 原生插件，支持 uni-app x 与 uni-app。提供 初始化（register）、授权登录（login）、分享（share）。

share 能力：支持 向抖音投稿发布（scene: 'publish' + contentType: 'media'，含 feed 投稿、转发日常 等，配合 publishMode、publishTargetPage、useNewForwardAbility 及鸿蒙 harmonyLandingPage 等，见 utssdk/interface.uts）；Android / iOS 另支持 私信分享（scene: 'im'）。业务通过 getTTDouyinSDK() 取单例。

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

📖 目录

• SDK 版本信息
• 重要提示
• 环境配置
• 快速开始
• 功能介绍
  • 抖音授权登录
  • 抖音分享
• 错误处理
• 常见问题

SDK 版本信息

🚨 重要提示

⚠️ 必须使用自定义基座（或正式包），否则无法调用原生插件方法。
⚠️ 先 register 再 login / share。
⚠️ 鸿蒙：login、share 需配置 redirectUri，且与 harmony-configs/entry/src/main/module.json5 里 skills / uris 一致。
⚠️ Android：分享/授权回调依赖抖音文档中的 包名、签名、Entry Activity 等配置，请在开放平台与工程中按官方说明对齐。

环境配置

前置条件

1. 在 抖音开放平台 创建移动应用，获取 ClientKey（代码里 register 的 appid 传此值）。
2. 按平台在开放平台配置 包名、签名（Android）、Bundle ID（iOS）、鸿蒙应用信息等。

iOS

1. 编辑 uni_modules/tt-douyin-open/utssdk/app-ios/Info.plist：DouyinAppID、URL Types 的 CFBundleURLSchemes 填写 ClientKey；LSApplicationQueriesSchemes 含 douyinopensdk、snssdk1128 等（以插件内模板为准）。
2. 在应用 生命周期 中接入插件 Hook（TTDouyinSDKHookProxy），保证抖音 SDK 能收到 冷启动与 URL 回调（与 uni 工程 manifest 配置一致即可）。

Android

在开放平台配置 签名与包名；工程需能拉取插件 config.json 中的 AwemeOpenSDK Maven 仓库。其余按 抖音 Android 集成文档 配置 FileProvider、回调 Activity 等。

HarmonyOS

1. ohpm：项目根 harmony-configs/.ohpmrc 需能访问字节仓库，例如：

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

2. harmony-configs/entry/src/main/module.json5：querySchemes 包含抖音相关 scheme；skills / uris（https applinks） 与代码里 redirectUri 一致；声明 网络权限。完整模板请以 抖音鸿蒙 / OpenHarmony 官方说明 为准。

快速开始

1. 导入插件

uni-app x

import * as douyinSDK from "@/uni_modules/tt-douyin-open";

export default {
  data() {
    return {
      douyin: null as douyinSDK.TTDouyinSDK | null,
    };
  },
  onLoad() {
    this.douyin = douyinSDK.getTTDouyinSDK();
    this.initDouyinSDK();
  },
  methods: {
    initDouyinSDK() {
      /* 见下方「2. 初始化 SDK」 */
    },
  },
};

uni-app

import * as douyinSDK from "@/uni_modules/tt-douyin-open";

export default {
  data() {
    return { douyin: null };
  },
  onLoad() {
    this.douyin = douyinSDK.getTTDouyinSDK();
    this.initDouyinSDK();
  },
  methods: {
    initDouyinSDK() {
      /* 见下方「2. 初始化 SDK」 */
    },
  },
};

2. 初始化 SDK

uni-app x

initDouyinSDK() {
  if (this.douyin == null) return;
  this.douyin.register({
    appid: "你的ClientKey",
    success: () => {
      console.log("抖音初始化成功");
    },
    fail: (err) => {
      console.error("抖音初始化失败", err);
    },
  } as douyinSDK.TTDouyinRegisterOptions);
}

uni-app

initDouyinSDK() {
  if (!this.douyin) return;
  this.douyin.register({
    appid: "你的ClientKey",
    success: () => {
      console.log("抖音初始化成功");
    },
    fail: (err) => {
      console.error("抖音初始化失败", err);
    },
  });
}

功能介绍

抖音授权登录

流程：客户端拿到 code → 服务端用 code 换 access_token → 再取用户信息（见 开放平台服务端文档）。

参数说明（TTDouyinLoginOptions）

uni-app x 示例

this.douyin!.login({
  state: String(Date.now()),
  permissions: ["user_info"],
  redirectUri: "https://你的域名/你的path",
  callerLocalEntry: "EntryAbility",
  success: (res) => {
    console.log(res.code, res.state);
  },
  fail: (err) => {
    console.error(err);
  },
} as douyinSDK.TTDouyinLoginOptions);

uni-app 示例

this.douyin.login({
  state: String(Date.now()),
  permissions: ["user_info"],
  redirectUri: "https://你的域名/你的path",
  callerLocalEntry: "EntryAbility",
  success: (res) => {
    uni.request({
      url: "https://你的服务端/api/douyin/login",
      method: "POST",
      data: { code: res.code, state: res.state },
    });
  },
  fail: (err) => {
    uni.showToast({ title: "授权失败", icon: "none" });
  },
});

抖音分享

统一调用：this.douyin.share(options)，options 类型为 TTDouyinShareOptions。

能力概览：

• 投稿发布：三端均支持通过 scene: 'publish' + contentType: 'media' 走抖音 投稿 / 发布 流程（标题、音乐、贴纸、publishMode（feed / forwardDaily）、publishTargetPage（edit / publish）、鸿蒙 harmonyLandingPage（edit / record）等以 interface.uts 为准）。
• 私信分享：Android / iOS 支持 scene: 'im'（media / link / microApp）；鸿蒙 当前不支持 im。

字段较多（scene、contentType、mediaContent、linkContent、publishMode、harmonyLandingPage、redirectUri、state 等），请以 utssdk/interface.uts 中注释为准。

平台行为简述：

投稿发布示例：鸿蒙（uni-app x）

this.douyin!.share({
  scene: "publish",
  contentType: "media",
  state: "业务或开放平台 ShareID",
  redirectUri: "https://你的域名/applink路径",
  callerLocalEntry: "EntryAbility",
  harmonyLandingPage: "edit",
  mediaContent: {
    filePaths: ["/本地绝对路径/demo.jpg"],
    mediaType: "image",
  },
  success: () => {},
  fail: (e) => {
    console.error(e);
  },
} as douyinSDK.TTDouyinShareOptions);

投稿发布示例：鸿蒙（uni-app）

this.douyin.share({
  scene: "publish",
  contentType: "media",
  state: "业务或开放平台 ShareID",
  redirectUri: "https://你的域名/applink路径",
  callerLocalEntry: "EntryAbility",
  harmonyLandingPage: "edit",
  mediaContent: {
    filePaths: ["/本地绝对路径/demo.jpg"],
    mediaType: "image",
  },
  success: () => {
    uni.showToast({ title: "已发起分享", icon: "none" });
  },
  fail: (e) => {
    uni.showToast({ title: (e && e.errMsg) || "分享失败", icon: "none" });
  },
});

mediaType 为 mix 时：filePaths 需多个路径，具体条数与能力以抖音客户端与开放平台为准。

错误处理

常见 errCode（详见 utssdk/unierror.uts 中 TTDouyinSDKErrors）：

常见问题

1. 找不到插件方法
   使用 自定义基座 或正式包，不要用未包含本插件的标准基座。

2. iOS 登录无响应
   检查 ClientKey、URL Scheme。

3. Android 授权或分享无回调
   核对开放平台 签名、包名 及文档要求的 回调 Activity 配置。

4. 鸿蒙 ohpm 安装失败（ECONNRESET 等）
   多为本机访问 ohpm.byted.org 网络问题，需换网络、代理或放行域名；日志里 CaseSensitive 相关 DEBUG 可忽略。

5. 鸿蒙提示 redirectUri
   与 module.json5 中 applinks（uris） 及开放平台配置保持一致。

更多排障请对照 抖音开放平台文档。

祝您开发愉快！ 🎉