普通小游戏开发
开放能力(必读)
社交转发裂变
数据分析
视频拍摄器
API
多端支持

tt.shareAppMessage

基础库版本 1.0.0 开始支持本方法

主动拉起转发界面(发布器)。

语法

tt.shareAppMessage(options);

参数说明

属性名

类型

默认值

必填

说明

最低支持版本

options

ShareParam


最终传递给发布器的数据

1.0.0

options 是一个 ShareParam 对象。

回调成功

object 类型,属性如下:

属性

类型

说明

errMsg

string

"shareAppMessage:ok"

回调失败

object 类型,属性如下:

属性

类型

说明

errMsg

string

"shareAppMessage:fail" + 错误信息

代码示例

开发者工具中预览

使用审核通过的分享素材

tt.shareAppMessage({
  templateId: "", // 替换成通过审核的分享ID
  query: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失败");
  },
});

代码指定分享内容(图片、标题、描述)

tt.shareAppMessage({
  title: "测试分享",
  desc: "测试描述",
  imageUrl: "",
  query: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失败");
  },
});

同时使用模板 templateId 和 分享内容

tt.shareAppMessage({
  templateId: "", // 替换成通过审核的分享ID
  title: "测试分享",
  desc: "测试描述",
  imageUrl: "",
  query: "",
  success() {
    console.log("分享视频成功");
  },
  fail(e) {
    console.log("分享视频失败");
  },
});

使用 channel 字段指定转发内容类型

tt.shareAppMessage({
  channel: "invite", // 拉起邀请面板分享游戏好友
  title: "测试分享",
  desc: "测试描述",
  imageUrl: "",
  query: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失败");
  },
});

视频分享

参考 视频拍摄器

口令分享

tt.shareAppMessage({
  channel: "token",
  title: "测试分享视频",
  desc: "测试描述",
  templateId: "", // 替换成通过审核的分享ID
  query: "",
  success() {
    console.log("分享成功");
  },
  fail(e) {
    console.log("分享失败");
  },
});

Bug & Tip

  • Tip: 报错返回'get shareInfo return null' 报错为获取分享信息失败,有可能获取分享信息时是网络请求超时。或者是当前 appID 的分享状态异常,比如被封禁导致,可以检查站内信或者联系小游戏运营。
点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助