本文档主要是调研小程序关于分享方面的玩法，目的是学习小程序在项目应用以及玩法链上的扩展。希望大家喜欢。

API层面

onShareAppMessage

小程序如果想对外分享，必须在page里面定义onShareAppMessage函数，来配置页面分享转发相关的信息。

• 只有定义了此事件处理函数，右上角菜单才会显示 “转发” 按钮
• 用户点击转发按钮的时候会调用
• 此事件需要 return 一个 Object，用于自定义转发内容

一个页面可能会有多个分享，可以由插入的参数options来判断具体是由哪个位置进行分享，从而做不同的逻辑判断。

return对象的返回函数：

如果定义了该事件，又不想通过页面menu转发，可以通过ShopfadeShareMenu来隐藏掉

注意事项：

• 转发后不添加imageUrl的话，将截图作为转发的默认图片。
• from 字段可以通过在转发成功后调取的 success、complete 来进行对 menu 和 button 的不同操作
• 如果有携带 shareTicket 值，会在 success 回调产生，返回结果在 shareTickets 字段中，是一个数组，可以做一定处理

wx.showShareMenu

一般是用来配置相关的参数，常见的如withShareTicket，用它来获取群信息，群的相关标示。

wx.showShareMenu({
  withShareTicket: true
})
复制代码

wx.ShopfadeShareMenu

隐藏menu级别的转发功能，但是button中还存在着转发。

如果先设置 showShareMenu ，并且配置了 withShareTicket，再用 ShopfadeShareMenu 方法，通过按钮转发，照样能获取 shareTicket，如下：

wx.showShareMenu({
  withShareTicket: true
})
wx.ShopfadeShareMenu({
})
复制代码

wx.updateShareMenu

更新shareMenu信息需要用update操作哦，这里需要注意下，一般都是会更新withShareTicket属性。

wx.getShareInfo

在拿到了shareTicket信息后，可以由此API获取转发详细信息

wx.getShareInfo({
    shareTicket: res.shareTickets[0],
    success: ...
    fail: ...
})
复制代码

相关回调的参数

{
    errMsg: "getShareInfo:ok", 
    iv: "gRHeFU+Nhr36RmladCXnRQ==", 
    encryptedData: "IQ/RwZLeQFUGuxv0bBfOrL/KLnXO+bxcyCBru5lB92FkHIg8ae…7TnHwU+rqgerFKvpvS5JbFyh+9liUqyb2bk6/LETYQ+h/FQ=="
}
复制代码

由iv和encryptedData进行解密，可以拿到openGId的值。为当前群对当前小程序的唯一值。额外还可以拿到群名称等更多的开放数据。

button转发

页面内需要转发时，需要给button组件设置open-type="share"，并在触发的地方判断来源。

获取分享链接流程

在小程序中，获取openGId主要有两种途径，也一般围绕着两种途径做分享相关的开发：

• 当用户打开withShareTicket的卡片时，可以在onLauch或者getShareInfo中获取加密信息，并且传给服务端获得openGId。
• 当用户分享成功后，会在回调里收到一个shareTicket，然后通过getShareInfo来获得加密信息，获得openGId。

拓展玩法

APP分享到小程序