好記星不如爛筆頭，寫一寫記錄下。
一. 用到的API
轉發功能API參考微信官方，列下常用的
onShareAppMessage(options)
在返回值中設置轉發的title與頁面path，會回調轉發成功與失敗，js中設置了這個膠囊按鍵中才會出現“轉發”
wx.hideShareMenu(OBJECT)
隱藏膠囊按鍵里面的“轉發”按鈕
wx.showShareMenu(OBJECT)
1.顯示膠囊按鍵里的“轉發”按鈕 2.設置是否使用帶shareTicket 的轉發(轉發到微信群)
wx.getShareInfo(OBJECT)
拿shareTicket 獲取微信群的信息
二. 實現步驟
- 轉發分為頁面內button(只能是button)或右上角膠囊按鍵轉發。后者只要添加了前面提到的第一個方法就可以了。而頁面內轉發要在wxml里這么加（不需要bindtap，點擊button會觸發
onShareAppMessage(options)方法
<button class="btnShare" open-type="share"</button>
- 在頁面
onShareAppMessage(options)方法調用前添加
wx.showShareMenu({
withShareTicket: true
})
withShareTicket參數是設置轉發是否攜帶shareTicket。該參數只有在轉發至群組時可以獲取到，轉發至單聊時無法獲取到shareTicket，有啥用后面說。
- 無論點擊哪種轉發按鍵都會觸發
onShareAppMessage: function (option)，其中參數option.from可以區別是頁面定義button轉發還是膠囊按鍵轉發
onShareAppMessage: function (option) {
var shareTitle;
if (option.from === 'button') {
// 來自頁面內轉發按鈕
shareTitle = '這是來自button的轉發';
}else {
shareTitle = '這是來自膠囊按鍵的轉發';
}
return {
title: shareTitle,
path: '/parts/xxx',
success: function(res) {
res.shareTickets
},
fail: function(res) {
console.log(res)
}
}
}
在后面的return中設置好title，path，轉發成功或失敗會回調相應block
- 開發者將shareTicket傳入到
wx.getShareInfo(OBJECT)方法中可以獲取到加密數據，解密后群組信息(openGId)，然后通過gid與開放組件open-data可以讓小程序在微信群中增加不一樣的玩法。shareTicket有兩種獲取方式。
(1)用戶轉發成功后的block參數(見上面代碼)。
(2)用戶收到轉發卡片啟動小程序的onLaunch: function(options)或onShow: function(options)方法(見下面代碼)。
onLaunch: function(opt) {
//1044轉發場景值
if (opt.scene == 1044) {
wx.getShareInfo({
shareTicket: opt.shareTicket;
success: function(res){
var encryptedData = res.encryptedData;
var iv = res.iv;
}
})
}
其中success塊返回值即為加密數據。解密算法見微信官方
三. 總結
需求并沒有增加群組玩法，并沒有過多關注openGid，后面有機會可以試一試,用戶點擊卡片啟動小程序時，由于只是分享一個頁面，導航層級會發生變化，若不需要獲取shareTicket則可以做一些其他判斷。
