今天，小程序向開發者開放了群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 僅在當前小程序生命周期內有效

群用戶通過微信小程序可以更好地協作了