小程序分享，看这篇就够了

官方文档

最近在调研小程序的分享能力，本篇文档主要是调研小程序关于分享方面的玩法，目的是学习小程序在项目应用以及玩法链上的扩展。

API层面

onShareAppMessage

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

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

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

return对象的返回函数：

若是定义了该事件，又不想经过页面menu转发，能够经过hideShareMenu来隐藏掉

注意事项：

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

wx.showShareMenu

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

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

wx.hideShareMenu

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

若是先设置 showShareMenu ，而且配置了 withShareTicket，再用 hideShareMenu 方法，经过按钮转发，照样能获取 shareTicket，以下：

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

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分享到小程序

传统APP要以小程序卡片的形式分享到微信，须要知足如下几个条件：

• 要求发起分享的App与小程序属于同一微信开放平台账号；

• 支持分享小程序类型消息至好友会话，不支持“分享至朋友圈” “收藏”；

• 微信客户端版本要求：6.5.6及以上微信客户端版本，若客户端版本低于6.5.6，小程序类型分享将自动转成网页类型分享。开发者必须填写网页连接字段，确保低版本客户端能正常打开网页连接；

• 支持分享大图卡片样式，自定义图片建议长宽比是 5:4。6.5.9及以上版本微信客户端小程序类型分享使用大图卡片样式。

• 支持分享开发版/体验版小程序，为支持开发者调试，开发者工具包支持分享开发版/体验版小程序至微信，开发者可控制分享的小程序版本。

具体流程图以下：

朋友圈打开小程序

在朋友圈中，发布图片附带小程序二维码，用户把图片分享到朋友圈中，看到的一方便可长恩识别在微信中打开小程序。经过这个玩法，实现了把小程序「分享」到朋友圈。

至于图片的生成，canvas和服务器端生成都是比较成熟的解决方案。

小程序支持打开APP

这个玩法有一个前提：小程序卡片必须是由APP分享出去，才能够打开APP

功能流程图以下：

该途径能够做为小程序对于app的补充：产品能够经过 App 和小程序实现场景互补。

好比用户 Sherry 将一个文档分享给用户 Kevin，Kevin 能够在小程序内直接查看。若是须要编辑，则能够直接打开 App 完成协同处理。这样一来，小程序不须要作的很重，只需知足基本功能，更多功能由 App 来补充。

case举例：用户代打车，用户A想让用户B代打车，用户A将行程分享给用户B，用户B微信打开小程序以后，跳转美团打车APP完成相关复杂操做。

小程序向公众号导流

在小程序中，能够利用一些引导性文案指引用户点击进入客服会话页面，而后客服自动回复一条公众号图文消息，而图文消息则有引导关注公众号获取更多服务的指引文案。（经典用法，可是当心被封）

小程序和微信卡劵能力结合

比较小众的玩法：用户能够从小程序中快速领取会员卡和优惠券，也能够从卡包中的会员卡直达小程序。

增长接入途径：从卡包直接进入（发卡须要注册并认证）