在開發測試微信 JS-SDK 時,我遇到 wx.onMenuShareTimeline 完全不生效的狀況:自訂的圖片、標題與連結都沒有出現。逐步排查後,原因有兩個。
1. 分享圖標的圖片尺寸要大於 300px,否則微信不會顯示。
2. 必須先 wx.config 成功,再在 wx.ready 裡呼叫。我把設定直接寫進 $(function(){}) 中執行,實測是行不通的——這是最容易踩的坑。
wx.config({
debug: true, // 開啟調試模式,所有 api 回傳值會在客戶端 alert 出來
appId: '{$appid}', // 必填,公眾號唯一標識
timestamp: "{$signPackage.timestamp}", // 必填,簽名時間戳
nonceStr: '{$signPackage.nonceStr}', // 必填,簽名隨機串
signature: '{$signPackage.signature}', // 必填,簽名
jsApiList: [ // 必填,需使用的 JS 介面列表
'checkJsApi',
'onMenuShareTimeline',
'onMenuShareAppMessage',
'onMenuShareQQ',
'onMenuShareWeibo'
]
});
wx.ready(function () {
wx.onMenuShareTimeline({
title: '--{$info.name}', // 分享標題
link: '{$url}__URL__/index.jsp?pid={$pid}&puid={$uid}', // 分享連結
imgUrl: '{$url}__PUBLIC__/Uploads/{$goodsvo.image}', // 分享圖標
success: function () {
// 使用者確認分享後的回呼
alert('分享成功');
},
cancel: function () {
// 使用者取消分享後的回呼
}
});
wx.error(function (res) {
// config 驗證失敗會執行 error,例如簽名過期
// 可開啟 debug 模式或從 res 參數查看具體錯誤
// 對 SPA 而言,通常在此處重新拉取簽名即可
alert("errorMSG:" + res);
});
});
順帶一提,wx.error 建議註冊在 wx.ready 之外,這樣 config 階段就失敗的情況也能被攔下來,除錯會輕名校多。希望這段記錄能幫到同樣卡住的人。