2014 年底微信發布整頓誘導分享與誘導關注的公告,舊的分享寫法跟著失效;隔年 1 月推出的 JS-SDK 則接上了這個缺口。本文說明微信 6.0 之後分享功能的正確接法。
一、JS-SDK 的分享介面只能「改內容」,不能「觸發分享」。它監聽的是使用者按下右上角選單的那一刻,讓你可以動態替換標題、連結、縮圖,並在分享完成或取消時收到回呼。
二、可分享的管道有限。包括分享到朋友圈、分享給朋友、分享到 QQ、分享到 QQ 空間、分享到騰訊微博。
微信 6.0 之後,WeixinJSBridge.on('menu:share:timeline', ...) 這種舊寫法不再可用,需改用 JS-SDK。
前提是伺服器端已經拿到該帳號的 access_token 與 jsapi_ticket,並用它算出頁面簽名。
wx.config({
debug: true, // 開啟調試模式,所有api返回值會在客戶端alert
appId: '@AccessTokenManage.AppID', // 公眾號唯一標識
timestamp:@timestamp , // 生成簽名的時間戳
nonceStr: '@timestamp', // 生成簽名的隨機串
signature: '@Common.SecurityHelper.SHA1(sig)',// 簽名
jsApiList: [ // 需要使用的JS接口列表
'onMenuShareTimeline',
'onMenuShareAppMessage',
'onMenuShareQQ',
'onMenuShareQZone',
'onMenuShareWeibo'
]
});
wx.config 是客戶端的非同步操作,因此所有介面呼叫都必須放在 wx.ready 回呼裡,才能確保 config 已取回結果。若某個介面只在使用者操作時才呼叫,則不受此限。
wx.ready(function () {
//監聽,分享到朋友圈
wx.onMenuShareTimeline({
title:'標題測試',
link:'https://www.jb51.net',
imgUrl:'https://www.jb51.net/favicon.ico',
success:function(){ appendText('分享成功'); },
cancel:function(){ appendText('已經取消'); }
});
//監聽,分享到QQ空間
wx.onMenuShareQZone({
title: '標題測試',
desc: '描述測試',
link: 'https://www.jb51.net',
imgUrl: 'https://www.jb51.net/favicon.ico',
success: function () { appendText('分享QQ空間成功'); },
cancel: function () { appendText('分享QQ控件取消'); }
});
//監聽,分享給朋友
wx.onMenuShareAppMessage({
title: '標題測試',
desc: '描述測試',
link: 'https://www.jb51.net',
imgUrl: 'https://www.jb51.net/favicon.ico',
type: 'link', // 分享類型,music、video或link,不填默認為link
dataUrl: '', // 如果type是music或video,則要提供數據鏈接
success: function () { appendText('分享給朋友成功'); },
cancel: function () { appendText('分享給朋友取消'); }
});
//監聽,分享到QQ
wx.onMenuShareQQ({
title: '標題測試',
desc: '描述測試',
link: 'https://www.jb51.net',
imgUrl: 'https://www.jb51.net/favicon.ico',
success: function () { appendText('分享到QQ成功'); },
cancel: function () { appendText('分享到QQ取消'); }
});
//監聽,分享到騰訊微博
wx.onMenuShareWeibo({
title: '標題測試',
desc: '描述測試',
link: 'https://www.jb51.net',
imgUrl: 'https://www.jb51.net/favicon.ico',
success: function () { appendText('分享到騰訊微博成功'); },
cancel: function () { appendText('分享到騰訊微博失敗'); }
});
appendText('ready事件觸發');
});
分享到朋友圈不支援 desc 欄位,只有標題、連結與縮圖會生效;onMenuShareAppMessage 的 type 與 dataUrl 在多數純文章場景下可以留空;debug: true 上 production 前務必關掉,否則使用者會看到一連串 alert 彈窗。