DIV CSS 佈局教程網

用 JavaScript 實作微信分享:朋友、朋友圈與 QQ 三種入口
編輯:關於JavaScript     

微信公眾號開發裡,「自訂分享內容」幾乎是必做的項目。預設的分享標題是頁面 title、沒有描述、縮圖也未必理想,透過 JS-SDK 就能完全掌控。以下記錄三個分享入口的設定方式。

前置:注入設定

呼叫任何分享介面前,必須先完成 wx.config,並在 wx.ready 之後註冊。這裡使用 wechat-sdk 這個 Node 套件,後端負責計算簽名並回傳給前端。

// 微信分享
var wx = require('wechat-sdk');

rewardsResultService.getWechatInfo().then(function(data) {
  var conf = data;
  wx.config({
    debug: false,
    appId: 'wx34e783920b37ee91',
    timestamp: conf.timestamp,
    nonceStr: conf.noncestr,
    signature: conf.signature,
    jsApiList: [
      'onMenuShareAppMessage',   //分享給朋友
      'onMenuShareTimeline',     //分享到朋友圈
      'onMenuShareQQ'            //分享到 QQ
    ]
  });
  configWeChatInterface();
});

var iconUrl = 'https://' + location.host + '/images/icon-200yuan.png';

function configWeChatInterface() {

  //分享給朋友
  wx.onMenuShareAppMessage({
    title: '一言不合就發紅包,金蛛送您200元紅包!',
    desc:  '一言不合就發紅包,金蛛送您200元紅包!',
    link:  location.href,
    imgUrl: iconUrl,
    type: 'link',
    success: function() {
      // alert('share success');
    },
    cancel: function() {
    }
  });

  //分享到朋友圈
  wx.onMenuShareTimeline({
    title: '一言不合就發紅包,金蛛送您200元紅包!',
    link:  location.href,  //分享鏈接
    imgUrl: iconUrl
  });

  //分享到 QQ
  wx.onMenuShareQQ({
    title: '一言不合就發紅包,金蛛送您200元紅包!',  //分享標題
    desc:  '一言不合就發紅包,金蛛送您200元紅包!',  //分享描述
    link:  location.href,                          //分享鏈接
    imgUrl: iconUrl,                               //分享圖標
    success: function () {
      //使用者確認分享後的回呼
    },
    cancel: function () {
      //使用者取消分享後的回呼
    }
  });
}

三個入口的差異

  • onMenuShareAppMessage(分享給朋友):支援 title、desc、link、imgUrl、type 五個欄位,資訊最完整。
  • onMenuShareTimeline(分享到朋友圈):只吃 title、link、imgUrl,沒有 desc。這是因為朋友圈的貼文格式本身就是標題加連結。
  • onMenuShareQQ:欄位近似分享給朋友,多了 type 的彈性。

幾個實務上的注意事項

1. imgUrl 建議用絕對路徑

範例中用 location.host 拼出完整網址,這個習慣是對的。微信對縮圖 URL 有相對嚴格的要求,用相對路徑容易抓不到圖。

2. 縮圖尺寸與快取

微信對分享縮圖會做快取,換了圖卻沒生效是常見問題。除了確認 URL 有加上版本參數(例如 ?v=2)來破快取,也要確保圖片本身就是可公開存取的。

3. link 參數的時機

範例直接用 location.href,實務上通常會替換成「帶分享者識別碼的推廣連結」,這樣才能追蹤是誰帶來的流量。若要這麼做,記得 link 的網域必須在公眾號的 JS 安全網域清單中。

4. 簽名 URL 必須與頁面 URL 一致

這是最容易出錯的一環。後端計算簽名時用的 URL,必須與前端實際載入的網址完全相同。若頁面有 hash 路由,微信的規則是取 # 之前的部分。

關於 API 版本的提醒

這裡使用的 onMenuShareAppMessage、onMenuShareTimeline、onMenuShareQQ 屬於較早期的寫法(在物件中直接設定分享內容)。微信後續推出了 updateAppMessageShareData 與 updateTimelineShareData 作為替代。

兩者的差別在於:舊版是「設定即生效」,新版則需要監聽 menuShareAppMessage 等事件、在使用者實際點擊分享時才讀取設定。新版的做法更即時——使用者停留頁面的期間,你可以動態更新分享內容(例如倒數計時結束後換一段文案)。

若你的專案是新開發的,建議直接採用新版 API;維護老程式時則不必急著改,舊版目前仍能運作,但要留意未來可能的相容性風險。

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