Bee.WeiXin WeChat フレームワークの使用に関するチュートリアル

Bee.WeiXin を通じて WeChat パブリック プラットフォームを開発する方法を見てみましょう。 WeChat パブリック プラットフォームの一般的な導入については、ここでは詳しく説明しません。 庭で探してみてください。 この記事では主に Bee.WeXin について紹介します。コードは beeweixin.codeplex.com/ に公開されています。

BeeWeiXin は、Tencent の WeChat パブリック プラットフォームの開発フレームワークです。このプロジェクトは、Bee OPOA プラットフォームに基づいて開発されています。

には次の機能が含まれています:

1. コール ツリーに基づく WeChat 応答モデル 。 コール ツリーは、マルチレベル (コンテキスト付き) 応答をサポートし、テキスト、グラフィックス、カスタムの 3 つの方法で応答できます。 このうち、WeChatパブリックプラットフォームAPIが提供する3つのメソッド(テキスト、グラフィック、音楽)をカスタマイズできます。

2. WeChatフォローユーザーリストを同期する機能を提供します。

3. メニュー管理機能を提供します。

4. 画像とテキストの管理機能を提供します。

5. Bee OPOA プラットフォーム上のすべての機能 (主に

権限管理) をネイティブに統合します。

デバッグ

については、Garden friends WeChatパブリックアカウント開発およびデバッグツールリリースが提供するツールを使用することをお勧めしますプレビュー

設定項目の説明

設定項目はすべてWebの[appSettings]で設定されます.config.

【 WeiXinToken 】は、パブリック プラットフォーム API トークンです。

[Debug] は、現在デバッグ モードであるかどうかを示します。 デバッグ モードと非デバッグ モードの違いは、開始された呼び出しが検証されるかどうかです。

[WeiXinUserName]と[WeiXinPassword]は、[WeChatフォローユーザー]メニューの[すべてのユーザーを再同期]に必要です。模擬WebページでWeChatパブリックプラットフォームにログインし、ユーザーリスト情報を取得します。 必要ない場合は、無視するか、このメニューを非表示にすることができます。

WeChat公開アカウントのメニューを管理できるメニュー[WeChatメニュー管理]には[WeiXinAppId]と[WeiXinAppSec]が必要です。 もちろん、このツール [WeChat パブリック アカウント開発およびデバッグ ツール リリース] にもこの機能があり、より便利です。 必要ない場合は、無視するか、このメニューを非表示にすることができます。

[WeiXinController] はデフォルトのシステム応答コントローラーです。具体的なロジックについてはコードを参照してください。

コールチェーンメソッドのレスポンス

コールチェーンはコンテキストに基づきます。設定項目に[コールチェーンに入るかどうか]のオプションがあります。その場合、このレスポンスはコールチェーンに追加されます。コンテクスト。 たとえば、[メニュー 1] は呼び出しチェーンに入る必要があります。そうしないと、この項目の下のサブ項目は応答しません。

まず次の画像をご覧ください:

プレビュー画像から、コール チェーンがテキスト、グラフィック、カスタマイズの 3 種類の応答を提供できることが直感的に理解できます。

テキストは一般的なテキスト応答です。 たとえば、[Menu 1] はテキストで応答するように Bee.WeiXinDemo プロジェクトで構成されており、ノード値は V1001_M1_1 です。

回复1，test1
回复2，test2
回复3，test3

返信は次のとおりです:

画像とテキストは、WeChatパブリックプラットフォームAPIで提供される

画像とテキスト情報

であり、コールチェーン設定で、指定された記事番号を[これ]の順序で入力するだけです。番号は WeChat 記事管理 ID] にあります (カンマ区切り)。 例えば、[メニュー1]のtest2はグラフィックとテキスト形式です。 test2 に入るには、以下に示すように、まずメニュー 1 をトリガーし、次に test2 をトリガーする必要があります:

カスタマイズは Bee OPOA Platform フレームワーク

MVC

に統合されています。 したがって、設定はコントローラーアクションを通じても実装されます。 例えば、[メニュー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, 具体请查看源码.

【相关推荐】

1. 微信公众号平台源码下载

2. 微智创T+微信机器人源码

以上がBee.WeiXin WeChat フレームワークの使用に関するチュートリアルの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。