1.今天，小程序向开发者开放了群ID的接口能力。简单地说，就是当你把小程序分享在群聊中，被点击后开发者可获取群ID和群名称，也方便更好地针对群场景提供个性化服务。不同的群有各自的群ID，那么这个新能力开发者该怎么使用？

2.群用户间可以更好地协作大家都知道，小程序可以方便地在群聊中分享，但开发者难以识别不同用户的点击路径。

3.现在，通过最新的接口能力，开发者可以通过群ID判断用户是否来自同一个微信群，同一个群内的用户之间可以更好地使用小程序进行协作，例如共同编辑文档、协同合作、共同点餐等等。提供更个性化的服务通过不同的群ID，开发者可以针对各个微信群提供更个性化的服务和内容，满足不同用户的多样需求。

onShareAppMessage

4.在Page中定义onShareAppMessage函数，设置该页面的分享信息。

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

5.自定义分享字段

字段说明默认值最低版本title分享标题当前小程序名称path分享路径当前页面path，必须是以/开头的完整路径success分享成功的回调函数1.1.0fail分享失败的回调函数1.1.0complete分享结束的回调函数（分享成功、失败都会执行1.1.0

6.回调结果：

回调类型errMsg说明successshareAppMessage:ok分享成功failshareAppMessage:failcancel用户取消分享failshareAppMessage:fail(detailmessage)分享失败，其中detailmessage为详细失败信息

7.success回调参数说明：

参数类型说明最低版本shareTicketsArrayStringshareTicket数组，每一项是一个shareTicket，对应一个分享对象1.1.0

8.示例代码：

Page({onShareAppMessage:function(){return{title:'自定义分享标题',path:'/page/user?id=123',success:function(res){//分享成功},fail:function(res){//分享失败}}}})wx.showShareMenu(OBJECT)

9.基础库1.1.0开始支持，低版本需做兼容处理

10.显示当前页面的分享按钮

11.OBJECT参数说明：

参数类型必填说明withShareTicketBoolean否是否使用带shareTicket的分享详情successFunction否接口调用成功的回调函数failFunction否接口调用失败的回调函数completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

12.示例代码：

wx.showShareMenu({withShareTicket:true})wx.hideShareMenu(OBJECT)

13.基础库1.1.0开始支持，低版本需做兼容处理

14.隐藏分享按钮

15.OBJECT参数说明：

参数类型必填说明successFunction否接口调用成功的回调函数failFunction否接口调用失败的回调函数completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

16.示例代码：

wx.hideShareMenu()wx.getShareInfo(OBJECT)

17.基础库1.1.0开始支持，低版本需做兼容处理

18.获取分享详细信息

19.OBJECT参数说明：

参数类型必填说明shareTicketString是shareTicketsuccessFunction否接口调用成功的回调函数failFunction否接口调用失败的回调函数completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

20.CALLBACK参数说明：

参数类型说明errMsgString错误信息roomTopicString群名称rawDataString不包括敏感信息的原始数据字符串，用于计算签名。signatureString使用sha1(rawData+sessionkey)得到字符串，用于校验分享信息，参考文档signature。encryptedDataString包括敏感数据在内的完整分享信息的加密数据，详细见加密数据解密算法ivString加密算法的初始向量，详细见加密数据解密算法

21.encryptedData解密后为一个JSON结构，包含字段如下：

字段说明openGId群对当前小程序的唯一IDroomTopic群名称获取更多分享信息

22.通常开发者希望分享出去的小程序被二次打开的时候能够获取到一些信息，例如群聊名字或者是群的标识。现在通过调用wx.showShareMenu并且设置withShareTicket为true，当用户将小程序分享到任一群聊之后，可以获取到此次分享的shareTicket，此分享卡片在群聊中被其他用户打开时，可以在App.onLaunch()获取到另一个shareTicket。这两步获取到的shareTicket均可通过wx.getShareInfo()接口可以获取到相同的分享信息。

Bug&Tiptip:分享图片不能自定义；会取当前页面，从顶部开始，高度为80%屏幕宽度的图像作为分享图片。tip:分享的调试支持请查看普通分享的调试支持和带shareTicket的分享tip:只有分享到群聊中打开才可以获取到shareTickets返回值，单聊没有shareTicketstip:shareTicket仅在当前小程序生命周期内有效