微信公眾平台API測試——接收語音消息

一、簡介

     當普通微信用戶向公眾賬號發消息時，微信服務器將用戶發送的消息封裝成XML數據包，通過POST消息發送到開發者的URL上。

     微信服務器在五秒內收不到服務器的響應會斷掉連接，並且重新發起請求，總共重試三次。關於重試的消息排重，推薦使用msgid排重。

     假如服務器無法保證在五秒內處理並回復，可以直接回復空串，微信服務器不會對此作任何處理，並且不會發起重試。

當前支持如下的普通消息：

• 1 文本消息
• 2 圖片消息
• 3 語音消息
• 4 視頻消息
• 5 地理位置消息
• 6 鏈接消息

二、適用場景

    普通微信用戶通過微信給公眾賬號發送的語音，微信服務器即封裝為此語音消息格式發送到開發者URL。服務器接收到此消息后，可以通過解析到的MediaId調用多媒體文件下載接口獲取語音數據，根據解析到的語音文件格式可以對語音進行相應處理。

 

三、消息格式說明

<xml>
<ToUserName><![CDATA[toUser]]></ToUserName>
<FromUserName><![CDATA[fromUser]]></FromUserName>
<CreateTime>1357290913</CreateTime>
<MsgType><![CDATA[voice]]></MsgType>
<MediaId><![CDATA[media_id]]></MediaId>
<Format><![CDATA[Format]]></Format>
<MsgId>1234567890123456</MsgId>
</xml>

參數	描述
ToUserName	開發者微信號
FromUserName	發送方帳號（一個OpenID）
CreateTime	消息創建時間 （整型）
MsgType	語音為voice
MediaId	語音消息媒體id，可以調用多媒體文件下載接口拉取數據。
Format	語音格式，如amr，speex等
MsgID	消息id，64位整型

 四、代碼示例

<?php
/**
  * wechat php test
  */

//define your token
define("TOKEN", "weixin");
$wechatObj = new wechatCallbackapiTest();
$wechatObj->responseMsg();

class wechatCallbackapiTest
{
    public function responseMsg()
    {
        //get post data, May be due to the different environments
        $postStr = $GLOBALS["HTTP_RAW_POST_DATA"];

        if (!empty($postStr)){
                $postObj = simplexml_load_string($postStr, 'SimpleXMLElement', LIBXML_NOCDATA);
                $MSG_TYPE = trim($postObj->MsgType);
                
                switch ($MSG_TYPE) {
                    case "text":
                        $resultStr = $this->handleText($postObj);
                        break;
                    case "image":
                        $resultStr = $this->handleImage($postObj);
                        break;
                    case "voice":
                        $resultStr = $this->handleVoice($postObj);
                        break;                        
                    default:
                        $resultStr = "Unknow message type: " . $MSG_TYPE;
                        break;
                }
                //echo $postStr;
                echo $resultStr;
        }else {
            echo "";
            exit;
        }
    }
   
    private function handleVoice($postObj)
    {
        //獲取語音消息媒體id，可以調用多媒體文件下載接口拉取數據
        $mediaID = trim($postObj->MediaId);
        $format = trim($postObj->Format);
        
        if(!empty($mediaID)){
            $contentStr = "MediaId : " . $mediaID ."\n" . "Format : " . $format . "\n";
            $resultStr = $this->responseText($postObj, $contentStr);            
        }else{
            $resultStr = "MediaId is empty.";    
        }
        
        return $resultStr;        
    }
    
    
    private function responseText($object, $content, $flag=0)
    {
        $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;
    }     

}

?>