微信 JS-SDK 的接入可以拆成幾個步驟,重點在於域名設定、簽名、權限驗證以及分享介面的呼叫時機。
首先需要在微信公眾平台設定安全域名,並在頁面中引入 jweixin JS 檔。若頁面使用 HTTPS,也要使用 HTTPS 的 JS 位址,避免在部分 iOS 系統上無法正常使用。
config 需要由後端依目前頁面網址產生簽名。前端取得網址時,應移除 hash 部分,並進行編碼。
let url = location.href.split('#')[0];簽名用的 url 必須是動態取得,且需包含 http 或 https、網域、路徑與 GET 參數,但不包含 # 後方內容。
config 驗證成功後會進入 ready callback,所有需要在頁面載入時執行的 JS-SDK 介面,都應放在 ready 中。若驗證失敗,則會進入 error callback,可開啟 debug 模式或檢查回傳的 res 訊息。
常見分享介面包含 onMenuShareAppMessage 與 onMenuShareTimeline。若分享內容需要依賴 ajax 非同步取得的資料,應在資料返回後再設定分享內容,並確保分享設定仍位於 wx.ready 流程中。
實際專案可將取得簽名、config、ready 與分享設定封裝成 Promise 或通用函式,讓呼叫端只需傳入標題、描述、連結與圖片。