群用户通过微信小程序可以更好地协作了

标签：data   gets   数组   接口   字符   取消   return   协同   back   

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

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

现在，通过最新的接口能力，开发者可以通过群ID判断用户是否来自同一个微信群，同一个群内的用户之间可以更好地使用小程序进行协作，例如共同编辑文档、协同合作、共同点餐等等。

提供更个性化的服务

通过不同的群ID，开发者可以针对各个微信群提供更个性化的服务和内容，满足不同用户的多样需求。

onShareAppMessage

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

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

自定义分享字段

回调结果：

success回调参数说明：

示例代码：

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

wx.showShareMenu(OBJECT)

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

显示当前页面的分享按钮

OBJECT参数说明：

示例代码：

wx.showShareMenu({
  withShareTicket: true
})

wx.hideShareMenu(OBJECT)

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

隐藏分享按钮

OBJECT参数说明：

示例代码：

wx.hideShareMenu()

wx.getShareInfo(OBJECT)

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

获取分享详细信息

OBJECT参数说明：

CALLBACK 参数说明：

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

获取更多分享信息

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

Bug & Tip

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

群用户通过微信小程序可以更好地协作了

标签：data   gets   数组   接口   字符   取消   return   协同   back   

原文地址：http://www.cnblogs.com/ytkah/p/6828506.html