更新记录

1.0.0（2026-10-30）

• 新增抖音 OpenSDK 隐私后初始化、安装与能力检测，以及授权码登录接口。
• 新增 Android、iOS 本地媒体准备、单图/多图/单视频投稿、好友/群单图和已审核链接分享接口。
• 新增请求关联、单次回调、超时结果未知、本地取消及原始 SDK 错误分类。
• 新增 uni-app Vue2/Vue3 与 uni-app x 示例，按授权登录、媒体投稿、好友分享、配置四个 Tabs 分类，公共区域保留状态、诊断和完整报告。
• 新增脱敏诊断快照、完整日志复制、固定快照分段、复制回读核对及手动回退，媒体选择包含中文取消摘要和真实大小单位。
• 新增固定版本仓储配置、基础/高级/完整接入示例、十项公开 API 测试索引及平台兼容说明；真实支持范围以根 README 和 platforms 为准。

平台兼容性

uni-app(5.33)

uni-app x(5.33)

抖音授权登录与分享

介绍

面向 uni-app、uni-app x 的国内抖音 OpenSDK UTS 插件，提供授权码登录、媒体投稿和好友/群分享。当前为开发候选源码，Android/iOS 的编译与实际业务验收范围见“注意事项”；本插件不接入海外 TikTok，也不代替业务服务端登录系统。

功能特色

适合哪些场景

下载与导入

从基础到进阶：按业务模块使用

基础功能配置示例

接入准备

下面是 uni-app x 的最小登录函数，放在页面 script setup lang="uts" 内。点击自己的登录按钮时传入输入框的 ClientKey、用户实际隐私选择和业务服务端为当前会话签发的一次性 state。初始化、登录均保留失败与完成回调。

import { initDouyin, loginDouyin, DouyinInitOptions, DouyinLoginOptions } from '@/uni_modules/lizhao-douyin-kit'

function authorize(clientKey: string, privacyAccepted: boolean, serverState: string): void {
  const initOptions: DouyinInitOptions = {
    clientKey: clientKey,
    privacyAccepted: privacyAccepted,
    success: () => {
      const loginOptions: DouyinLoginOptions = {
        scopes: ['user_info'],
        state: serverState,
        timeoutMs: 120000,
        success: (result) => {
          // 在此把 result.authCode、result.state 交自己的业务服务端；不打印授权码。
          uni.showToast({ title: '已取得授权码', icon: 'none' })
        },
        fail: (error) => { uni.showToast({ title: error.errMsg, icon: 'none' }) },
        complete: (result) => { console.log('登录 complete', result.errCode) }
      }
      loginDouyin(loginOptions)
    },
    fail: (error) => { uni.showToast({ title: error.errMsg, icon: 'none' }) },
    complete: (result) => { console.log('初始化 complete', result.errCode) }
  }
  initDouyin(initOptions)
}

privacyAccepted 不要写死 true。state 推荐由服务端生成并绑定当前会话；缺省由原生安全随机生成，但业务仍要验证关联关系。插件不预设业务服务端，不把授权码或 Client Secret 存入日志。完整 uni-app 选项式写法见下文。

高级示例

以下 TypeScript/UTS 片段适用于 uni-app x 页面方法；每段根 import 与函数均完整，调用参数来自自己的输入、服务端或系统选择器。媒体与分享函数均须在初始化成功之后、没有其他抖音交互请求时调用。

授权域、关联值与超时

import { loginDouyin, DouyinLoginOptions } from '@/uni_modules/lizhao-douyin-kit'

function authorizeWithOptions(approvedScopes: string[], serverState: string): string {
  const options: DouyinLoginOptions = {
    scopes: approvedScopes, state: serverState, timeoutMs: 180000,
    success: (result) => { uni.showToast({ title: '授权成功，请由服务端处理授权码', icon: 'none' }) },
    fail: (error) => { uni.showToast({ title: error.errMsg, icon: 'none' }) },
    complete: (result) => { console.log('授权等待结束', result.errCode) }
  }
  return loginDouyin(options)
}

图片、视频、话题与目标页

函数传入自己选择的可读文件路径，video=false 表示图片，video=true 表示一个视频；goToPublish=false 进入编辑页，true 请求进入发布页。话题数组由业务填写，最多 3 项，每项 1–80 字符；空数组表示不添加默认话题。officialShareId 由业务服务端按官方流程取得，没有时传 null。

import { publishDouyinMedia, DouyinPublishOptions, DouyinMedia } from '@/uni_modules/lizhao-douyin-kit'

function publishLocalFiles(paths: string[], video: boolean, topics: string[], goToPublish: boolean, officialShareId: string | null): string {
  const media: DouyinMedia[] = paths.map((path: string): DouyinMedia => { return { kind: 'localFile', path: path } })
  const options: DouyinPublishOptions = {
    mediaType: video ? 'video' : 'image', media: media,
    title: '我的作品', hashtags: topics, targetPage: goToPublish ? 'publish' : 'edit',
    state: officialShareId, timeoutMs: 120000,
    success: (result) => {
      uni.showToast({ title: '收到抖音SDK回执', icon: 'none' })
      // result.mediaIds 是 iOS 实际使用或新增的相册标识，插件不会自动删除相册项目。
    },
    fail: (error) => { uni.showToast({ title: error.errMsg, icon: 'none' }) },
    complete: (result) => { console.log('投稿等待结束', result.errCode) }
  }
  return publishDouyinMedia(options)
}

示例页通过 uni.chooseImage、uni.chooseVideo 获取真实本地路径，视频大小按选择器返回的 KB 展示。iOS 传普通本地文件之前必须说明会保存到系统相册，完整示例已提供确认提示。

下面的函数演示三种显式媒体来源；不自动推断类型或获取权限。传入的本地路径、Android URI、iOS 相册标识均由调用方实际取得，不存在随插件附带的演示文件。已有相册资源和 content URI 只在对应系统使用。

import { shareDouyinImageToContacts, DouyinImageShareOptions, DouyinMedia } from '@/uni_modules/lizhao-douyin-kit'

function shareChosenImage(path: string, androidUri: string, photoId: string, source: string): string {
  let media: DouyinMedia = { kind: 'localFile', path: path }
  if (source == 'androidContentUri') media = { kind: 'androidContentUri', path: androidUri }
  if (source == 'iosPhotoAsset') media = { kind: 'iosPhotoAsset', path: photoId }
  const options: DouyinImageShareOptions = {
    media: media, state: null, timeoutMs: 120000,
    success: () => { uni.showToast({ title: '收到单图分享回执', icon: 'none' }) },
    fail: (error) => { uni.showToast({ title: error.errMsg, icon: 'none' }) },
    complete: (result) => { console.log('单图分享等待结束', result.errCode) }
  }
  return shareDouyinImageToContacts(options)
}

已审核链接发好友 / 群

传入自己的已审核 HTTPS 链接、封面与真实卡片文字；插件不会代为选择收件人。state=null 使用本地安全随机关联值，需要官方追踪时改为自己的官方 ShareID。

import { shareDouyinLinkToContacts, DouyinLinkShareOptions } from '@/uni_modules/lizhao-douyin-kit'

function shareApprovedLink(url: string, coverUrl: string, title: string, description: string): string {
  const options: DouyinLinkShareOptions = {
    url: url, coverUrl: coverUrl, title: title, description: description,
    state: null, timeoutMs: 120000,
    success: () => { uni.showToast({ title: '收到链接分享回执', icon: 'none' }) },
    fail: (error) => { uni.showToast({ title: error.errMsg, icon: 'none' }) },
    complete: (result) => { console.log('链接分享等待结束', result.errCode) }
  }
  return shareDouyinLinkToContacts(options)
}

能力检测、取消与监听释放

checkCapabilities() 可在初始化前调用；beginLogObservation() 在需要监听时调用。把业务 API 实际返回的 requestId 传给 finishObservation()，可用于页面卸载时取消本地等待并释放订阅。subscriptionId 是 on 返回的字符串，off 不传回调函数。

import { getDouyinCapabilities, cancelDouyinRequest, getDouyinDiagnosticsSync, onDouyinLog, offDouyinLog, DouyinCallbacks, DouyinLogEntry } from '@/uni_modules/lizhao-douyin-kit'

let logSubscriptionId = ''
function beginLogObservation(): void {
  if (logSubscriptionId.length > 0) return
  logSubscriptionId = onDouyinLog((entry: DouyinLogEntry): void => {
    console.log(entry.time, entry.level, entry.api, entry.requestId, entry.message)
  })
}
function checkCapabilities(): string {
  const options: DouyinCallbacks = {
    success: (result) => { console.log('安装状态', result.installed, '能力限制', result.capabilityNote) },
    fail: (error) => { uni.showToast({ title: error.errMsg, icon: 'none' }) },
    complete: (result) => { console.log('检测 complete', result.errCode) }
  }
  return getDouyinCapabilities(options)
}
function finishObservation(requestId: string): void {
  if (requestId.length > 0) console.log('本地取消是否受理', cancelDouyinRequest(requestId))
  if (logSubscriptionId.length > 0) { offDouyinLog(logSubscriptionId); logSubscriptionId = '' }
  const snapshot = getDouyinDiagnosticsSync()
  console.log('脱敏快照', JSON.stringify(snapshot))
}

复制完整诊断使用示例底部的“一键复制日志”；“完整报告 / 新快照”生成固定快照，分段复制只在写入与回读相符后前进。失败保留当前段与错误，并展开报告供长按手动复制。新快照明确显示尚未复制，不沿用旧成功提示；复制不清空日志，也不输出其他剪贴板内容。

完整示例

按 Tabs 测试全部公开能力

全部十个公开 API 都通过真实插件根入口调用。无有效 ClientKey 时可检查配置校验、安装/能力、选择媒体、诊断与复制；真实授权、投稿、好友分享需要自己的已审核配置。标签只改变展示，不清表单、已选媒体、忙碌状态或固定报告。结果始终显示在公共区域；诊断不占用业务标签。

完整界面主源为 uni_modules/lizhao-douyin-kit/example/uniappx/index.uvue，普通 uni-app 为 uni_modules/lizhao-douyin-kit/example/uniapp/index.vue；共享控制器在 uni_modules/lizhao-douyin-kit/example/controller.uts，普通宿主生成辅助模块在 uni_modules/lizhao-douyin-kit/static/controller.js。两种页面保持同一真实调用、取消、监听释放与完整报告合同。

uni-app（Vue2 / Vue3）完整登录流程

下面可直接放入一个已注册的 .vue 页面。ClientKey 与服务端 state 默认空白，由自己的应用提供；它串联配置、初始化、登录、成功/失败/完成、取消和卸载释放。正式使用仍须把 success 内的授权码交自己的服务端，不以客户端成功提示代替建立业务登录会话。

<template>
  <view>
    <input v-model="clientKey" :disabled="busy" placeholder="自己的 ClientKey" />
    <input v-model="serverState" :disabled="busy" placeholder="服务端的一次性 state" />
    <button :disabled="busy" @click="privacy = !privacy">{{ privacy ? '已同意隐私政策' : '阅读并同意隐私政策' }}</button>
    <button :disabled="busy || !privacy" @click="authorize">初始化并登录</button>
    <button v-if="busy" @click="cancel">取消本地等待</button>
    <text>{{ status }}</text>
  </view>
</template>
<script>
import { initDouyin, loginDouyin, cancelDouyinRequest, onDouyinLog, offDouyinLog } from '@/uni_modules/lizhao-douyin-kit'
export default {
  data() { return { clientKey: '', serverState: '', privacy: false, busy: false, disposed: false, requestId: '', subscriptionId: '', status: '请填写配置' } },
  onLoad() {
    this.subscriptionId = onDouyinLog(entry => { console.log(entry.time, entry.api, entry.message) })
  },
  onUnload() {
    this.disposed = true
    if (this.requestId.length > 0) cancelDouyinRequest(this.requestId)
    offDouyinLog(this.subscriptionId)
  },
  methods: {
    authorize() {
      if (this.busy || !this.privacy || this.disposed) return
      this.busy = true
      this.status = '初始化中'
      this.requestId = initDouyin({
        clientKey: this.clientKey.trim(), privacyAccepted: this.privacy,
        success: () => {
          if (this.disposed) return
          this.status = '等待抖音授权'
          this.requestId = loginDouyin({
            scopes: ['user_info'], state: this.serverState.trim() || null, timeoutMs: 120000,
            success: result => {
              if (this.disposed) return
              this.status = '已取得授权码，请提交自己的服务端'
              // 在此处理 result.authCode / result.state，禁止输出到日志。
            },
            fail: error => { if (!this.disposed) this.status = error.errCode + '：' + error.errMsg },
            complete: result => {
              if (!this.disposed && this.requestId === result.requestId) { this.busy = false; this.requestId = '' }
            }
          })
        },
        fail: error => { if (!this.disposed) this.status = error.errCode + '：' + error.errMsg },
        complete: result => {
          // 初始化成功后已有新登录请求；旧 complete 不得清除新请求状态。
          if (!this.disposed && this.requestId === result.requestId) { this.busy = false; this.requestId = '' }
        }
      })
    },
    cancel() {
      if (this.requestId.length > 0 && !cancelDouyinRequest(this.requestId)) this.status = '请求可能已结束，等待完成回调'
    }
  }
}
</script>

uni-app x 的完整界面与生命周期写法请使用上表 .uvue 主源；基础、高级片段可放入其 UTS 脚本。两种完整界面都保留授权、投稿、分享、配置及底部全量诊断；这里的精简流程仅用于说明业务串联，不替代完整示例的诊断功能。

API 用途速查

通用异步参数与回调

state、timeoutMs适用于登录/投稿/好友分享，不适用于初始化和能力检测。任一业务回调抛出异常不影响随后complete；原生回执先确定终态再异步进入页面，迟到或重复回执被忽略。只允许一个涉及抖音UI的交互请求；等待期间不应切换ClientKey或重置SDK。

各方法业务参数

媒体来源

localFile在UTS胶水解析宿主本地路径后交原生，调用方对象不被回写；HTTP媒体地址不按本地文件处理。iOS标识仅在iOS使用，Android content URI仅在Android使用。

成功结果与错误字段

DouyinResult含：errSubject、errCode=0、errMsg、requestId、api、status、authCode、state、permissions、sdkVersion、installed、clientVersion、supportsPublish、supportsContacts、capabilityNote、mediaIds、shareState。status分别为 initialized、capabilities、authorized、sdkSucceeded；其他方法不适用字段为null/空数组或明确的unknown，布尔能力值应结合capabilityNote和检测API阅读。登录返回authCode/state/permissions，检测返回实际能力信息；mediaIds记录iOS实际使用/新增的相册标识。SDK版本以实际原生快照来源为准，公共层拿不到时写unknown。

DouyinFail含：errSubject、errCode、errMsg、requestId、api、stage，以及可空rawCode、shareState、nativeType、nativeCause、nativeStack。原生详情脱敏；拿不到的信息为null而不是猜测。DouyinDiagnostics含pluginId/pluginVersion/buildMark/platform/activeRequestId/logs/droppedCount/nativeSnapshot；日志条目含time/level/api/requestId/message。原生快照另外记录SDK、应用和系统来源、阶段、媒体准备/权限/资源租期等实际可采集信息。

错误码说明

所有错误的 errSubject 为 lizhao-douyin-kit。插件错误码与SDK原始码分开；原始信息保留在 rawCode/shareState，不要将某个SDK错误码当作插件固定编号。

恢复前台不代表用户取消；只有SDK明确取消或业务主动取消本地等待才使用对应语义。SDK调用同步返回true只表示接受发送，最终SDK成功也不等于发布审核或内容落地完成。需要服务器最终状态时，接入方按官方流程申请ShareID并使用Webhook/查询接口，插件不伪造发布凭证。

注意事项

平台与验收边界

package.json 按当前官方 uni_modules 规范分别声明 uni-app、uni-app x：√ 表示支持，x 表示不支持，- 表示待确认。官方字段规范。Vue 框架兼容和系统业务验收是两个维度；能显示示例或返回“不支持”不能证明已实现抖音登录/分享。

市场 displayName 按指定文案保留“支持安卓 iOS 鸿蒙”；其中鸿蒙尚无实现，请以以上兼容矩阵及实际 API 为准，不将标题当作鸿蒙可用性承诺。

Android 原生配置在 uni_modules/lizhao-douyin-kit/utssdk/app-android/config.json；iOS 配置在 uni_modules/lizhao-douyin-kit/utssdk/app-ios/config.json。SDK 回跳由插件导出的 UTSiOSHookProxy 转发，不需要业务修改 AppDelegate 或安装 swizzle。首次添加插件、修改原生源码/依赖/权限/资源需新原生联编或匹配自定义基座；只整理示例与文档通常不需要重打原生基座。当前电脑的 HX 版本不是既有安装包的构建版本，诊断按实际来源记录。

没有与包名、签名、Bundle ID 匹配的已审核 ClientKey 和能力权限时，参数失败、资源编译或本地验收 APK 均不能冒充真实授权、投稿、分享成功。iOS 完整编译/设备验收独立待办。

媒体限制

隐私、媒体与生命周期

• 按抖音官方SDK隐私说明向用户披露数据处理，在真实同意之后初始化；插件日志不默认上传。授权码、Token、Client Secret、用户账号和媒体原文不得写入日志或仓库。
• 官方SDK可能使用网络能力与自己的事件数据；“插件不上传诊断”不等于整个SDK不采集数据。上架时按实际SDK官方声明填写隐私清单。
• Android不申请任意存储或通讯录权限。只对插件暂存副本临时授予抖音读取；已发送文件为避免SDK继续读取而短期保留，按租期清理自己的目录，绝不删除用户原文件。
• iOS通过系统相册跨进程共享。已有相册标识需实际可读，本地媒体保存需用户授权；不能将写入权限误当全部相册读取权限。新增相册项目不会自动删除。
• 应用进程被杀后原页面闭包无法恢复。首版不保存授权码、不承诺冷启动恢复原回调；无法关联的回跳不会被报告成成功，需用户重新发起。
• 仅将明确无敏感信息的业务摘要写入自己的日志；复制报告前再次检查。缓存有条数/容量上限，截断和丢弃计数明确记录；详细错误和环境以实际可采集字段为准。

依赖与原生基座

Android依赖和仓库详见 uni_modules/lizhao-douyin-kit/utssdk/app-android/config.json；iOS固定DouyinOpenSDK CocoaPods依赖及资源处理见 uni_modules/lizhao-douyin-kit/utssdk/app-ios/config.json。构建环境需能访问这些仓库，仓储解析失败不是运行时业务失败。

新增或更新SDK、Kotlin/Swift、原生资源、Manifest/Info.plist、依赖或回跳配置后，必须重新原生联编或重打对应自定义基座。appResource/WGT不能更新基座内已编译原生代码。Apple编译和真实客户端界面必须用当前源码包验收；不要在旧基座中仅更新页面后宣称新SDK已生效。

官方参考：Android接入、iOS接入、iOS投稿结果。

作者系列 UTS 插件

以下条目来自项目已核实的作者发布清单。本插件候选未伪造市场链接；导入其他插件前按相应文档核对平台与原生基座要求。