本文檔主要是調研小程序關于分享方面的玩法，目的是學習小程序在項目應用以及玩法鏈上的擴展。希望大家喜歡。

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