微信公眾號開發裡,「自訂分享內容」幾乎是必做的項目。預設的分享標題是頁面 title、沒有描述、縮圖也未必理想,透過 JS-SDK 就能完全掌控。以下記錄三個分享入口的設定方式。
呼叫任何分享介面前,必須先完成 wx.config,並在 wx.ready 之後註冊。這裡使用 wechat-sdk 這個 Node 套件,後端負責計算簽名並回傳給前端。
// 微信分享
var wx = require('wechat-sdk');
rewardsResultService.getWechatInfo().then(function(data) {
var conf = data;
wx.config({
debug: false,
appId: 'wx34e783920b37ee91',
timestamp: conf.timestamp,
nonceStr: conf.noncestr,
signature: conf.signature,
jsApiList: [
'onMenuShareAppMessage', //分享給朋友
'onMenuShareTimeline', //分享到朋友圈
'onMenuShareQQ' //分享到 QQ
]
});
configWeChatInterface();
});
var iconUrl = 'https://' + location.host + '/images/icon-200yuan.png';
function configWeChatInterface() {
//分享給朋友
wx.onMenuShareAppMessage({
title: '一言不合就發紅包,金蛛送您200元紅包!',
desc: '一言不合就發紅包,金蛛送您200元紅包!',
link: location.href,
imgUrl: iconUrl,
type: 'link',
success: function() {
// alert('share success');
},
cancel: function() {
}
});
//分享到朋友圈
wx.onMenuShareTimeline({
title: '一言不合就發紅包,金蛛送您200元紅包!',
link: location.href, //分享鏈接
imgUrl: iconUrl
});
//分享到 QQ
wx.onMenuShareQQ({
title: '一言不合就發紅包,金蛛送您200元紅包!', //分享標題
desc: '一言不合就發紅包,金蛛送您200元紅包!', //分享描述
link: location.href, //分享鏈接
imgUrl: iconUrl, //分享圖標
success: function () {
//使用者確認分享後的回呼
},
cancel: function () {
//使用者取消分享後的回呼
}
});
}
title、desc、link、imgUrl、type 五個欄位,資訊最完整。title、link、imgUrl,沒有 desc。這是因為朋友圈的貼文格式本身就是標題加連結。type 的彈性。範例中用 location.host 拼出完整網址,這個習慣是對的。微信對縮圖 URL 有相對嚴格的要求,用相對路徑容易抓不到圖。
微信對分享縮圖會做快取,換了圖卻沒生效是常見問題。除了確認 URL 有加上版本參數(例如 ?v=2)來破快取,也要確保圖片本身就是可公開存取的。
範例直接用 location.href,實務上通常會替換成「帶分享者識別碼的推廣連結」,這樣才能追蹤是誰帶來的流量。若要這麼做,記得 link 的網域必須在公眾號的 JS 安全網域清單中。
這是最容易出錯的一環。後端計算簽名時用的 URL,必須與前端實際載入的網址完全相同。若頁面有 hash 路由,微信的規則是取 # 之前的部分。
這裡使用的 onMenuShareAppMessage、onMenuShareTimeline、onMenuShareQQ 屬於較早期的寫法(在物件中直接設定分享內容)。微信後續推出了 updateAppMessageShareData 與 updateTimelineShareData 作為替代。
兩者的差別在於:舊版是「設定即生效」,新版則需要監聽 menuShareAppMessage 等事件、在使用者實際點擊分享時才讀取設定。新版的做法更即時——使用者停留頁面的期間,你可以動態更新分享內容(例如倒數計時結束後換一段文案)。
若你的專案是新開發的,建議直接採用新版 API;維護老程式時則不必急著改,舊版目前仍能運作,但要留意未來可能的相容性風險。