微信公眾平台開發框架 Bee.WeiXin


我們來看一下如何通過Bee.WeiXin開發微信公眾平台。關於微信公眾平台的一般性介紹, 這里不做展開。 園里找一找就可以了。 本文主要是介紹Bee.WeXin, 代碼已發布到https://beeweixin.codeplex.com/上了。

BeeWeiXin 是針對騰訊的微信公眾平台開發一個開發框架。  該項目是基於Bee OPOA Platform 開發的。

包含了以下功能:

1. 基於調用樹的微信答復模型。 調用樹支持多級(有上下文)響應,  可以通過 文本, 圖文, 自定義三種方式響應。 其中自定義可以回復微信公眾平台API所提供的三個方式(文本, 圖文, 音樂)。

2. 提供了同步微信關注用戶列表的功能。

3. 提供了菜單管理功能。

4. 提供了圖文管理功能。

5. 原生集成Bee OPOA Platform上的所有功能, 主要是權限管理。

關於調試, 推薦采用園友提供的工具 微信公眾帳號開發調試工具發布 

預覽

配置項說明

配置項均在web.config中【appSettings】配置.

【WeiXinToken】就是公眾平台API方式的Token;

【Debug】是指當前是否處於調試模式。 調試模式與非調試模式的區別就在於是否對發起的調用進行驗證。

【WeiXinUserName】與【WeiXinPassword】 是菜單【微信關注用戶】中【重新同步所有用戶】所需要的, 將模擬網頁登入到微信公眾平台中, 然后獲取用戶列表信息。 若不需要, 可以忽略, 也可以隱藏掉該菜單。

【WeiXinAppId】與【WeiXinAppSec】是菜單【微信菜單管理】中所需要的, 可以管理微信公眾賬號的菜單。 當然該工具【微信公眾帳號開發調試工具發布 】也有此功能, 比較方便。 若不需要, 可以忽略, 也可以隱藏掉該菜單。

【WeiXinController】是默認的系統響應Controller, 具體邏輯請參看代碼。

調用鏈方式的應答

調用鏈是基於上下文的, 在配置項中有個選項【是否進入調用鏈】若是的話, 則將此次應答加入調用鏈中, 以形成上下文。 如【菜單1】是要進入調用鏈的, 不然該項下面的子項將無法響應。

先看以下圖片:

由預覽圖中, 可以直觀的了解調用鏈可以提供 文本、圖文、自定義三種響應。

文本就是一般性的文本應答。 如在Bee.WeiXinDemo項目中已配置了【菜單1】是以文本響應, 節點值是V1001_M1_1。

回復1,test1
回復2,test2
回復3,test3

回復得到如下:

圖文就是微信公眾平台API中提供的圖文信息, 在調用鏈配置中只要按照順序輸入指定的文章號【該號碼是微信文章管理中的Id】就可以了(以逗號分隔)。

如【菜單1】下的test2是圖文格式。 進入test2需要先觸發菜單1, 然后再觸發test2. 如下圖:

自定義是融合到Bee OPOA Platform框架中MVC實現的。 所以配置的也是通過Controller, Action來實現。

如【菜單1】下的test3是自定義方式。進入test3需要先觸發菜單1, 然后再觸發test3. 如下圖:

 

不知道各位了解了沒有? 建議大家下載源碼, 調試下以加深理解, 最好是有空看看代碼, 以幫助完善該項目, 呵呵。

【菜單1】下面只有鍵值【1】,【2】,【3】, 若用戶輸入其他怎么響應呢?這個時候只要配置鍵值【*】, 作為其他的配置項應答。

理解調用鏈上下文

在這種基於調用鏈的應答中, 上下文是必要的。 怎么理解呢?舉例說明吧:我要查詢某個產品的某個國家的最近3個月的銷售情況。 由於微信平台的特性, 我們不可能像其他應用給用戶以直觀的查詢。

我們只有采用引導式的方式去引導用戶得到她想要的結果。 設計的菜單如預覽圖中【多級菜單】項所示。具體的配置項如下圖:

當用戶點擊菜單按鈕觸發了【V1001_M1_2】的事件, 系統響應提示文本【上圖的1】; 用戶根據提示, 選擇產品, 輸入1, 系統提示輸入國家【上圖的2】。 由於國家太多, 不太可能配置所有國家的選項, 所有采用了一個通配符的方案【上圖的3】, 並采用自定義的方式應答。  代碼如下:

public WeiXinTextResult CheckCountry()
        {
            string content = ViewData.TryGetValue<string>("content", string.Empty);

            // 驗證輸入的國家是否合法
            bool validFlag = content.IndexOf("CN") >= 0;

            if (validFlag)
            {
                return WeiXinText("1 最近3個月銷售統計\r\n2 最近6個月銷售統計");
            }
            else
            {
                // 由於調用鏈有上下文, 用戶輸入錯誤, 需要將當前應答取消。Current.MessageStack.Pop();
                Current.MessageStack.Pop();
                return WeiXinText("國家不合法,請重新輸入國家。");
            }
        }

由以上代碼可以知道上下文可以通過Current.MessageStack獲取。

用戶輸入正確的國家代碼, 則引導用戶做下一個選擇.

自定義MVC響應

這個基本上跟Bee OPOA Platform的方式一模一樣。 如【菜單1】下的【Other】項的響應就是采用該方式的。代碼如下:

public ActionResult Other()
        {
            return View();
        }

View代碼如下:

<%@ Page Language="C#" AutoEventWireup="false" Inherits="Bee.Web.BeePageView" %>

<%@ Import Namespace="Bee.Web" %>
<%@ Import Namespace="Bee" %>
<%@ Import Namespace="System.Collections.Generic" %>
<xml>
 <ToUserName><![CDATA[<%=ViewData["FromUserName"] %>]]></ToUserName>
 <FromUserName><![CDATA[<%=ViewData["ToUserName"] %>]]></FromUserName>
 <CreateTime><%=Bee.WeiXin.DateTimeUtil.GetWeixinDateTime(DateTime.Now) %></CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content>回復1 聯系方式 
 回復2 在線咨詢</Content>
</xml>

框架基類 Bee.WeiXin.Controller.WeiXinControllerBase提供了微信公眾平台API所對應的三種響應的ActionResult, 具體請查看源碼.

總結

着重解釋了調用鏈的方式。 其他的功能就不說明了, 下載源碼, 很容易知道他的用途。 Enjoy!


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM