微信開發之接收文字訊息-微信開發-PHP中文網

文字訊息:

圖片訊息:

語音訊息:

影片訊息:

地理位置訊息:

連結訊息:

首頁

微信小程式

微信開發

微信開發之接收文字訊息

Y2J

May 09, 2017 am 09:43 AM

微信中的消息類型有：文本，圖片，語音，視頻，地理位置，連結和事件訊息。除了事件訊息外，其他的統稱為普通訊息。微信中訊息的推送與回應都是以xml資料包傳輸的。當使用者傳送訊息給公眾號碼時，微信伺服器在五秒鐘內收不到回應會斷掉連接，並且重新發起請求，總共重試三次。普通訊息可以使用msgid排重，以避免重複的訊息對業務邏輯的影響。

假如伺服器無法保證在五秒內處理並回复，可以直接回复空串，微信伺服器不會對此座任何處理，並且不會發起重試。要注意的是：這裡說的回覆空串並不是回覆空的文字訊息，而是直接Response.Write(“”)即可。

下面簡單對各普通訊息說明一下。

文字訊息:

<xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName> 
 <CreateTime>1348831860</CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content><![CDATA[this is a test]]></Content>
 <MsgId>1234567890123456</MsgId>
 </xml>

登入後複製

圖片訊息:

<xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>1348831860</CreateTime>
 <MsgType><![CDATA[image]]></MsgType>
 <PicUrl><![CDATA[this is a url]]></PicUrl>
 <MediaId><![CDATA[media_id]]></MediaId>
 <MsgId>1234567890123456</MsgId>
 </xml>

登入後複製

語音訊息:

<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1357290913</CreateTime><MsgType><![CDATA[voice]]></MsgType><MediaId><![CDATA[media_id]]></MediaId><Format><![CDATA[Format]]></Format><MsgId>1234567890123456</MsgId></xml>

登入後複製

影片訊息:

<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1357290913</CreateTime><MsgType><![CDATA[video]]></MsgType><MediaId><![CDATA[media_id]]></MediaId><ThumbMediaId><![CDATA[thumb_media_id]]></ThumbMediaId><MsgId>1234567890123456</MsgId></xml>

登入後複製

地理位置訊息:

<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1351776360</CreateTime><MsgType><![CDATA[location]]></MsgType><Location_X>23.134521</Location_X><Location_Y>113.358803</Location_Y><Scale>20</Scale><Label><![CDATA[位置信息]]></Label><MsgId>1234567890123456</MsgId></xml>

登入後複製

連結訊息:

<xml><ToUserName><![CDATA[toUser]]></ToUserName><FromUserName><![CDATA[fromUser]]></FromUserName><CreateTime>1351776360</CreateTime><MsgType><![CDATA[link]]></MsgType><Title><![CDATA[公众平台官网链接]]></Title><Description><![CDATA[公众平台官网链接]]></Description><Url><![CDATA[url]]></Url><MsgId>1234567890123456</MsgId></xml>

登入後複製

細心的程式猿應該發現了，所有的訊息中（包括事件訊息）,都包含下面幾個欄位

參數	#描述
ToUserName	接收方微訊號
#FromUserName	發送方微訊號，若為普通用戶，則是一個OpenID
CreateTime	訊息建立時間
MsgType	訊息類型

而訊息的類型在文章開頭已經講了，分別是:文字（text），圖片（image），語音（voice）,視訊（video），地理位置（location），連結（link），事件（event）

為了方便管理和程式碼編寫，我們可以把這些訊息類型寫一個枚舉。如下：

/// <summary>
    /// 消息类型枚举    /// </summary>
    public enum MsgType
    {        /// <summary>
        ///文本类型        /// </summary>        TEXT,        /// <summary>
        /// 图片类型        /// </summary>        IMAGE,        /// <summary>
        /// 语音类型        /// </summary>        VOICE,        /// <summary>
        /// 视频类型        /// </summary>        VIDEO,        /// <summary>
        /// 地理位置类型        /// </summary>        LOCATION,        /// <summary>
        /// 链接类型        /// </summary>        LINK,        /// <summary>
        /// 事件类型        /// </summary>        EVENT
    }

登入後複製

這裡說明下，C#中event是關鍵字，所以event在列舉中就不能使用了，所以為了統一，我這裡的枚舉全部使用大寫的。

既然所有的消息體都有上面的幾個字段，那就可以寫一個基類，然後不同的消息實體繼承這個基類。（一直在糾結一個問題，以前我都是將所有的消息體中的字段寫在一個類中，調用起來也很方便，只是類中的字段越來越多，看著都不爽。再加上本人才疏淺，物件導向也使用的不熟練，所以一直都是在一個類別中羅列所有的欄位

呼叫的時候直接 var ss = WeiXinRequest.RequestHelper(token, EncodingAESKey, appid );

返回一個WeiXinRequest，然後再對訊息類型和事件類型判斷，做出回應。讀性提高了，呼叫起來卻沒有之前方便了，各位朋友給點建議唄。

public abstract class BaseMessage
    {        /// <summary>
        /// 开发者微信号        /// </summary>
        public string ToUserName { get; set; }       /// <summary>
        /// 发送方帐号（一个OpenID）       /// </summary>
        public string FromUserName { get; set; }        /// <summary>
        /// 消息创建时间 （整型）        /// </summary>
        public string CreateTime { get; set; }        /// <summary>
        /// 消息类型        /// </summary>
        public MsgType MsgType { get; set; }        public virtual void ResponseNull()
        {
            Utils.ResponseWrite("");
        }        public virtual void ResText(EnterParam param, string content)
        {            
        }        /// <summary>
        /// 回复消息(音乐)        /// </summary>
        public  void ResMusic(EnterParam param, Music mu)
        {
        }        public  void ResVideo(EnterParam param, Video v)
        {        }        /// <summary>
        /// 回复消息(图片)        /// </summary>
        public  void ResPicture(EnterParam param, Picture pic, string domain)
        {
}        /// <summary>
        /// 回复消息（图文列表）        /// </summary>
        /// <param name="param"></param>
        /// <param name="art"></param>
        public  void ResArticles(EnterParam param, List<Articles> art)
        {        }        /// <summary>
        /// 多客服转发        /// </summary>
        /// <param name="param"></param>
        public  void ResDKF(EnterParam param)
        {
}        /// <summary>
        /// 多客服转发如果指定的客服没有接入能力(不在线、没有开启自动接入或者自动接入已满)，该用户会一直等待指定客服有接入能力后才会被接入，而不会被其他客服接待。建议在指定客服时，先查询客服的接入能力指定到有能力接入的客服，保证客户能够及时得到服务。        /// </summary>
        /// <param name="param">用户发送的消息体</param>
        /// <param name="KfAccount">多客服账号</param>
        public  void ResDKF(EnterParam param, string KfAccount)
        {        }        private  void Response(EnterParam param, string data)
        {            
        }
    }

登入後複製

基類中定義了訊息體的公共字段，以及用於回應使用者請求的虛擬方法（回應訊息不是本文重點，所以方法體就沒有貼出來，請關注後續文章）。

基底類別中方法的參數有個是EnterParam類型的，這個類別是用戶存取時和驗證訊息真實性需要使用的參數，包括token，加密金鑰，appid等。定義如下：

/// <summary>
    /// 微信接入参数    /// </summary>
    public class EnterParam
    {        /// <summary>
        /// 是否加密        /// </summary>
        public bool IsAes { get; set; }        /// <summary>
        /// 接入token        /// </summary>
        public string token { get; set; }        /// <summary>
        ///微信appid        /// </summary>
        public string appid { get; set; }        /// <summary>
        /// 加密密钥        /// </summary>
        public string EncodingAESKey { get; set; }
    }

登入後複製

文字實體：

public class TextMessage:BaseMessage
    {       /// <summary>
       /// 消息内容       /// </summary>
        public string Content { get; set; }       /// <summary>
        /// 消息id，64位整型       /// </summary>
        public string MsgId { get; set; }

    
    }

登入後複製

圖片實體：

public class ImgMessage : BaseMessage
    {       /// <summary>
       /// 图片路径       /// </summary>
        public string PicUrl { get; set; }       /// <summary>
        /// 消息id，64位整型       /// </summary>
        public string MsgId { get; set; }        /// <summary>
        /// 媒体ID        /// </summary>
        public string MediaId { get; set; }

     
    }

登入後複製

語音實體：

public class VoiceMessage : BaseMessage
    {       /// <summary>
       /// 缩略图ID       /// </summary>
        public string MsgId { get; set; }       /// <summary>
        /// 格式       /// </summary>
        public string Format { get; set; }        /// <summary>
        /// 媒体ID        /// </summary>
        public string MediaId { get; set; }        /// <summary>
        /// 语音识别结果        /// </summary>
        public string Recognition { get; set; }

    
    }

登入後複製

視訊實體：

public class VideoMessage : BaseMessage
    {       /// <summary>
       /// 缩略图ID       /// </summary>
        public string ThumbMediaId { get; set; }       /// <summary>
        /// 消息id，64位整型       /// </summary>
        public string MsgId { get; set; }        /// <summary>
        /// 媒体ID        /// </summary>
        public string MediaId { get; set; }

    
    }

登入後複製

連結實體：

public class LinkMessage : BaseMessage
    {       /// <summary>
       /// 缩略图ID       /// </summary>
        public string MsgId { get; set; }       /// <summary>
        /// 标题       /// </summary>
        public string Title { get; set; }        /// <summary>
        /// 描述        /// </summary>
        public string Description { get; set; }        /// <summary>
        /// 链接地址        /// </summary>
        public string Url { get; set; }

     
    }

登入後複製

訊息實體定義好了，下一步就是根據微信伺服器推送的訊息體解析成對應的實體。本打算用C#自帶的xml序列化發序列化的元件，結果試了一下總是報什麼xmls的錯，索性用反射寫了個處理方法：

public static T ConvertObj<T>(string xmlstr)
        {
            XElement xdoc = XElement.Parse(xmlstr);            var type = typeof(T);            var t = Activator.CreateInstance<T>();            foreach (XElement element in xdoc.Elements())
            {                var pr = type.GetProperty(element.Name.ToString());                if (element.HasElements)
                {//这里主要是兼容微信新添加的菜单类型。nnd，竟然有子属性，所以这里就做了个子属性的处理                    foreach (var ele in element.Elements())
                    {
                        pr = type.GetProperty(ele.Name.ToString());
                        pr.SetValue(t, Convert.ChangeType(ele.Value, pr.PropertyType), null);
                    }                    continue;
                }                if (pr.PropertyType.Name == "MsgType")//获取消息模型
                {
                    pr.SetValue(t, (MsgType)Enum.Parse(typeof(MsgType), element.Value.ToUpper()), null);                    continue;
                }                if (pr.PropertyType.Name == "Event")//获取事件类型。
                {
                    pr.SetValue(t, (Event)Enum.Parse(typeof(Event), element.Value.ToUpper()), null);                    continue;
                }
                pr.SetValue(t, Convert.ChangeType(element.Value, pr.PropertyType), null);
            }            return t;
        }

登入後複製

處理xml的方法定義好之後，以下就是講根據不同的訊息類型來解析對應的實體了：

public class MessageFactory
    {        public static BaseMessage CreateMessage(string xml)
        {
            XElement xdoc = XElement.Parse(xml);            var msgtype = xdoc.Element("MsgType").Value.ToUpper();
            MsgType type = (MsgType)Enum.Parse(typeof(MsgType), msgtype);            switch (type)
            {                case MsgType.TEXT: return Utils.ConvertObj<TextMessage>(xml);                case MsgType.IMAGE: return Utils.ConvertObj<ImgMessage>(xml);                case MsgType.VIDEO: return Utils.ConvertObj<VideoMessage>(xml);                case MsgType.VOICE: return Utils.ConvertObj<VoiceMessage>(xml);                case MsgType.LINK:                    return Utils.ConvertObj<LinkMessage>(xml);                case MsgType.LOCATION:                    return Utils.ConvertObj<LocationMessage>(xml);                case MsgType.EVENT://事件类型                {
                    
                } break;                default:                    return Utils.ConvertObj<BaseMessage>(xml);
            }
        }
    }

登入後複製

CreateMessage方法傳入封包（如加密，需解密後傳入），以基底類別的形式傳回對應的實體。

講到這裡普通訊息的接收就差不多講完了，結合上一篇博文，現在把修改後的接入代碼貼出來如下：

public class WxRequest
    {       public static BaseMessage Load(EnterParam param, bool bug = true)
       {           string postStr = "";
           Stream s = VqiRequest.GetInputStream();//此方法是对System.Web.HttpContext.Current.Request.InputStream的封装，可直接代码
           byte[] b = new byte[s.Length];
           s.Read(b, 0, (int)s.Length);
           postStr = Encoding.UTF8.GetString(b);//获取微信服务器推送过来的字符串
           var timestamp = VqiRequest.GetQueryString("timestamp");           var nonce = VqiRequest.GetQueryString("nonce");           var msg_signature = VqiRequest.GetQueryString("msg_signature");           var encrypt_type = VqiRequest.GetQueryString("encrypt_type");           string data = "";           if (encrypt_type=="aes")//加密模式处理           {
               param.IsAes = true;               var ret = new MsgCrypt(param.token, param.EncodingAESKey, param.appid);               int r = ret.DecryptMsg(msg_signature, timestamp, nonce, postStr, ref data);               if (r != 0)
               {
                   WxApi.Base.WriteBug("消息解密失败");                   return null;

               }
           }           else
           {
               param.IsAes = false;
               data = postStr;
           }           if (bug)
           {
               Utils.WriteTxt(data);
           }           return MessageFactory.CreateMessage(data);
       }
    }

登入後複製

【相關推薦】

微信公眾號平台原始碼下載

微信啦啦外送2.2.4解密開源版微信魔術方塊原始碼

以上是微信開發之接收文字訊息的詳細內容。更多資訊請關注PHP中文網其他相關文章！

本網站聲明

本文內容由網友自願投稿，版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容，請聯絡admin@php.cn

熱AI工具

Undresser.AI Undress

人工智慧驅動的應用程序，用於創建逼真的裸體照片

AI Clothes Remover

用於從照片中去除衣服的線上人工智慧工具。

Undress AI Tool

免費脫衣圖片

Clothoff.io

AI脫衣器

Video Face Swap

使用我們完全免費的人工智慧換臉工具，輕鬆在任何影片中換臉！

熱工具

記事本++7.3.1

好用且免費的程式碼編輯器

SublimeText3漢化版

中文版，非常好用

禪工作室 13.0.1

強大的PHP整合開發環境

Dreamweaver CS6

視覺化網頁開發工具

SublimeText3 Mac版

神級程式碼編輯軟體(SublimeText3)

熱門話題

Java教學

1665

CakePHP 教程

1424

Laravel 教程

1322

PHP教程

1269

C# 教程

1249

Related knowledge

PHP微信開發：如何實作訊息加密解密 May 13, 2023 am 11:40 AM

PHP是一種開源的腳本語言，廣泛應用於網頁開發和伺服器端編程，尤其在微信開發中得到了廣泛的應用。如今，越來越多的企業和開發者開始使用PHP進行微信開發，因為它成為了真正的易學易用的開發語言。在微信開發中，訊息的加密和解密是一個非常重要的問題，因為它們涉及資料的安全性。對於沒有加密和解密方式的消息，駭客可以輕鬆取得其中的數據，對用戶造成威脅

用PHP開發微信群發工具 May 13, 2023 pm 05:00 PM

隨著微信的普及，越來越多的企業開始將其作為行銷工具。而微信群發功能，則是企業進行微信行銷的重要手段之一。但是，如果只依靠手動發送，對於行銷人員來說是一件極為費時費力的工作。所以，開發一款微信群發工具就顯得格外重要。本文將介紹如何使用PHP開發微信群發工具。一、準備工作開發微信群發工具，我們需要掌握以下幾個技術點：PHP基礎知識微信公眾平台開發開發工具：Sub

PHP微信開發：如何實現使用者標籤管理 May 13, 2023 pm 04:31 PM

在微信公眾號開發中，使用者標籤管理是一個非常重要的功能，可以讓開發者更了解和管理自己的使用者。本篇文章將介紹如何使用PHP實作微信使用者標籤管理功能。一、取得微信用戶openid在使用微信用戶標籤管理功能之前，我們首先需要取得用戶的openid。在微信公眾號開發中，透過使用者授權的方式取得openid是比較常見的做法。在使用者授權完成後，我們可以透過以下程式碼取得用

PHP微信開發：如何實現投票功能 May 14, 2023 am 11:21 AM

在微信公眾號開發中，投票功能經常被運用。投票功能是讓使用者快速參與互動的好方式，也是舉辦活動和調查意見的重要工具。本文將為您介紹如何使用PHP實作微信投票功能。在取得微信公眾號授權首先，你需要取得微信公眾號的授權。在微信公眾平台上，你需要設定微信公眾號碼的api地址、官方帳號和公眾號碼對應的token。在我們使用PHP語言開發的過程中，我們需要使用微信官方提供的PH

使用PHP實現微信公眾號開發的步驟 Jun 27, 2023 pm 12:26 PM

如何使用PHP實現微信公眾號開發微信公眾號已經成為了許多企業推廣和互動的重要管道，而PHP作為常用的Web語言，也可以用來進行微信公眾號的開發。本文將介紹使用PHP實現微信公眾號開發的具體步驟。第一步：取得微信公眾號的開發者帳號在開始微信公眾號開發之前，需要先去申請一個微信公眾號的開發者帳號。具體的註冊流程可參考微信公眾平台的官方網

PHP微信開發：如何實作群發訊息傳送記錄 May 13, 2023 pm 04:31 PM

隨著微信成為了人們生活中越來越重要的通訊工具，其敏捷的訊息傳遞功能迅速受到廣大企業和個人的青睞。對企業而言，將微信發展為一個行銷平台已經成為趨勢，而微信開發的重要性也逐漸凸顯。在其中，群發功能更是被廣泛使用，那麼，作為PHP程式設計師，如何實現群發訊息發送記錄呢？以下將為大家簡單介紹一下。 1.了解微信公眾號相關開發知識在了解如何實現群發訊息發送記錄之前，我

PHP微信開發：如何實現客服聊天視窗管理 May 13, 2023 pm 05:51 PM

微信是目前全球用戶規模最大的社群平台之一，隨著行動網路的普及，越來越多的企業開始意識到微信行銷的重要性。在進行微信行銷時，客服服務是至關重要的一環。為了更好地管理客服聊天窗口，我們可以藉助PHP語言進行微信開發。一、PHP微信開發簡介PHP是一種開源的伺服器端腳本語言，廣泛用於Web開發領域。結合微信公眾平台提供的開發接口，我們可以使用PHP語言進行微信

如何使用PHP進行微信開發？ May 21, 2023 am 08:37 AM

隨著網路和行動智慧型裝置的發展，微信成為了社交和行銷領域不可或缺的一部分。在這個越來越數位化的時代，如何使用PHP進行微信開發已經成為了許多開發者的關注點。本文主要介紹如何使用PHP進行微信發展的相關知識點，以及其中的一些技巧和注意事項。一、開發環境準備在進行微信開發之前，首先需要準備好對應的開發環境。具體來說，需要安裝PHP的運作環境，以及微信公眾平台提

See all articles

微信開發之接收文字訊息

文字訊息:

圖片訊息:

語音訊息:

影片訊息:

地理位置訊息:

連結訊息:

熱AI工具

Undresser.AI Undress

AI Clothes Remover

Undress AI Tool

Clothoff.io

Video Face Swap

熱門文章

熱工具

記事本++7.3.1

SublimeText3漢化版

禪工作室 13.0.1

Dreamweaver CS6

SublimeText3 Mac版

熱門話題