我們來看一下如何通過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!