Senparc.Weixin.MP SDK 微信公眾平台開發教學課程（二）：成為開發者-微信開發-PHP中文網

一、公共平台的通訊流程

二、XML通訊格式

三、一些需要注意和容易被忽略的問題：

四、工欲善其事，必先利其器：Senparc.Weixin.MP.dll

首頁

微信小程式

微信開發

Senparc.Weixin.MP SDK 微信公眾平台開發教學課程（二）：成為開發者

高洛峰

Feb 22, 2017 pm 03:28 PM

微信大眾平台

我覺得做好成為開發者的準備比稀里糊塗開通微信後台的「高級」功能更重要，所以這一節先放在前面說。

一、公共平台的通訊流程

身為開發者，我們需要面對的主要有兩個物件：微信伺服器和應用程式（網站）伺服器。

當微信用戶向你的公眾平台發送一條訊息，實際上這條訊息首先發送到微信伺服器，由微信伺服器向網站伺服器發起另一個請求，網站伺服器返回這個請求的結果，再由微信伺服器發送到微信客戶端。

整個訊息通訊流程如下圖：

Senparc.Weixin.MP SDK 微信公众平台开发教程（二）：成为开发者

上述5個步驟中，身為開發者我們主要精力都集中在步驟3上，這個步驟主實際上要有3項任務：

接收來自2的XML訊息
伺服器內部邏輯執行
#組織並回傳用於4的XML資訊

上述三項任務我會在後面做詳細說明，並提供一整套簡單、有效率的處理方法。

二、XML通訊格式

使用者使用微信用戶端傳送的不同類型的訊息，網站伺服器會收到不同格式的資料（文字、語音、圖片等等），資料格式暫時只有XML一種。

作為學習，我覺得只要熟練最簡單的文字類型就可以了，其他的格式都是大同小異。而在後面的說明中你會發現，Senparc.Weixin.MP.dll可以幫助我們完全忽略這些繁瑣的格式和定義。

一個簡單的文字請求XML（RequestMessage）內容如下：

<xml>
    <ToUserName><![CDATA[gh_a96a4a619366]]></ToUserName>
    <FromUserName><![CDATA[olPjZjsXuQPJoV0HlruZkNzKc91E]]></FromUserName>
    <CreateTime>1357986928</CreateTime>
    <MsgType><![CDATA[text]]></MsgType>
    <Content><![CDATA[TNT2]]></Content>
    <MsgId>5832509444155992350</MsgId>
</xml>

登入後複製

　　對應節點的官方說明如下：

##Content文字訊息內容

#參數	描述
ToUserName	開發者微訊號
FromUserName	傳送方帳號（一個OpenID）
CreateTime	訊息建立時間（整數）
MsgType	text
#Content	文字訊息內容

MsgId

訊息id，64位元整數

一個簡單的文字回傳XML（ResponseMessage）內容如下：#

<xml>
   <ToUserName><![CDATA[olPjZjsXuQPJoV0HlruZkNzKc91E]]></ToUserName>
   <FromUserName><![CDATA[gh_a96a4a619366]]></FromUserName>
   <CreateTime>12345678</CreateTime>
   <MsgType><![CDATA[text]]></MsgType>
   <Content><![CDATA[content]]></Content>
   <FuncFlag>0</FuncFlag>
</xml>

登入後複製

　　對應節點的官方說明如下：#參數描述#接收方帳號（收到的OpenID）開發者微訊號訊息建立時間text回覆的訊息內容,長度不超過2048位元組######FuncFlag######位0x0001被標誌時，星標剛收到的訊息。 ############

三、一些需要注意和容易被忽略的問題：

每個XML訊息都有大小限制，如文字訊息，建議Content內容不要超過600字。
上圖中，步驟2開始之後，微信伺服器有一個等待時間：5秒，如果在這個時間內沒有進行到步驟4，那麼這個請求將會被關閉（包括資料傳輸的時間）。也就是說如果超過時間，即使網站伺服器回傳了數據，客戶端也無法收到回覆。
在文字訊息中，是允許添加標籤來放置連接的，但是有許多朋友測試之後發現iOS沒問題，Android上連結無法點擊，其實原因是（至少目前為止）：Android的微信客戶端對標籤格式的判定比較嚴格，請嚴格依照這個格式書寫：內容，href後不要使用單引號，也不要新增其他屬性。
上面XML節點中的FromUserName即微信用戶的OpenId，對於同一個公眾帳號，這個OpenId的前6位是一致的，並且在整個公眾平台的記錄中也是唯一的。也就是說同一個用戶關注了兩個不同的公眾帳號，他會有兩個不同的OpenId。
CreateTime使用的是Unix時間，因此如果使用C#的話，需要做一個轉換。
盡量保持官方API中XML節點的順序，以前微信伺服器是使用節點位置的方式讀取資訊的（node[0]），而非節點名稱，現在這個問題似乎有好轉，不過還是要小心（￥…………&%&……）。
由於這種特殊的通訊方式，（至少目前為止）所有請求必須從客戶端先發起，不要指望光使用API或SDK可以實現由網站伺服器主動推送訊息到客戶端（當然其他方法還是有的，例如模擬登陸）。