DIV CSS 佈局教程網

設定微信分享標題、縮圖、連結與描述的完整做法
編輯:關於JavaScript     

在微信內開啟的網頁,分享出去後顯示什麼標題、什麼縮圖,並不是自動抓的,而是要靠 JavaScript 主動設定。以下透過 WeixinJSBridge 完成這件事。

<script>
var imgUrl = 'https://topic.xcar.com.cn/201403/ad_q3/pic/banner.jpg';
var lineLink = 'https://topic.xcar.com.cn/201403/ad_q3/index.php';
var descContent = "https://topic.xcar.com.cn/201403/ad_q3/index.php";
var shareTitle = '【奧迪Q3開啟尊享禮遇季】報名試駕,贏取精美禮品';
var appid = 'wxc9937e3a66af6dc8';

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);
  });
}

// 微信內置瀏覽器完成內部初始化後會觸發 WeixinJSBridgeReady
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);
</script>

運作流程

關鍵是 WeixinJSBridgeReady 這個事件。微信內建瀏覽器在初始化完成後才會觸發它,而 WeixinJSBridge 物件也在此之前不存在,因此所有設定都必須寫在這個事件回呼裡,否則會拿到 undefined。

三個分享管道各有對應的 invoke 名稱:sendAppMessage 給好友、shareTimeline 到朋友圈、shareWeibo 到微博。朋友圈版本沒有 appid 參數,這是兩者的主要差異。

幾個實務細節

縮圖建議同時提供 img_url 與明確的寬高,微信對圖片有尺寸與大小限制,過大或比例過於誇張會被降級處理。另外 imgUrl 必須是絕對路徑且能被微信伺服器抓取,區域網路位址或需要登入的資源會抓不到。

_report 是作者自訂的統計函式,用來把分享結果回報到自家後端,這段需要自行實作。

重要提醒

WeixinJSBridge 是非公開的內部介面,微信官方並未提供正式文件,隨版本變動而失效是常態。官方推薦的做法是使用微信 JS-SDK:

// 1. 引入 https://res.wx.qq.com/open/js/jweixin-1.6.0.js
// 2. 後端簽名後透過 config 注入
wx.config({
  debug: false,
  appId: '你的appId',
  timestamp: 後端產生,
  nonceStr: '隨機字串',
  signature: '後端簽名',
  jsApiList: ['updateAppMessageShareData', 'updateTimelineShareData']
});

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

JS-SDK 需要後端配合產生簽名(涉及 appSecret,絕對不能寫在前端),但這是唯一有官方維護、不會突然失效的路徑。新專案請直接採用 JS-SDK,不要用上面這段 WeixinJSBridge 的寫法。

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