阅读(4819) (6)

tt.onShareAppMessage

2020-02-13 16:55:38 更新

tt.onShareAppMessage(function callback)

监听用户点击右上角菜单的“转发”按钮时触发的事件


输入

callback function

监听事件的回调函数, 该函数接收一个对象参数, 同时该回调需返回一个对象,定义本次分享的行为。


回调函数接收的参数

属性类型是否必填说明
channelstring转发内容类型

channel

说明
article发布图文内容
video发布视频内容
token口令分享,生成一串特定的字符串文本,仅头条 APP 支持


返回对象

属性类型是否必填说明
titlestring转发标题,不传则默认使用当前小游戏的名称。
imageUrlstring转发显示图片的链接,可以是网络图片路径或本地图片文件路径或相对代码包根目录的图片文件路径,显示图片长宽比推荐 5:4
querystring查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 tt.getLaunchOptionSync() 或 tt.onShow() 获取启动参数中的 query。
extraobject附加信息

extra

属性类型默认值说明
videoPathstring视频地址
videoTopicsArray<string>视频话题(只在抖音可用)
createChallengebooleanfalse是否分享为挑战视频(头条支持)


代码示例

tt.onShareAppMessage(function(res) {
  console.log(res.channel);
  // do something
  return {
    title: "分享标题",
    imageUrl: "https://example.com/test.png",
    query: "k1=v1&k2=v2",
    success() {
      console.log("分享成功");
    },
    fail(e) {
      console.log("分享失败", e);
    }
  };
});