在微信內打開的網頁,右上角那個「三個點」其實是可以被網頁控制的。要做到這件事,靠的是微信內嵌瀏覽器偷偷掛上去的一個私有 JavaScript 物件:WeixinJSBridge。只要呼叫它的方法,就能改寫分享內容、判斷某個帳號是否已关注、甚至直接跳出關注畫面。
把 iPhone 上的微信連到 Mac 做遠端除錯,檢視WebView 裡的 window 物件,就會看到 WeixinJSBridge。它不是標準 Web API,也不在任何公開規範裡,而是微信客戶端注入的橋樑物件——網頁透過它呼叫,由 App 原生層執行。這也是它兩個先天限制的來源:只在微信內有效,且隨時可能改變。
前提條件:以下所有程式碼都必須在微信內開啟的網頁中執行,用電腦 Chrome 開啟不會有任何反應。
function weixinShareTimeline(title, desc, link, imgUrl) {
WeixinJSBridge.invoke('shareTimeline', {
"img_url": imgUrl, // 縮圖網址
"link": link, // 點擊後前往的網址
"desc": desc, // 描述文字
"title": title // 分享標題
});
}
function weixinSendAppMessage(title, desc, link, imgUrl) {
WeixinJSBridge.invoke('sendAppMessage', {
"img_url": imgUrl,
"link": link,
"desc": desc,
"title": title
});
}
function weixinShareWeibo(title, link) {
WeixinJSBridge.invoke('shareWeibo', {
"content": title + ' ' + link,
"url": link
});
}
這個是最實用的一個:直接跳出關注畫面,並透過回呼得知結果。
function weixinAddContact(name) {
WeixinJSBridge.invoke("addContact", { webtype: "1", username: name }, function (e) {
WeixinJSBridge.log(e.err_msg);
// add_contact:added 已經添加
// add_contact:cancel 取消添加
// add_contact:ok 添加成功
if (e.err_msg == 'add_contact:added' || e.err_msg == 'add_contact:ok') {
// 關注成功,或者之前已經關注過
}
});
}
err_msg 是這類橋樑 API 通用的回傳欄位,一律是「模組:結果」的字串格式,判斷時務必用完整字串比對,不要只比對後半。
從上面的例子可以看出 WeixinJSBridge 有兩種主要用法,理解它們的差別很重要:
invoke(API名稱, 參數物件, 回呼):主動「執行」一個動作,例如分享、關注、預覽圖片。回呼會收到 err_msg。on(事件名稱, 回呼):被動「監聽」一個使用者操作,例如 menu:share:appmessage(按了發送給好友)、menu:share:timeline(按了分享到朋友圈)。回呼裡通常再呼叫 invoke 去改寫要分享的內容。這個「先 on 監聽選單點擊,再在回呼裡 invoke 覆寫內容」的組合,是改寫分享資訊的標準套路,下一篇文章會有更完整的示範。
本文記錄的是微信早期(約 2013~2015 年)的做法。隨著公眾平台開放,官方推出了正式的 微信 JS-SDK,用法變成:
wx.config({
debug: false,
appId: '', // 由後端簽發
timestamp: , nonceStr: '',
signature: '', // 由後端以 jsapi_ticket 計算
jsApiList: ['updateAppMessageShareData', 'updateTimelineShareData', 'checkJsApi']
});
wx.ready(function () {
wx.updateAppMessageShareData({ title: '...', desc: '...', link: '...', imgUrl: '...' });
wx.updateTimelineShareData({ title: '...', link: '...', imgUrl: '...' });
});
兩者的關鍵差異在於:JS-SDK 需要 appId 與由後端計算的 signature,因此分享內容無法再被任意網頁竄改;而 WeixinJSBridge 的私有方法沒有這層保護,也已陸續被微信限制或移除。新專案請直接採用 JS-SDK,並把 jsapi_ticket 與簽名計算放在伺服器端(且要記得 ticket 需自行快取,它的取得次數有配額)。
至於本文的這幾個函式,仍有參考價值:它清楚示範了「分享需要哪些欄位」以及「關注結果有哪些狀態碼」,這些概念在 JS-SDK 與企業微信、微信小程式的分享 API 裡一路沿用下來。