在微信內開啟的網頁,分享出去後顯示什麼標題、什麼縮圖,並不是自動抓的,而是要靠 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 的寫法。