DIV CSS 佈局教程網

WeixinJSBridge 深入:綁定分享選單、隱藏工具列與初始化時機
編輯:JavaScript綜合知識     

微信內網頁右上角那三個小點,展開後就是一個選單:發送給好友、分享到朋友圈、分享到騰訊微博等等。上一篇文章講了怎麼「執行」分享,這篇要講更關鍵的一半——怎麼「攔下」使用者點選單的動作,並在它真正送出前把內容換成我們要的樣子。

前提:WeixinJSBridge 只在微信內開啟的網頁中有效,用電腦瀏覽器開啟什麼都不會發生。

第一步:綁定選單點擊事件

function sendMessage() {
  WeixinJSBridge.on('menu:share:appmessage', function (argv) {
    alert("發送給好友");
  });
}

只要呼叫一次 sendMessage(),使用者之後點「發送給好友」時就會先經過這段回呼。事件名稱的命名規則很直白:menu:share: 加上對應的功能代號,appmessage 是好友、timeline 是朋友圈、weibo 是微博。

第二步:在回呼裡改寫分享內容

光是 alert 沒有意義,真正的用法是在回呼裡呼叫 invoke:

WeixinJSBridge.invoke('sendAppMessage', {
  "appid":      "",        // 留空即可
  "img_url":    imgUrl,    // 分享縮圖
  "img_width":  "120",
  "img_height": "120",
  "link":       url,       // 點擊後的目標網址
  "desc":       "我是一個介紹",
  "title":      "標題,再簡單不過了。"
}, function (res) {
  /* 回呼建議留空,避免多餘彈窗 */
});

一個很實用的坑:不要單獨呼叫 invoke

把上面那段 invoke 從 on 裡拿出來、在頁面載入時直接呼叫,邏輯上說得通,實測卻完全沒反應。必須先讓使用者手動點一次右上角的「發送給好友」、等通訊錄彈出後再返回,之後直接呼叫才會生效——看起來像是微信內部要先做某種初始化。因此正確做法就是把它嵌進 on 的綁定裡,讓使用者的每一次點擊都觸發一次完整流程:

function sendMessage() {
  WeixinJSBridge.on('menu:share:appmessage', function (argv) {
    WeixinJSBridge.invoke('sendAppMessage', {
      "appid":      "",
      "img_url":    imgUrl,
      "img_width":  "120",
      "img_height": "120",
      "link":       url,
      "desc":       "我是一個介紹",
      "title":      "標題,再簡單不過了。"
    }, function (res) { /* 回呼留空 */ });
  });
}

這樣一來,使用者點「發送給好友」,就會直接跳到通訊錄挑選單一好友,不必再經歷一次預設流程。

分享到朋友圈:只差一個事件名

function sendMessage() {
  // ……此處接上面的 sendAppMessage 綁定……

  WeixinJSBridge.on('menu:share:timeline', function (argv) {
    WeixinJSBridge.invoke('shareTimeline', {
      "appid":      "",
      "img_url":    imgUrl,
      "img_width":  "120",
      "img_height": "120",
      "link":       url,
      "desc":       "我是一個介紹",
      "title":      "標題,再簡單不過了。"
    }, function (res) { /* 回呼留空 */ });
  });
}

仔細比對就會發現:只有 on 的事件名(menu:share:timeline)和 invoke 的 API 名(shareTimeline)不同,參數結構一模一樣。這個對稱性讓整套 API 很好記。

分享到騰訊微博

WeixinJSBridge.on('menu:share:weibo', function (argv) {
  WeixinJSBridge.invoke('shareWeibo', {
    "content": dataForWeixin.title + ' ' + dataForWeixin.url,
    "url":     dataForWeixin.url
  }, function (res) {});
});

最關鍵的一步:等它就緒

微信內的 WebView 需要一點時間初始化。如果在 WeixinJSBridge 還不存在時就呼叫,所有接口都是 undefined,程式會直接丟出錯誤。解法是監聽 WeixinJSBridgeReady 事件:

if (document.addEventListener) {
  document.addEventListener('WeixinJSBridgeReady', sendMessage, false);
} else if (document.attachEvent) {
  // 舊 IE 的 attachEvent,且事件名要帶 on 前綴
  document.attachEvent('WeixinJSBridgeReady',  sendMessage);
  document.attachEvent('onWeixinJSBridgeReady', sendMessage);
}

這是整套做法中最重要的一段。少了它,使用者在弱網或冷啟動時會有一半機率遇到「分享沒反應」。

隱藏與顯示介面元素

WeixinJSBridge.call('hideToolbar');      // 隱藏右下方工具列
WeixinJSBridge.call('showToolbar');      // 顯示右下方工具列
WeixinJSBridge.call('hideOptionMenu');   // 隱藏右上角三個點按鈕
WeixinJSBridge.call('showOptionMenu');   // 顯示右上角三個點按鈕

call() 是「直接呼叫、不需要參數、沒有回呼」的簡化形式,跟 invoke() 屬於同一家族。

完整測試頁

把上面所有片段組起來,就是一個可以上機實測的頁面:

<!DOCTYPE html>
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=no">
<title>微信接口測試</title>

<script>
var dataForWeixin = {
  title: "發現 極客標簽 - 做最棒的極客知識分享平台",
  url:   "https://www.example.com",
  imgUrl: ""
};

function sendMessage() {
  WeixinJSBridge.on('menu:share:appmessage', function () {
    WeixinJSBridge.invoke('sendAppMessage', {
      "appid": "", "img_url": dataForWeixin.imgUrl,
      "img_width": "120", "img_height": "120",
      "link": dataForWeixin.url, "desc": "極客標簽",
      "title": dataForWeixin.title
    }, function (res) {});
  });

  WeixinJSBridge.on('menu:share:timeline', function () {
    WeixinJSBridge.invoke('shareTimeline', {
      "appid": "", "img_url": dataForWeixin.imgUrl,
      "img_width": "120", "img_height": "120",
      "link": dataForWeixin.url, "desc": "極客標簽",
      "title": dataForWeixin.title
    }, function (res) {});
  });

  alert("調用成功!現在可以通過右上角按鈕分享給朋友或者朋友圈!");
}

function hideMenu() { WeixinJSBridge.call('hideOptionMenu'); }
function showMenu() { WeixinJSBridge.call('showOptionMenu'); }
function hideTool() { WeixinJSBridge.call('hideToolbar'); }
function showTool() { WeixinJSBridge.call('showToolbar'); }

if (document.addEventListener) {
  document.addEventListener('WeixinJSBridgeReady', sendMessage, false);
} else if (document.attachEvent) {
  document.attachEvent('WeixinJSBridgeReady',   sendMessage);
  document.attachEvent('onWeixinJSBridgeReady', sendMessage);
}

// 判斷目前是否在微信中開啟
var ua = navigator.userAgent.toLowerCase();
if (ua.match(/MicroMessenger/i) == "micromessenger") {
  console.log("微信環境");
} else {
  alert("調用失敗,請用微信掃描二維碼打開網頁!");
}
</script>
</head>

<body>
<center>
  <h2>分享請點擊右上角</h2>
  <button onclick="hideMenu()">隱藏右上角三個點</button><br><br>
  <button onclick="showMenu()">顯示右上角三個點</button><br><br>
  <button onclick="hideTool()">隱藏下面導條</button><br><br>
  <button onclick="showTool()">顯示下面導條</button><br><br>
</center>
</body>
</html>

寫在最後

這套 WeixinJSBridge 私有接口屬於微信的早期方案,特色是「不需要 appId、不需要後端簽名」,代價是完全沒有身分驗證——任何人都能做出宣稱是某個網站的分享卡片。微信後續推出 JS-SDK,用後端簽名把這個漏洞補起來,同時也逐步收緊了私有接口的可用性。

因此這份內容的定位是「理解微信 WebView 是怎麼運作」的教材:它清楚示範了事件綁定的命名慣例、err_msg 的回傳格式、以及「橋樑物件尚未就緒」這個所有跨層通訊都會遇到的經典問題。實際 production 環境請以 JS-SDK 為準,並把簽名計算放在伺服器端。

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