# tap.onShareMessage(function listener)

以 Promise 风格调用:不支持

# 功能描述

监听分享行为,可以在此修正分享内容

# 参数

# function listener

分享行为监听函数

# 回调参数

# function resolve

resolve 是 onShareMessage 监听的首个回调参数,是一个接口函数。

当用户点击分享渠道时,容器会调用注册的 listener 监听,并等待 resolve 返回

游戏调用 resolve({ /* 分享参数 */ }) 后,分享行为继续进行

# string channel

channel 是 onShareMessage 监听的第二个回调参数,表示被点击的分享渠道

# resolve 的 回调参数

属性类型默认值必填说明
titlestring分享标题
descstring分享文案
successfunction分享成功的回调函数
failfunction分享失败的回调函数
completefunction分享结束的回调函数(调用成功、失败都会执行)

# successfailcomplete 回调函数

# 参数
# Object res
属性类型说明
errMsgString错误信息
errnoNumbererrno 错误码,错误码的详细说明参考 Errno错误码

# 示例代码

// 当监听到用户点击了某个分享渠道
tap.onShareAppMessage(function (resolve, channel) {
  // 分享渠道
  console.log(channel);
  // 自定义分享内容
  resolve({
    title: "分享标题",
    desc: "分享内容",
    query: "k1=v1&k2=v2",
    success(res) {
      console.log("分享成功");
    },
    fail(res) {
      console.log("分享失败", res.errMsg);
    }
  });
});