DIV CSS 佈局教程網

用 JavaScript 實作微信分享:WeixinJSBridge 的做法
編輯:關於JavaScript     

在微信內開啟的網頁,常需要自訂分享出去的標題、描述與縮圖。早期做法是透過 WeixinJSBridge 這個橋接物件,攔下微信右上角選單的分享動作,再自行帶入參數。以下把完整結構說明清楚。

一、準備四個參數

整段程式的可變部分其實只有四個值:縮圖網址、要分享出去的連結、描述文字、標題。把它們抽成變數,後續要換內容只改這幾行即可。

var imgUrl = 'https://example.com/share-cover.jpg';   // 分享縮圖
var lineLink = 'https://example.com/activity';          // 點擊後前往的連結
var descContent = '活動說明文字';                      // 分享描述
var shareTitle = '活動標題';                            // 分享標題
var appid = 'wxXXXXXXXXXXXXXXXX';                       // 微信公眾號 appid

二、三個分享入口各自對應一個函式

微信的分享分成三種場景:傳給好友、分享到朋友圈、分享到微博。各自呼叫不同的 bridge 方法。

function shareFriend() {
    WeixinJSBridge.invoke('sendAppMessage', {
        "appid": appid,
        "img_url": imgUrl,
        "img_width": "640",
        "img_height": "640",
        "link": lineLink,
        "desc": descContent,
        "title": shareTitle
    }, function (res) {
        _report('send_msg', res.err_msg);
    });
}

function shareTimeline() {
    WeixinJSBridge.invoke('shareTimeline', {
        "img_url": imgUrl,
        "img_width": "640",
        "img_height": "640",
        "link": lineLink,
        "desc": descContent,
        "title": shareTitle
    }, function (res) {
        _report('timeline', res.err_msg);
    });
}

function shareWeibo() {
    WeixinJSBridge.invoke('shareWeibo', {
        "content": descContent,
        "url": lineLink
    }, function (res) {
        _report('weibo', res.err_msg);
    });
}

要注意朋友圈的介面與好友不同:它不顯示 desc,只吃標題與縮圖。

三、等到橋接就緒再綁事件

WeixinJSBridge 不是頁面一載入就存在,微信內建瀏覽器完成內部初始化後才會觸發 WeixinJSBridgeReady 事件。所以監聽必須寫在這個事件裡,否則會拿到 undefined。

document.addEventListener('WeixinJSBridgeReady', function onBridgeReady() {
    // 傳送給好友
    WeixinJSBridge.on('menu:share:appmessage', function (argv) {
        shareFriend();
    });
    // 分享到朋友圈
    WeixinJSBridge.on('menu:share:timeline', function (argv) {
        shareTimeline();
    });
    // 分享到微博
    WeixinJSBridge.on('menu:share:weibo', function (argv) {
        shareWeibo();
    });
}, false);

最後在 body 放一個佔位標題即可:

<h1>頁面內容</h1>

四、重要前提:這套寫法已被取代

必須誠實說明:WeixinJSBridge 是微信早期的內部橋接方式,參數格式與可用性都隨版本變動過,如今不建議再用於新專案。

現行的標準做法是使用微信 JS-SDK,流程大致是:後端用目前取得的 access_token 算出 jsapi_ticket,再依 noncestr、時間戳與頁面網址產生簽章;前端引入 jweixin 之後呼叫 wx.config() 注入簽章資訊;最後透過 wx.ready() 註冊分享內容。

wx.ready(function () {
    wx.updateAppMessageShareData({
        title: shareTitle,
        desc: descContent,
        link: lineLink,
        imgUrl: imgUrl
    });
    wx.updateTimelineShareData({
        title: shareTitle,
        link: lineLink,
        imgUrl: imgUrl
    });
});

差別在於:JS-SDK 的簽章機制確保了呼叫來自有權限的頁面,參數結構也穩定得多。若你正在實作這功能,請直接從 JS-SDK 開始,把上面的 WeixinJSBridge 範例當作理解「微信如何攔截分享動作」的歷史背景來讀。

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