1. はじめに

WeChat パブリック プラットフォームでは、テキスト返信、音楽返信、畫像とテキスト返信の 3 つのメッセージ返信形式を提供します。この記事では、これら 3 種類のメッセージに返信します。形式を定義し、それを読者が使用できる関數(shù)にカプセル化します。

2. アイデア分析

各 POST リクエストに対して、開発者はメッセージに応答するために応答パッケージ內(nèi)の特定の XML 構造を返します (応答テキスト、グラフィックス、音聲、ビデオ、音楽をサポートするようになりました)。

3. テキスト返信

3.1 テキスト返信の XML 構造

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[text]]></MsgType>
 <Content><![CDATA[content]]></Content>
 </xml>

3.2 構造の説明

3.3 特定の実裝

上記の XML 構造については、対応する必要があるだけですただ埋めるだけコンテンツの位置と出力の形式を設定します。

説明:

ToUserName には、$fromUsername = $postObj->FromUserName が入力されます。これは、メッセージを送信したユーザー、つまり受信者のアカウントにメッセージを返します。

FromUserName には、開発者の WeChat アカウントである $toUsername = $postObj->ToUserName が入力されます。

これは、「wechat 世界へようこそ!」メッセージに返信するための、responseMsg() メソッドをインスタンス化するだけです。

ここでは、読者が上記の手順を理解しやすいように、少し変更を加えて fromUsername メッセージと toUsername メッセージを返します。

3.4 テスト結果

3.5 呼び出し可能な関數(shù)にカプセル化

上記のコンテンツを関數(shù)にカプセル化し、返信テキストが必要な場所で直接呼び出すことができます。これは便利で簡潔です、responseText.func .incのphpコードは以下の通りです。

function _response_text($object,$content){
    $textTpl = "<xml>
                <ToUserName><![CDATA[%s]]></ToUserName>
                <FromUserName><![CDATA[%s]]></FromUserName>
                <CreateTime>%s</CreateTime>
                <MsgType><![CDATA[text]]></MsgType>
                <Content><![CDATA[%s]]></Content>
                <FuncFlag>%d</FuncFlag>
                </xml>";
    $resultStr = sprintf($textTpl, $object->FromUserName, $object->ToUserName, time(), $content, $flag);
    return $resultStr;
}

このように、$object と $content を渡して、テキストに返信する必要があるファイルをファイルに導入し、_response_text() メソッドを呼び出すだけで、テキストに直接返信できます。

3.6 テストコード

3.6.1 メインファイルに返信文の関數(shù)ファイルを?qū)?/p>

require_once 'responseText.func.inc.php';

3.6.2 通常のメッセージ返信

public function handleText($postObj)
    {
        $keyword = trim($postObj->Content);

        if(!empty( $keyword ))
        {
            $contentStr = "微信公眾平臺-文本回復功能源代碼";
            //$resultStr = sprintf($textTpl, $fromUsername, $toUsername, $time, $msgType, $contentStr);
            $resultStr = _response_text($postObj,$contentStr);
            echo $resultStr;
        }else{
            echo "Input something...";
        }
}

3.6.3 フォロー時の返信

public function handleEvent($object)
    {
        $contentStr = "";
        switch ($object->Event)
        {
            case "subscribe":
                $contentStr = "感謝您關注【卓錦蘇州】"."\n"."微信號：zhuojinsz";
                break;
            default :
                $contentStr = "Unknow Event: ".$object->Event;
                break;
        }
        $resultStr = _response_text($object, $contentStr);
        return $resultStr;
}

3.7 テスト結果

テキストに正常に返信しました。

4. グラフィック返信

4.1 グラフィック返信xml構造

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[news]]></MsgType>
 <ArticleCount>2</ArticleCount>
 <Articles>
 <item>
 <Title><![CDATA[title1]]></Title> 
 <Description><![CDATA[description1]]></Description>
 <PicUrl><![CDATA[picurl]]></PicUrl>
 <Url><![CDATA[url]]></Url>
 </item>
 <item>
 <Title><![CDATA[title]]></Title>
 <Description><![CDATA[description]]></Description>
 <PicUrl><![CDATA[picurl]]></PicUrl>
 <Url><![CDATA[url]]></Url>
 </item>
 </Articles>
 </xml>

4.2 構造説明

テキスト返信フォーマットと同様に、対応する位置に対応する內(nèi)容を記入するだけです。テキストメッセージに返信します。

4.3 具體的な実裝

グラフィック返信は単一のグラフィックまたはテキストにすることも、複數(shù)のグラフィックとテキストにすることもできます。ここでは、最初に単一のグラフィックとテキストの場合を使用して読者をガイドし、次に複數(shù)のグラフィックとテキストを紹介します。

畫像とテキストの返信の XML 構造を、畫像とテキストのヘッダー、畫像とテキストの本文、畫像とテキストの末尾の 3 つの構造に分解します。畫像とテキストの本文は、タイトル、説明、畫像です。畫像やテキストに返信するときに表示される URL と元のテキスト URL。

$newsTplHead = "<xml>
                <ToUserName><![CDATA[%s]]></ToUserName>
                <FromUserName><![CDATA[%s]]></FromUserName>
                <CreateTime>%s</CreateTime>
                <MsgType><![CDATA[news]]></MsgType>
                <ArticleCount>1</ArticleCount>
                <Articles>";
$newsTplBody = "<item>
                <Title><![CDATA[%s]]></Title> 
                <Description><![CDATA[%s]]></Description>
                <PicUrl><![CDATA[%s]]></PicUrl>
                <Url><![CDATA[%s]]></Url>
                </item>";
$newsTplFoot = "</Articles>
                <FuncFlag>0</FuncFlag>
                </xml>";

次に、対応するコンテンツを 3 つの構造に挿入します:

A. $newsTplHead

$header = sprintf($newsTplHead, $object->FromUserName, $object->ToUserName, time());

B。 説明:
$newsContent は、メインファイル配列。

C. $newsTplFoot

$title = $newsContent['title'];
$desc = $newsContent['description'];
$picUrl = $newsContent['picUrl'];
$url = $newsContent['url'];
$body = sprintf($newsTplBody, $title, $desc, $picUrl, $url);

その後、3 つの段落をつなぎ合わせて 1 つの畫像とテキストに返信できます。

$FuncFlag = 0;
$footer = sprintf($newsTplFoot, $FuncFlag);

上記の內(nèi)容を関數(shù)に書き込み、次の呼び出しテスト用に _response_news() 関數(shù)という名前を付けます。

4.4 テストコード

4.4.1 メインファイルに畫像やテキストに返信する関數(shù)ファイルを?qū)?/p>

return $header.$body.$footer;

4.4.2 配列を作成して渡す

メインファイルには関數(shù)を追加するだけファイルを _response_news() に渡すには、配列と $postObj を渡すだけです。

$record=array(
'title' =>'山塘街',
'description' =>'山塘街東起閶門渡僧橋，西至蘇州名勝虎丘山的望山橋，長約七里，所以蘇州俗語說“七里山塘到虎丘”...',
'picUrl' => 'http://thinkshare.duapp.com/images/suzhou.jpg',
'url' =>'http://mp.weixin.qq.com/mp/appmsg/show?__biz=MjM5NDM0NTEyMg==&appmsgid=10000046&itemidx=1&sign=9e7707d5615907d483df33ee449b378d#wechat_redirect'
);

$resultStr = _response_news($postObj,$record);
echo $resultStr;

4.5 測試結果

點擊進入查看

單圖文回復測試成功。

4.6 多圖文回復

有了上面的引導，讀者應該能夠想到回復多圖文的思路了，就是將多維數(shù)組中的值循環(huán)放到相應的位置，然后拼接起來就可以了，下面進行講解。

4.6.1 獲取圖文條數(shù)

$bodyCount = count($newsContent);

4.6.2 判斷圖文條數(shù)

因為微信限制了回復的圖文消息數(shù)為10條以內(nèi)，所以需要判斷圖文條數(shù)，如果小于10條，則圖文數(shù)等于原來的圖文數(shù)，如果大于等于10條，則強制限制為10條。

$bodyCount = $bodyCount < 10 ? $bodyCount : 10;

4.6.3 組織圖文體

圖文頭和圖文尾和上面單圖文一樣，不再贅述，主要是圖文體的組織。

用foreach 循環(huán)出數(shù)組的內(nèi)容并賦予圖文體，并進行拼接：

foreach($newsContent as $key => $value){
    $body .= sprintf($newsTplBody, $value['title'], $value['description'], $value['picUrl'], $value['url']);
}

說明：$newsContent 是從主文件傳入函數(shù)的圖文數(shù)組。

4.6.4 拼接并返回

return $header.$body.$footer;

將以上內(nèi)容寫到一個函數(shù)里，命名為 _response_multiNews() 函數(shù)，以供下面調(diào)用測試。

4.7 測試多圖文

4.7.1 在主文件中引入回復多圖文的函數(shù)文件

require_once 'responseMultiNews.func.inc.php';

4.7.2 創(chuàng)建多維數(shù)組并傳入

$record[0]=array(
    'title' =>'觀前街',
    'description' =>'觀前街位于江蘇蘇州市區(qū)，是成街于清朝時期的百年商業(yè)老街，街上老店名店云集，名聲遠播海內(nèi)外...',
    'picUrl' => 'http://joythink.duapp.com/images/suzhou.jpg',
    'url' =>'http://mp.weixin.qq.com/mp/appmsg/show?__biz=MjM5NDM0NTEyMg==&appmsgid=10000052&itemidx=1&sign=90518631fd3e85dd1fde7f77c04e44d5#wechat_redirect'
);
......
$record[11]=array(
    'title' =>'平江路',
    'description' =>'平江路位于蘇州古城東北，是一條傍河的小路，北接拙政園，南眺雙塔，全長1606米，是蘇州一條歷史攸久的經(jīng)典水巷。宋元時候蘇州又名平江，以此名路...',
    'picUrl' => 'http://joythink.duapp.com/images/suzhouScenic/pingjianglu.jpg',
    'url' =>'http://mp.weixin.qq.com/mp/appmsg/show?__biz=MjM5NDM0NTEyMg==&appmsgid=10000056&itemidx=1&sign=ef18a26ce78c247f3071fb553484d97a#wechat_redirect'
);
$resultStr = _response_multiNews($postObj,$record);
echo $resultStr;

4.8 測試多圖文結果

點擊進入查看

測試多圖文成功。

五、音樂回復

微信還提供了一種消息回復的格式，即音樂回復，下面我們編寫程序測試一下。

注意：由于音樂版權的問題，現(xiàn)在很少有回復音樂的API，開放的API 查詢出來的音樂信息也有很多是不正確的。所以在這里，我們上傳幾首音樂到自己的服務器空間測試。

本地文件：

測試是否能夠正常播放：

5.1 音樂回復xml 結構

 <xml>
 <ToUserName><![CDATA[toUser]]></ToUserName>
 <FromUserName><![CDATA[fromUser]]></FromUserName>
 <CreateTime>12345678</CreateTime>
 <MsgType><![CDATA[music]]></MsgType>
 <Music>
 <Title><![CDATA[TITLE]]></Title>
 <Description><![CDATA[DESCRIPTION]]></Description>
 <MusicUrl><![CDATA[MUSIC_Url]]></MusicUrl>
 <HQMusicUrl><![CDATA[HQ_MUSIC_Url]]></HQMusicUrl>
 </Music>
 </xml>

5.2 結構說明

5.3 具體實施

我們先做一個固定的歌曲回復來引導讀者，然后再引出更高級別的歌曲查詢回復。

5.3.1 在xml 結構的相應位置插入相應數(shù)據(jù)

<Music>
<Title><![CDATA[Far Away From Home]]></Title>
<Description><![CDATA[Groove Coverage]]></Description>
<MusicUrl><![CDATA[http://thinkshare.duapp.com/music/10001.mp3]]></MusicUrl>
<HQMusicUrl><![CDATA[http://thinkshare.duapp.com/music/10001.mp3]]></HQMusicUrl>
</Music>

5.3.2 測試代碼

$resultStr = _response_music($postObj,$keyword);echo $resultStr;

5.3.3 測試結果

5.4 模擬點歌

有了上面的簡單案例引導，讀者應該可以想到模擬點歌的具體實現(xiàn)了吧，下面就來簡單介紹一下。

思路：將歌曲代碼和對應的歌曲名存入數(shù)據(jù)庫，用戶輸入歌曲名，在數(shù)據(jù)庫中找到歌曲名對應的歌曲編號，然后就可以生成MusicUrl 回復用戶了。

5.4.1 創(chuàng)建數(shù)據(jù)庫

建表語句及數(shù)據(jù)文件：

CREATE TABLE IF NOT EXISTS `tbl_music` (
  `music_id` int(11) NOT NULL,
  `music_name` varchar(40) NOT NULL,
  `music_singer` varchar(40) NOT NULL,
  `music_lrc` text NOT NULL,  PRIMARY KEY (`music_id`)
) ENGINE=MyISAM DEFAULT CHARSET=utf8;INSERT INTO `tbl_music` (`music_id`, `music_name`, `music_singer`, `music_lrc`) VALUES(10001, 'Far Away From Home', 'Groove Coverage', 'far away from home'),
(10002, 'The Dawn', 'Dreamtale', 'the dawn'),
(20002, '董小姐', '宋冬野', '董小姐'),
(20001, '左邊', '楊丞琳', '左邊');

5.4.2 _response_music() 函數(shù)編寫

A. 引入數(shù)據(jù)庫操作文件

require_once('mysql_bae.func.php');

B. 數(shù)據(jù)庫操作及數(shù)據(jù)處理

$query = "SELECT * FROM tbl_music WHERE music_name LIKE '%$musicKeyword%'";
$result = _select_data($query);
$rows = mysql_fetch_array($result, MYSQL_ASSOC);
$music_id = $rows[music_id];

注： $musicKeyword 為從主文件傳入的歌曲名關鍵字，這里使用模糊查詢，只取第一條數(shù)據(jù)。

C. 判斷是否查詢到

if($music_id <> &#39;&#39;)
{
    $music_name = $rows[music_name];
    $music_singer = $rows[music_singer];
    $musicUrl = "http://thinkshare.duapp.com/music/".$music_id.".mp3";
    $HQmusicUrl = "http://thinkshare.duapp.com/music/".$music_id.".mp3";

    $resultStr = sprintf($musicTpl, $object->FromUserName, $object->ToUserName, time(), $music_name, $music_singer, $musicUrl, $HQmusicUrl);
    return $resultStr;
}else{
    return "";    
}

說明：如果查詢到歌曲信息，按照xml 結構返回數(shù)據(jù)；如果未查詢到，則返回空，用于主文件判斷。

將以上代碼封裝成 _response_music() 函數(shù)并保存為responseMusic.func.inc.php 文件供主文件調(diào)用。

5.4.3 測試代碼

A. 引入回復音樂和回復文本的函數(shù)文件

//引入回復音樂的函數(shù)文件require_once 'responseMusic.func.inc.php';//引入回復文本的函數(shù)文件require_once 'responseText.func.inc.php';

B. 調(diào)用

if(!empty( $keyword ))
{
    $resultStr = _response_music($postObj,$keyword);
    if($resultStr <> &#39;&#39;)
    {
        echo $resultStr;
    }else
    {
        echo _response_text($postObj,"未查詢到【".$keyword."】的歌曲信息！");    
    }
    
}

說明：如果查詢到歌曲信息，則返回所得信息，如果未查詢到，則調(diào)用 _response_text() 函數(shù)返回文本信息。

5.5 模擬點歌測試

回復音樂測試成功。?

更多WeChatパブリックプラットフォーム開発メッセージ返信の概要と紹介相關文章請關注PHP中文網(wǎng)！

?