C#開發微信門戶及應用(15)-微信菜單增加掃一掃、發圖片、發地理位置功能


前面介紹了很多篇關於使用C#開發微信門戶及應用的文章,基本上把當時微信能做的接口都封裝差不多了,微信框架也積累了不少模塊和用戶,最近發現微信公眾平台增加了不少內容,特別是在自定義菜單里面增加了掃一掃、發圖片、發地理位置功能,這幾個功能模塊很重要,想想以前想在微信公眾號里面增加一個掃描二維碼的功能,都做不了,現在可以了,還可以拍照上傳等功能,本文主要介紹基於我前面的框架系列文章,進一步介紹如何集成和使用這些新增功能。

1、微信幾個功能的官方介紹

1). 掃碼推送事件

用戶點擊按鈕后,微信客戶端將調起掃一掃工具,完成掃碼操作后顯示掃描結果(如果是URL,將進入URL),且會將掃碼的結果傳給開發者,開發者可以下發消息。

2). 掃碼推送事件,且彈出“消息接收中”提示框

用戶點擊按鈕后,微信客戶端將調起掃一掃工具,完成掃碼操作后,將掃碼的結果傳給開發者,同時收起掃一掃工具,然后彈出“消息接收中”提示框,隨后可能會收到開發者下發的消息。

3). 彈出系統拍照發圖

用戶點擊按鈕后,微信客戶端將調起系統相機,完成拍照操作后,將拍攝的相片發送給開發者,並推送事件給開發者,同時收起系統相機,隨后可能會收到開發者下發的消息。

4). 彈出拍照或者相冊發圖

用戶點擊按鈕后,微信客戶端將彈出選擇器供用戶選擇“拍照”或者“從手機相冊選擇”。用戶選擇后即走其他兩種流程。

5). 彈出微信相冊發圖器

用戶點擊按鈕后,微信客戶端將調起微信相冊,完成選擇操作后,將選擇的相片發送給開發者的服務器,並推送事件給開發者,同時收起相冊,隨后可能會收到開發者下發的消息。

6). 彈出地理位置選擇器

用戶點擊按鈕后,微信客戶端將調起地理位置選擇工具,完成選擇操作后,將選擇的地理位置發送給開發者的服務器,同時收起位置選擇工具,隨后可能會收到開發者下發的消息。
但請注意,以上新增能力,均僅支持微信iPhone5.4.1以上版本,和Android5.4以上版本的微信用戶,舊版本微信用戶點擊后將沒有回應,開發者也不能正常接收到事件推送。

 

2、微信新菜單功能的測試公眾號

微信不僅增加了這些功能模塊的支持,還考慮到我們開發人員的方便,增加了一個叫做“menutest"的公眾號,方便我們測試。我們在公眾號搜索“menutest",然后關注它即可進行測試幾個新增功能了。

“menutest"的公眾號名稱是”自定義菜單拓展測試“,我關注它並進行了測試,二維碼、圖片、地理位置都很OK,本身能夠響應這些事件,並且圖片、地理位置自身還能出現一個對應的事件,如下所示。

圖片發送可以分為拍照、拍照和相冊、微信相冊三類,感覺后面兩個有點類似,但有這些功能都很不錯的。

       

3、改進菜單對象和提交菜單

前面說了,微信提供這些功能,可以在菜單里面進行集成,也就是菜單的類型由原來CLICK/VIEW兩種,變為現在8種類型,增加2個掃碼操作、3種圖片操作、1種地理位置操作。

因此把菜單的枚舉類型擴展一下,如下所示。

    /// <summary>
    /// 菜單按鈕類型
    /// </summary>
    public enum ButtonType
    {
        /// <summary>
        /// 點擊
        /// </summary>
        click,

        /// <summary>
        /// Url
        /// </summary>
        view,

        /// <summary>
        /// 掃碼推事件的事件推送
        /// </summary>
        scancode_push,

        /// <summary>
        /// 掃碼推事件且彈出“消息接收中”提示框的事件推送
        /// </summary>
        scancode_waitmsg,

        /// <summary>
        /// 彈出系統拍照發圖的事件推送
        /// </summary>
        pic_sysphoto,

        /// <summary>
        /// 彈出拍照或者相冊發圖的事件推送
        /// </summary>
        pic_photo_or_album,

        /// <summary>
        /// 彈出微信相冊發圖器的事件推送
        /// </summary>
        pic_weixin,

        /// <summary>
        /// 彈出地理位置選擇器的事件推送
        /// </summary>
        location_select
    }

然后在Winform里面調用創建菜單操作代碼如下所示:

        private void btnCreateMenu_Click(object sender, EventArgs e)
        {
            MenuJson productInfo = new MenuJson("新功能測試", new MenuJson[] { 
                new MenuJson("掃碼推事件", ButtonType.scancode_push, "scancode_push") 
                ,new MenuJson("系統拍照發圖", ButtonType.pic_sysphoto, "pic_sysphoto") 
                , new MenuJson("拍照相冊發圖", ButtonType.pic_photo_or_album, "pic_photo_or_album") 
                , new MenuJson("微信相冊發圖", ButtonType.pic_weixin, "pic_weixin") 
                , new MenuJson("地理位置選擇", ButtonType.location_select, "location_select") 
            });                                    

            MenuJson frameworkInfo = new MenuJson("框架產品", new MenuJson[] { 
                new MenuJson("Win開發框架", ButtonType.click, "win"),
                new MenuJson("WCF開發框架", ButtonType.click, "wcf"),
                new MenuJson("混合式框架", ButtonType.click, "mix"), 
                new MenuJson("Web開發框架", ButtonType.click, "web")
                ,new MenuJson("代碼生成工具", ButtonType.click, "database2sharp")
            });

            MenuJson relatedInfo = new MenuJson("相關鏈接", new MenuJson[] { 
                new MenuJson("公司介紹", ButtonType.click, "event_company"),
                new MenuJson("官方網站", ButtonType.view, "http://www.iqidi.com"),
                new MenuJson("聯系我們", ButtonType.click, "event_contact"),
                new MenuJson("應答系統", ButtonType.click, "set-1"),
                new MenuJson("人工客服", ButtonType.click, "event_customservice")
            });

            MenuListJson menuJson = new MenuListJson();
            menuJson.button.AddRange(new MenuJson[] { productInfo, frameworkInfo, relatedInfo });

            if (MessageUtil.ShowYesNoAndWarning("您確認要創建菜單嗎") == System.Windows.Forms.DialogResult.Yes)
            {
                IMenuApi menuBLL = new MenuApi();
                CommonResult result = menuBLL.CreateMenu(token, menuJson);
                Console.WriteLine("創建菜單:" + (result.Success ? "成功" : "失敗:" + result.ErrorMessage));
            }
        }

當然,一般情況下我們都是在Web后台系統進行的,維護菜單都是在自己微信平台上進行菜單管理,然后一次性提交到微信服務器即可。

而在Web后台,只需要把數據庫的數據變化為Json數據提交即可,操作和上面的類似。

        /// <summary>
        ///更新微信菜單
        /// </summary>
        /// <returns></returns>
        public ActionResult UpdateWeixinMenu()
        {
            string token = base.GetAccessToken();
            MenuListJson menuJson = GetWeixinMenu();

            IMenuApi menuApi = new MenuApi();
            CommonResult result = menuApi.CreateMenu(token, menuJson);
            return ToJsonContent(result);
        }

4、微信掃一掃功能集成 

 前面講了,有了最新的功能,我們就可以實現掃一掃功能,從而可以掃描條形碼,二維碼的功能。有了條形碼、二維碼的快速和識別,我們就能開發一些如條碼查詢、商品處理等功能了。

這里我們介紹如何在我的微信開發框架里面整合這個掃一掃的功能處理操作。

前面已經增加了一些新功能的測試菜單,我們要做的就是響應這些事件處理,然后對他們進行應答處理就可以了。

下面是根據事件進行的一些API跳轉處理,我們同時定義了幾個相關的實體類用來處理他們的信息,如RequestEventScancodePush、RequestEventScancodeWaitmsg、RequestEventPicSysphoto等等。

RequestEventScancodeWaitmsg實體類的代碼如下所示,其他的類似處理。

    /// <summary>
    /// 掃碼推事件且彈出“消息接收中”提示框的事件推送
    /// </summary>
    [System.Xml.Serialization.XmlRoot(ElementName = "xml")]
    public class RequestEventScancodeWaitmsg : BaseEvent
    {
        public RequestEventScancodeWaitmsg()
        {
            this.MsgType = RequestMsgType.Event.ToString().ToLower();
            this.Event = RequestEvent.scancode_waitmsg.ToString();
            this.ScanCodeInfo = new ScanCodeInfo();
        }

        /// <summary>
        /// 事件KEY值,由開發者在創建菜單時設定
        /// </summary>
        public string EventKey { get; set; }

        /// <summary>
        /// 掃描信息
        /// </summary>
        public ScanCodeInfo ScanCodeInfo { get; set; }

    }
 

而根據實體類強類型的處理接口流轉操作如下所示。

                               case RequestEvent.scancode_push:
                                {
                                    //掃碼推事件的事件推送
                                    RequestEventScancodePush info = XmlConvertor.XmlToObject(postStr, typeof(RequestEventScancodePush)) as RequestEventScancodePush;
                                    if (info != null)
                                    {
                                        responseContent = actionBLL.HandleEventScancodePush(info);
                                    }
                                }
                                break;

                            case RequestEvent.scancode_waitmsg:
                                {
                                    //掃碼推事件且彈出“消息接收中”提示框的事件推送
                                    RequestEventScancodeWaitmsg info = XmlConvertor.XmlToObject(postStr, typeof(RequestEventScancodeWaitmsg)) as RequestEventScancodeWaitmsg;
                                    if (info != null)
                                    {
                                        responseContent = actionBLL.HandleEventScancodeWaitmsg(info);
                                    }
                                }
                                break;

                            case RequestEvent.pic_sysphoto:
                                {
                                    //彈出系統拍照發圖的事件推送
                                    RequestEventPicSysphoto info = XmlConvertor.XmlToObject(postStr, typeof(RequestEventPicSysphoto)) as RequestEventPicSysphoto;
                                    if (info != null)
                                    {
                                        responseContent = actionBLL.HandleEventPicSysphoto(info);
                                    }
                                }
                                break;
..................

處理掃描結果並返回的最終代碼如下所示。

        /// <summary>
        /// 掃碼推事件且彈出“消息接收中”提示框的事件推送的處理
        /// </summary>
        /// <param name="info">掃描信息</param>
        /// <returns></returns>
        public string HandleEventScancodeWaitmsg(RequestEventScancodeWaitmsg info)
        {
            ResponseText response = new ResponseText(info);
            response.Content = string.Format("您的信息為:{0},可以結合后台進行數據查詢。", info.ScanCodeInfo.ScanResult);
            return response.ToXml();
        }

最后我們測試掃描一個條形碼,可以看到返回的結果界面操作如下所示。

 

5、新菜單功能測試發現的問題

前面介紹了一些新菜單功能模塊的集成,我個人對這種掃一掃菜單功能非常贊賞,這也是微信逐步整合更多硬件資源和接口處理的趨向,不過在集成使用的時候,發現公眾號偶爾出現閃退的情況,還有就是這些新功能雖然后台能夠實現數據的處理和接收,但是有一些不能返回應答消息,很郁悶。也許隨着版本研發的加快,這些功能很快得到完善和解決。

另外微信開放平台也投入使用了,好些認證也是300元一年,不過暫時沒有其應用的場景,我只是用到了它來獲取微信賬號的unionid的功能,其他功能慢慢了解吧。

還有就是微信的企業號也已經出來了,而且我也已經申請認證通過,它的開發用戶的API也有不少,有空繼續研究並整合到微信開發框架里面吧。

 

如果對這個《C#開發微信門戶及應用》系列感興趣,可以關注我的其他文章,系列隨筆如下所示:

C#開發微信門戶及應用(25)-微信企業號的客戶端管理功能

C#開發微信門戶及應用(24)-微信小店貨架信息管理

C#開發微信門戶及應用(23)-微信小店商品管理接口的封裝和測試

C#開發微信門戶及應用(22)-微信小店的開發和使用

C#開發微信門戶及應用(21)-微信企業號的消息和事件的接收處理及解密 

C#開發微信門戶及應用(20)-微信企業號的菜單管理

C#開發微信門戶及應用(19)-微信企業號的消息發送(文本、圖片、文件、語音、視頻、圖文消息等)

C#開發微信門戶及應用(18)-微信企業號的通訊錄管理開發之成員管理

C#開發微信門戶及應用(17)-微信企業號的通訊錄管理開發之部門管理

C#開發微信門戶及應用(16)-微信企業號的配置和使用

C#開發微信門戶及應用(15)-微信菜單增加掃一掃、發圖片、發地理位置功能

 C#開發微信門戶及應用(14)-在微信菜單中采用重定向獲取用戶數據

C#開發微信門戶及應用(13)-使用地理位置擴展相關應用

C#開發微信門戶及應用(12)-使用語音處理

C#開發微信門戶及應用(11)--微信菜單的多種表現方式介紹

C#開發微信門戶及應用(10)--在管理系統中同步微信用戶分組信息

C#開發微信門戶及應用(9)-微信門戶菜單管理及提交到微信服務器

C#開發微信門戶及應用(8)-微信門戶應用管理系統功能介紹

C#開發微信門戶及應用(7)-微信多客服功能及開發集成

C#開發微信門戶及應用(6)--微信門戶菜單的管理操作

C#開發微信門戶及應用(5)--用戶分組信息管理

C#開發微信門戶及應用(4)--關注用戶列表及詳細信息管理

C#開發微信門戶及應用(3)--文本消息和圖文消息的應答

C#開發微信門戶及應用(2)--微信消息的處理和應答

C#開發微信門戶及應用(1)--開始使用微信接口

 


免責聲明!

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



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