tt.onShareAppMessage

tt.onShareAppMessage(function callback)

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

输入

callback function

监听事件的回调函数

输出

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

channel

说明
article发布图文内容
video发布视频内容

extra

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

代码示例

  1. tt.onShareAppMessage(function (){
  2. // do something
  3. return {
  4. title: '分享标题',
  5. imageUrl: 'https://example.com/test.png',
  6. query: 'k1=v1&ke=v2'
  7. }
  8. });

已知问题

目前支持分享到微头条时,可以支持业务回调,其他渠道的分享暂不支持回调。