WeChat 공개 플랫폼 SDK 프로세스에 대한 자세한 설명

서비스 계정 설명: 기업과 조직에 더욱 강력한 비즈니스 서비스와 사용자 관리 기능을 제공하고 기업이 새로운 공용 계정 서비스 플랫폼을 신속하게 구현할 수 있도록 지원합니다.

.NETSDK: Loogn.WeiXinSDK(net2.0 소스 코드, 다음 코드는 대략적인 것이며 정확하지 않습니다. 소스 코드를 직접 다운로드하세요.)

저는 아직 NOKIA-C5를 사용하고 있으므로 , 저는 WeChat을 사용해 본 적이 없습니다. WeChat에 대해 당신만큼 잘 모르지만 회사에 필요한 것이 있으므로 총알을 물고 인터페이스 문서를 직접 읽어야합니다.

읽어본 결과 매우 흥미로운 기능은 사용자가 공개 계정에 메시지를 보낼 때 해당 사용자가 보낸 내용을 기반으로 프로그램이 자동으로 사용자에게 응답할 수 있다는 것입니다. 물류회사의 공용계좌로 메시지를 보내는 등,

상대방이 자동으로 해당 운송장번호의 물류정보를 회신해 주는게 참 기분이 좋습니다! 설명의 편의를 위해 적용된 공용 계정 정보를 먼저 드립니다.

위의 물류를 조회하는 자세한 메시지 프로세스는 다음 그림과 같습니다(점선 안의 숫자). 프로세스 순서 표시):

WeChat은 두 가지 주요 유형의 메시지를 URL로 보냅니다.

하나는 다음과 같은 사용자의 일반 메시지입니다. 위의 사용자가 보낸 운송장 번호; 두 번째는 사용자의 행동(예: 문서에 언급된 이벤트)입니다. 예를 들어 사용자가 공용 계정을 팔로우하고 공용 계정의 QR 코드를 스캔하고 클릭합니다. 맞춤형 메뉴 등

귀하의 URL은 수신된

메시지 유형 및 내용

을 기반으로 응답하여 위에 반환된 물류 세부정보와 같은 강력한 비즈니스 서비스를 달성할 수 있습니다. 모든 메시지는 XML 형식으로 전달되며 SDK가 수행하는 작업은 비즈니스 논리 작성을 용이하게 하기 위해 XML을 .NET 개체로 변환하는 것입니다. 메시지의 프레임워크 클래스 다이어그램은 다음과 같이 표시됩니다(하위 클래스를 포함한 전체 다이어그램을 보려면 클릭).

먼저 메시지 기본 클래스가 있고 그 다음에는 수신된 메시지(RecEventBaseMsg ) 및 응답 메시지(ReplyBaseMsg)는 위에서 언급한 것처럼 수신된 메시지는 일반 메시지(RecBaseMsg)와 이벤트 메시지(EventBaseMsg)의 두 가지 범주로 구분됩니다. 수신된 메시지 유형은

다른 유형은 말할 것도 없고, MsgType이 Event인 경우 메시지는 EventBaseMsg의 하위 클래스입니다. EventBaseMsg의 모든 하위 클래스 중 MsgType은 Event이므로 EventBaseMsg 유형에도 EventType이 있습니다. 이벤트, 인터페이스 문서를 읽었다면 이벤트 유형이 어떤 이벤트인지 판단하기가 쉽지 않다는 것을 알아야 합니다. 스캔 QR 코드 이벤트는 사용자가 주의를 기울인 경우와 사용자가 받은 경우의 두 가지 상황으로 나뉩니다. 주의를 기울이지 않으면 팔로우하지 않는 경우 EventType이 스캔되고 사용자가 팔로우하는 이벤트의 EventType도 구독되므로 SDK에 또 다른 MyEventType이 추가됩니다.

이제 메시지 흐름 기본적으로 SDK를 호출할 때 응답 메시지는 다음과 같습니다.

using System.Web;using Loogn.WeiXinSDK;using Loogn.WeiXinSDK.Message;namespace WebTest
{    /// <summary>
    /// 微信->服务器配置URL    /// </summary>
    public class WeiXinAPI : IHttpHandler
    {        static string Token = "Token";//这里是Token不是Access_Token
        public void ProcessRequest(HttpContext context)
        {
            context.Response.ContentType = "text/plain";            var signature = context.Request["signature"];            var timestamp = context.Request["timestamp"];            var nonce = context.Request["nonce"];            if (WeiXin.CheckSignature(signature, timestamp, nonce, Token))//验证是微信给你发的消息            {                //根据注册的消息、事件处理程序回复，                //如果得到没用注册的消息或事件，会返回ReplyEmptyMsg.Instance,即GetXML()为string.Empty,符合微信的要求
                var replyMsg = WeiXin.ReplyMsg();                var xml = replyMsg.GetXML();                //WriteLog(xml); //这里可以查看回复的XML消息                context.Response.Write(xml);
            }            else
            {
                context.Response.Write("fuck you!");
            }
        }        static WeiXinAPI()
        {
            WeiXin.ConfigGlobalCredential("appid", "appSecret");            //注册一个消息处理程序，当用户发"ABC"，你回复“你说：ABC”;
            WeiXin.RegisterMsgHandler<RecTextMsg>((msg) =>
            {                return new ReplyTextMsg
                {
                    Content = "你说：" + msg.Content                    //FromUserName = msg.ToUserName,  默认就是这样，不用设置！                    //ToUserName = msg.FromUserName,  默认就是这样，不用设置！                    //CreateTime = DateTime.Now.Ticks     默认就是这样，不用设置！                };
            });            //注册一个用户关注的事件处理程序，当用户关注你的公众账号时，你回复“Hello!”
            WeiXin.RegisterEventHandler<EventAttendMsg>((msg) =>
            {                return new ReplyTextMsg
                {
                    Content = "Hello !"
                };
            });            //还可以继续注册你感兴趣的消息、事件处理程序        }        public bool IsReusable
        {            get
            {                return false;
            }
        }
    }
}

SDK에는 OAuth2.0 웹 인증을 제외한 모든 인터페이스가 캡슐화되어 있습니다. ) 클래스 이름과 메소드 이름은 매우 명확하므로 여기서는 하나씩 설명하지 않겠습니다. 관심 있는 친구는 dll을 다운로드하여 직접 테스트할 수 있습니다.

구현에 대한 몇 가지 세부 사항에 대해 이야기해 보겠습니다.

1. 자격 증명(access_token) 만료

"Access_token은 공식 계정의 전역 고유 티켓입니다. 공식 계정은 각 인터페이스를 호출할 때 access_token을 사용해야 합니다. 일반적인 상황에서는

access_token이 7200초 동안 유효합니다

. 반복적으로 획득하면 마지막 access_token이 유효하지 않게 됩니다. 공용 계정은 AppID 및 AppSecret을 사용하여 이를 호출할 수 있습니다. access_token을 얻기 위한 인터페이스입니다. AppID 및 AppSecret은 개발 모드에서 얻을 수 있습니다(개발자여야 하며 계정에 비정상적인 상태가 없어야 함)

문서에 따르면 캐싱을 사용하는 것을 생각할 수 있습니다. 매번 사용하고 매번 가져오는 것은 불가능합니다!) 캐시 코드는 주로 이 상황에서

캐시를 사용하는 경우

불완전한 코드입니다. >

 
       access_token { ;  
         
          expires_in { ;  Dictionary<, Credential> creds =  Dictionary<, Credential>  TokenUrl =   Credential GetCredential( appId, =  (creds.TryGetValue(appId,  (cred.add_time.AddSeconds(cred.expires_in - ) <=  json = Util.HttpGet2(= Util.JsonTo<Credential>

2. 오류 코드 정보 위에서 언급한 자격 증명 획득 코드는 처리 가능성이 없기 때문에 불완전합니다. 반환된 오류 코드, WeChat 오류 코드는 다음과 같은 json 형식으로 반환됩니다. 🎜>

{"errcode":40013,"errmsg":"invalid appid"}

우리가 적극적으로 호출하는 대부분의 인터페이스는 오류 코드 형식을 반환할 수 있습니다. SDK에서는 먼저 다음과 같이 처리합니다. 오류 코드에 {"errcode":0,"errmsg":"ok"} 요청 성공도 포함되어 있으므로 이를 ReturnCode라고 부릅니다. 상황:

       errcode { ;   errmsg { ;     + errcode +  + errmsg +

오류가 있는 반환 메시지 클래스를 정의하는 경우 코드에 QR 코드 인터페이스 생성과 같은 ReturnCode 유형 속성을 포함할 수 있습니다.

    public class QRCodeTicket
    {        public string ticket { get; set; }        public int expire_seconds { get; set; }        public ReturnCode error { get; set; }
    }

반환된 json에서 QRCodeTicket으로 개체의 코드는 대략 다음과 같습니다(다른 코드도 유사함).

            var json = Util.HttpPost2(url, data);            if (json.IndexOf("ticket") > 0)
            {                return Util.JsonTo<QRCodeTicket>(json);
            }            else
            {
                QRCodeTicket tk = new QRCodeTicket();
                tk.error = Util.JsonTo<ReturnCode>(json);                return tk;
            }

따라서 SDK로 인터페이스를 호출한 후 획득한 객체를 쉽게 판단할 수 있습니다.

            var qrcode = WeiXin.CreateQRCode(true, 23);            if (qrcode.error == null)
            {                //返回错误，可以用qrcode.error查看错误消息            }            else
            { 
                //返回正确，可以操作qrcode.ticket
            }

三、反序列化

微信接口返回的json有时候对我们映射到对象并不太直接（json格式太灵活了！），比如创建分组成功后返回的json：

{    "group": {        "id": 107, 
        "name": "test"
    }
}

如果想直接用json通过反序列化得到对象，那么这个对象的类的定义有可能会是这样：

    public class GroupInfo
    {        public Group group { get; set; }        public class Group
        {            public int id { get; set; }            public string name { get; set; }
        }
    }

访问的时候也会是gp.group.name，所以我说不太直接，我们想要的类的定义肯定是只有上面那个子类的样子：

    public class GroupInfo
    {            public int id { get; set; }            public string name { get; set; }
    }

如果微信接口返回的是这样：

    {        "id": 107, 
        "name": "test"
    }

就再好不过了，但人家的代码,我们修改不了，我们只有自己想办法.

1,要简单类，2不手动分析json(如正则)，3，不想多定义一个类，你有想到很好的方法吗？如果有可以回复给我，而我选择用字典来做中间转换。

因为基本所有的json格式都可以反序列化为字典（嵌套字典，嵌套字典集合等），比如上面微信返回的json就可以用以下的类型来表示：

Dictionary<string, Dictionary<string, object>>

json--->dict--->GroupInfo

var dict = Util.JsonTo(json);var gi = new GroupInfo();var gpdict = dict["group"];
gi.id = Convert.ToInt32(gpdict["id"]);
gi.name = gpdict["name"].ToString();

四、消息处理的优化

"万物简单为美"，我就是一个非常非常喜欢简单的程序员。还记得最开始的那个消息（事件属于消息，这里统称为消息）处理吧，我感觉是很简单的，需要处理哪个消息就注册哪个消息的处理程序。但一开始的时候不是这样的，开始的时候要手动判断消息类型，就像：

using System.Web;using Loogn.WeiXinSDK;using Loogn.WeiXinSDK.Message;namespace WebTest
{    /// <summary>
    /// 微信->服务器配置URL    /// </summary>
    public class WeiXinAPI : IHttpHandler
    {        static string Token = "Token";//这里是Token不是Access_Token
        public void ProcessRequest(HttpContext context)
        {
            context.Response.ContentType = "text/plain";            var signature = context.Request["signature"];            var timestamp = context.Request["timestamp"];            var nonce = context.Request["nonce"];            if (WeiXin.CheckSignature(signature, timestamp, nonce, Token))//验证是微信给你发的消息            {                var replyMsg = WeiXin.ReplyMsg((recEvtMsg) =>
                {                    switch (recEvtMsg.MsgType)
                    {                        case MsgType.text:
                            {                                var msg = recEvtMsg as RecTextMsg; //这里要转型，麻烦
                                return new ReplyTextMsg
                                {
                                    Content = "你说：" + msg.Content
                                };
                            }                        case MsgType.Event:
                            {                                var evtMsg = recEvtMsg as EventBaseMsg;//这里要转型到事件消息的基本，麻烦
                                switch (evtMsg.MyEventType)
                                {                                    case MyEventType.Attend:                                        var msg = evtMsg as EventAttendMsg;//这个例子不需要这行代码，但其他要用消息内容还是要转型，麻烦
                                        return new ReplyTextMsg
                                        {
                                            Content = "Hello !"
                                        };                                        
                                    default:                                        break;
                                }                                break;
                            }                        default:                            break;
                    }                    return ReplyEmptyMsg.Instance;                    //嵌套switch,而且每个case都有好几个，这也不优雅                });                var xml = replyMsg.GetXML();                //WriteLog(xml); //这里可以查看回复的XML消息                context.Response.Write(xml);
            }            else
            {
                context.Response.Write("fuck you!");
            }
        }        public bool IsReusable
        {            get
            {                return false;
            }
        }
    }
}

做优化的时候，先是试着看能不能在MsgType和MyEventType上做文章，比如注册时传入MsgType和处理程序(lamba)两个参数：

public static void RegisterMsgHandler(MsgType type, Func<RecEventBaseMsg, ReplyBaseMsg> handler)
{    //add handler}

 这样的确是可以行的通的，但是在调用SDK注册的时候还是要手动转换类型：

 WeiXin.RegisterMsgHandler(MsgType.text, (recEvtMsg) => msg = recEvtMsg   ReplyTextMsg { Content =  +

 那么能不能每个子类型写一个呢?

    public static void RegisterMsgHandler(MsgType type, Func<RecTextMsg, ReplyBaseMsg> handler)
    {        //add handler    }    public static void RegisterMsgHandler(MsgType type, Func<RecImageMsg, ReplyBaseMsg> handler)
    {        //add handler    }    //.............

 定义是可以的，来看看调用：

//可以RegisterMsgHandler(MsgType.text, new Func<RecTextMsg, ReplyBaseMsg>((msg) =>{    return new ReplyTextMsg { Content = "你说：" + msg.Content };
}));//可以RegisterMsgHandler(MsgType.text, new Func<RecImageMsg, ReplyBaseMsg>((msg) =>{    return new ReplyTextMsg { Content = "你发的图片：" + msg.PicUrl };
}));//可以，注意这里msg的智能提示是RecTextMsg类型RegisterMsgHandler(MsgType.text, (msg) =>{    return new ReplyTextMsg { Content = "你说：" +msg.Content};
});//可以，注意这里msg的智能提示还是RecTextMsg类型，但用了类型推断,运行时可以确定是RecImageMsg，所以可以RegisterMsgHandler(MsgType.text, (msg) =>{    return new ReplyTextMsg { Content = "你发的图片：" + msg.PicUrl };
});//不可以，注意这里msg的智能提示还是RecTextMsg类型，但lamba body里没有用msg的特定子类的属性，类型推断不了，所以调用不明RegisterMsgHandler(MsgType.text, (msg) =>{    return new ReplyTextMsg { Content = "你发了个消息" };
});

 从上面调用可知，想用这种方法调用，就不能随意的用lamba表达式，我所不欲也！最后，终于用泛型搞定了

public static void RegisterMsgHandler<TMsg>(Func<TMsg, ReplyBaseMsg> handler) where TMsg : RecBaseMsg
        {            var type = typeof(TMsg);            var key = string.Empty;            if (type == typeof(RecTextMsg))
            {
                key = MsgType.text.ToString();
            }            else if (type == typeof(RecImageMsg))
            {
                key = MsgType.image.ToString();
            }            else if (type == typeof(RecLinkMsg))
            {
                key = MsgType.link.ToString();
            }            else if (type == typeof(RecLocationMsg))
            {
                key = MsgType.location.ToString();
            }            else if (type == typeof(RecVideoMsg))
            {
                key = MsgType.video.ToString();
            }            else if (type == typeof(RecVoiceMsg))
            {
                key = MsgType.voice.ToString();
            }            else
            {                return;
            }
            m_msgHandlers[key] = (Func<RecEventBaseMsg, ReplyBaseMsg>)handler;
        }

经过这样的变换，我们才可以像开始那样用简洁的lamba表达式注册。

위 내용은 WeChat 공개 플랫폼 SDK 프로세스에 대한 자세한 설명의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!