DIV CSS 佈局教程網

微信內建 WeixinJSBridge 實作:分享、關注與狀態判斷
編輯:JavaScript綜合知識     

在微信內打開的網頁,右上角那個「三個點」其實是可以被網頁控制的。要做到這件事,靠的是微信內嵌瀏覽器偷偷掛上去的一個私有 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 通用的回傳欄位,一律是「模組:結果」的字串格式,判斷時務必用完整字串比對,不要只比對後半。

invoke 與 on 的分工

從上面的例子可以看出 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 裡一路沿用下來。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved