更新记录

1.0.0（2026-11-05）

• 新增 Android QQ 网页卡片、QQ 小程序卡片及 QQ 空间图文分享，支持 uni-app 和 uni-app x。
• 提供隐私授权、应用配置与客户端检查；按 SDK 真实回流结算分享结果。

平台兼容性

uni-app(5.34)

uni-app x(5.34)

QQ 与 QQ 空间分享

通过 QQ 官方客户端分享网页卡片、QQ 小程序卡片和 QQ 空间图文，适用于 uni-app 与 uni-app x 的 Android 应用。

• 点击 QQ 后进入 QQ 选人和确认界面，点击 QQ 空间后进入图文编辑界面。
• 标题、链接、封面和小程序路径由业务提供，发送与发表由用户在 QQ 中确认。
• 调起界面不表示已发送；只有收到 SDK 明确完成结果才触发成功回调。

适合视频、课程、商品和活动内容。将本模块导入项目，并使用包含 QQ SDK 和下述配置的 Android App；iOS、Web 和小程序端暂不提供真实分享。

import { shareToQQ } from '@/uni_modules/lizhao-qq-share'

// appId、内容URL、封面和授权状态由你的业务提供。
function shareWeb(appId: string, url: string, cover: string, privacyAuthorized: boolean) {
  shareToQQ({
    appId, privacyAuthorized,
    channel: 'qq', cardType: 'web', title: '课程详情',
    targetUrl: url, imageUrl: cover,
    success: (res) => { console.log('QQ返回分享完成', res) },
    fail: (err) => { console.log(err.errCode, err.errMsg) }
  })
}

先配置自己的移动应用

在 QQ 互联管理中心创建移动应用，登记实际 Android 包名和签名。使用该移动应用的 AppID，不填写 AppSecret。

在 utssdk/app-android/AndroidManifest.xml 填写两处，保持与调用参数一致：

<!-- YOUR_QQ_APP_ID 替换为自己的移动应用AppID；保留原有其他节点。 -->
<meta-data android:name="lizhao.qqshare.appId" android:value="YOUR_QQ_APP_ID" />
<!-- 位于 com.tencent.tauth.AuthActivity 的 intent-filter 内。 -->
<data android:scheme="tencentYOUR_QQ_APP_ID" />

配置后需重新生成并使用包含该配置的 Android App。保留模块提供的 QQShareActivity、AuthActivity、AssistActivity 和 QQ 包可见性声明。宿主已经集成 QQ 时合并同名配置，避免重复 SDK、同一时间发起多个 QQ 分享或与其他 QQ SDK 调用争用回调。

privacyAuthorized 必须来自宿主实际隐私授权结果，默认不得设为 true；仅点击分享按钮不代表已授权。宿主的隐私说明须披露 QQ 互联 SDK，具体数据处理见腾讯隐私声明。

分享 QQ 小程序卡片

需要接收方点击卡片进入 QQ 小程序时使用。移动应用和 QQ 小程序须属于同一主体，并提供真实可访问的小程序页面及封面。

import { shareToQQ } from '@/uni_modules/lizhao-qq-share'

function shareMini(appId: string, miniAppId: string, page: string, fallbackUrl: string, cover: string, authorized: boolean) {
  shareToQQ({
    appId, privacyAuthorized: authorized,
    channel: 'qq', cardType: 'miniProgram', title: '第1课：开始学习',
    targetUrl: fallbackUrl, imageUrl: cover,
    miniProgramAppId: miniAppId, miniProgramPath: page, miniProgramType: '3',
    fail: (err) => { console.log(err.errCode, err.errMsg) }
  })
}

targetUrl 是兼容旧客户端的 HTTPS 业务页，imageUrl 是公开 HTTPS 图片，不能填写视频 MP4 地址、本地截图路径或要求登录才能访问的图片。此接口不自动上传封面。小程序卡片的应用名由 QQ 的小程序身份确定；作者、粉丝数、播放量等业务展示不属于本接口可任意定制的字段，最终卡片外观由 QQ 决定。缺少小程序参数时明确失败，不自动改成网页或系统分享。

分享 QQ 空间图文

需要进入 QQ 空间编辑页，由用户补充文字并发表时使用。封面、标题与点击跳转业务页形成官方图文卡片。

import { shareToQQ } from '@/uni_modules/lizhao-qq-share'

function shareZone(appId: string, url: string, cover: string, authorized: boolean) {
  shareToQQ({
    appId, privacyAuthorized: authorized,
    channel: 'qzone', cardType: 'web', title: '课程详情', summary: '一起学习',
    targetUrl: url, imageUrl: cover,
    success: (res) => { console.log('QQ返回分享完成', res) },
    fail: (err) => { console.log(err.errCode, err.errMsg) }
  })
}

编辑器、卡片比例、封面裁剪和摘要展示由 QQ 客户端决定；summary 不保证成为用户发表的正文。参考截图来自 iOS QQ，Android 会进入相应官方流程，样式以实际客户端版本为准。

常用配置与结果

成功结果包含 platform:'android'、channel、cardType 和 completed:true。SDK 没有明确返回时继续等待，最长五分钟后失败；客户端返回、取消、进程重建均不能推导成功。应用被系统终止后不会恢复客户回调，应由业务重新操作。

本模块使用 QQ 官方 SDK，分享不要求额外登录 QQ 互联；客户端自身仍须具备可用登录态。参考QQ 分享与QQ 空间分享说明。

作者系列 UTS 插件

以下为作者已上架的 UTS 插件，详情见各市场页面或作者主页。