内容转发

小程序/小游戏支持转发链接、图文、游戏视频和分享口令等不同形式的内容。

获取分享素材 ID

开发者可以提前通过开发者后台配置分享图片、标题、文案，并由平台进行审核。审核通过的素材会生成对应的 templateId，给到开发者调用。

⚠️ 审核通过的分享内容，在线上的转发行为依然会受平台监管，请开发者遵守运营规范相关要求。

获取路径：开发者平台 -> 选择对应小程序 -> 设置 -> 分享设置 -> 添加新分享 -> 获取分享 ID

分享内容定义

各宿主建议长度

分享内容指定方式

平台支持不同形式来指定转发的内容（图片、标题、文案），最终按照优先级规则进行选择

1. 代码指定分享内容（title、desc、imageUrl）
2. 代码指定审核通过的模板素材 templateId

分享内容优先级

使用场景介绍

今日头条

入口	场景	图示
端内-【转发到头条】	点击【转发到头条】后，触发微头条发布器，生成小游戏链接
端外-【分享其它平台】	选择平台后，跳转选择对话框，发送气泡式链接
端内-【发头条图文】	选择发图文后，跳转图文发布器
端外-【口令分享】	开发者在游戏内调用口令分享功能，点击对应按钮后即生成口令
端内-【录屏分享】	玩家在游戏中录屏后，跳转至小视频发布器

抖音

入口	场景	图示
端内-【私信好友】	选择端内联系人，发送小游戏链接	呈现页（中间页）
端外-【图片二维码】➡️ 使用图片口令	选择端外平台，生成分享图片，选择“保存并分享”后跳转	分享页    回流页
端内-视频详情页-小游戏组件	玩家发送的游戏录屏或相关视频详情页中	呈现页（视频详情）   )
端内-视频详情页-小游戏大卡	玩家发送的游戏录屏或相关视频详情页中	呈现页（弹出大卡）
端内-评论区	显示在视频详情页的评论区顶部	呈现页（评论区）

游戏内接入转发能力

通过 tt.shareAppMessage 转发图文、视频和口令等不同形式的内容，具体用法参考 API 文档

使用审核通过的分享素材，指定 templateID

代码示例

// 以默认链接分享方式为例
tt.shareAppMessage({
  templateId: "1fidnqkeari9dnd18o", // 替换成通过审核的分享ID
  query: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失败");
  }
});

代码指定分享内容

代码示例注：代码指定分享内容也可以同时指定素材 templateID， 平台会按照优先级规则选定分享内容

// 以默认链接分享方式为例
tt.shareAppMessage({
  templateId: "1fidnqkeari9dnd18o", // 替换成通过审核的分享ID
  query: "",
  title: "画家活下去",
  desc: "在这里爱上画画",
  imageUrl: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失败");
  }
});

链接分享

// 以默认链接分享形式为例
tt.shareAppMessage({
  templateId: "1fidnqkeari9dnd18o", // 替换成通过审核的分享ID
  query: "",
  title: "画家活下去",
  desc: "在这里爱上画画",
  imageUrl: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失败");
  }
});

图文分享

⚠️ 抖音不支持图文分享

// 以图文分享为例
tt.shareAppMessage({
  channel: "article",
  templateId: "1fidnqkeari9dnd18o", // 替换成通过审核的分享ID
  query: "",
  title: "画家活下去",
  desc: "在这里爱上画画",
  imageUrl: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失败");
  }
});

游戏录屏分享

代码示例

// 视频分享
tt.shareAppMessage({
  channel: "video",
  query: "",
  templateId: "1fidnqkeari9dnd18o", // 替换成通过审核的分享ID
  title: "画家活下去",
  desc: "在这里爱上画画",
  extra: {
    videoPath: "ttfile://temp/test.mp4", // 可用录屏得到的本地文件路径
    videoTopics: ["画家活下去"]
  },
  success() {
    console.log("分享视频成功");
  },
  fail(e) {
    console.log("分享视频失败");
  }
});

口令分享

代码示例

tt.shareAppMessage({
  channel: "token", // 口令分享
  templateId: "1fidnqkeari9dnd18o", // 替换成通过审核的分享ID
  title: "画家活下去",
  desc: "在这里爱上画画",
  query: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失败");
  }
});