Force.com除了簡單的文字訊息回覆外，還能回覆圖文並茂的訊息、能回覆音樂或影片、能辨識使用者傳來的語音、能夠蒐集使用者的地理位置資訊並提供對應的內容或服務等，本文將對這些技能一一展開說明，在此之前首先要介紹如何申請一個具有所有服務號接口功能的測試帳號（儘管對於圖文訊息回復這並不是必須的）。

?

申請測試帳號

作為開發(fā)者個人能夠申請的是訂閱號，訂閱號僅僅開放了基礎接口，包含接收用戶訊息、向用戶回覆訊息以及接受事件（事件推送有關注或取消關注、掃描帶參數(shù)二維碼（產(chǎn)生此類二維碼需要高級介面）、上報地理位置（普通訂閱號不支援）、自訂選單（普通訂閱號不支持）點擊）推送三種接口，但高級點的功能如自定義菜單、語音識別、客服接口、OAuth2.0網(wǎng)頁授權、獲取用戶地理位置信息等等均需要服務號才支持，其中認證了的訂閱號支援自訂選單。為了方便開發(fā)人員了解和學習騰訊公司的這些接口，如任何平臺公司那樣，騰訊公司去年晚點的時候終於開放了測試帳號的申請。只要有微信訂閱號碼的用戶都可以申請（服務號碼應該也可以吧，不過沒看過服務號碼後臺長啥樣，不做評論）。

申請方式簡單、直接，進入到微信後臺（https://mp.weixin.qq.com）後在最新版（截止2014年7月6日）的後臺左側最下面有一個「開發(fā)者中心」的鏈接，點擊後能找到一個「接口測試申請系統(tǒng)點擊進入」的鏈接，點擊進入後按照騰訊公司的想到申請即可，這裡不做贅述。

?

?

#申請成功登陸後的樣子如下，這裡你就能看到，滾動頁面還能看到一個二維碼，透過微信掃描這個二維碼既可以關注這個測試帳號，最多支持20個測試用戶，關注成功後在微信“訂閱號”文件夾裡會多出一個叫做“微信公眾平臺測試號”的帳號，注意雖然是在「訂閱號碼」資料夾，但是具有所有服務號碼的功能：

?????????

?

基礎架構建立

##為基礎架構建立

#?

基礎架構建立

?

為了接下來的工作，這裡我們先建立幾個關鍵的類別以及對應的處理框架，以便後續(xù)增加更多功能支援。

IncomingMsg：使用者傳送來的訊息類，包含了各個關鍵字段資訊；

WeChatNews: 回覆圖文並茂新聞時的新聞類；

IncomingMsg類程式碼如下， 12個字段，包含了各種訊息類型的絕大部分字段資訊：

public?class?IncomingMsg{
????public?String?toUserName;
????public?String?fromUserName;
????public?String?msgType;
????public?String?picURL;
????public?String?mediaID;
????public?String?locationX;
????public?String?locationY;
????public?String?URL;
????public?String?content;
????public?String?event;
????public?String?eventKey;
????public?String?recognition;
????
????public?IncomingMsg(){}
????
????public?IncomingMsg(String?tUN,?String?fUN,?String?mT,?String?pU,?String?mI,?String?lX,?String?lY,?String?u,?String?c,?String?e,?String?eK,?String?r){
????????this.toUserName?=?tUN;
????????this.fromUserName?=?fUN;
????????this.msgType?=?mT;
????????this.picURL?=?pU;
????????this.mediaID?=?mI;
????????this.locationX?=?lX;
????????this.locationY?=?lY;
????????this.URL?=?u;
????????this.content?=?c;
????????this.event?=?e;
????????this.eventKey?=?eK;
????????this.recognition?=?r;
????}
}

WeChatNews類的定義代碼如下，包含了一則新聞的詳細定義資訊：

public?class?WeChatNews{
????public?String?title;
????public?String?description;
????public?String?picUrl;
????public?String?url;
????
????public?WeChatNews(){}
????
????public?WeChatNews(String?t,?String?d,?String?p,?String?u){
????????this.title?=?t;
????????this.description?=?d;
????????this.picUrl?=?p;
????????this.url?=?u;
????}
}

接下來，在doPost方法裡，我們將晚上上篇博文裡的XML解析程式碼，使其能夠解析任何類型的微信XML文，修改後的doPost方法如下：

global?static?void?doPost(){
????????//Receive?message?from?user;
????????RestRequest?req?=?RestContext.request;
????????RestResponse?res?=?RestContext.response;
????????string?strMsg?=?req.requestBody.toString();??
????????System.debug('Request?Contents'?+?strMsg);
????????XmlStreamReader?reader?=?new?XmlStreamReader(strMsg);
????????String?toUserName?=?'';
????????String?fromUserName?=?'';
????????String?msgType?=?'';
????????String?picURL?=?'';
????????String?mediaID?=?'';
????????String?locationX?=?'';
????????String?locationY?=?'';
????????String?URL?=?'';
????????String?content?=?'';
????????String?msgID?=?'';
????????String?event?=?'';
????????String?eventKey?=?'';
????????String?recognition?=?'';
????????
????????while(reader.hasNext()){
????????????if(reader.getLocalName()?==?'ToUserName'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????toUserName?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'FromUserName'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????fromUserName?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'MsgType'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????msgType?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'PicURL'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????picURL?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'MediaId'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????mediaID?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'Location_X'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????locationX?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'Location_Y'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????locationY?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'Url'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????URL?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'MsgId'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????msgID?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'Content'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????content?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'Event'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????event?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'EventKey'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????eventKey?=?reader.getText();
????????????????}
????????????}
????????????else?if(reader.getLocalName()?==?'Recognition'){
????????????????reader.next();
????????????????if(String.isNotBlank(reader.getText())){
????????????????????recognition?=?reader.getText();
????????????????}
????????????}
????????????reader.next();
????????}
????????IncomingMsg?inMsg?=?new?IncomingMsg(toUserName,?fromUserName,?msgType,?picURL,?mediaID,?locationX,?locationY,?URL,?content,?event,?eventKey,?recognition?);
}

?該方法裡，我們對所有類型微信訊息XML文裡的字段進行了解析，並透過解析回來的值初始化了IncomingMsg對象，接下來，我們將透過傳遞這個對象呼叫不同的方法完成各種任務。接下來我們在上述doPost方法的最後加上以下程式碼：

String?rtnMsg?=?'';
//回復消息

if(msgType.equals('text')){
???rtnMsg?=?handleText(inMsg);
}
RestContext.response.addHeader('Content-Type',?'text/plain');????
RestContext.response.responseBody?=?Blob.valueOf(rtnMsg);

#?

這段程式碼裡首先定義了一個儲存回傳XML文的String字串，接著判斷如果用戶發(fā)來的消息類型是文本類型，則調用一個handleText的方法來處理回復信息，這裡傳遞給handleText方法的對象正是我們前面定義的IncomingMsg對象，關於該方法的細節(jié)我們下一小節(jié)再介紹，這裡成功拿到方法的回傳字串後，透過RestContext即可將XML文訊息傳回騰訊微信，進一步傳回給發(fā)送訊息的使用者。

?

傳送圖文方法handleText詳解

?

###接下來我們將介紹如何回覆圖文訊息。留意，圖文訊息回覆並不需要申請測試帳號，一般訂閱號即可。以下是該方法的全部程式碼：###

private?static?String?handleText(IncomingMsg?msg){
????????String?keyword?=?msg.content;
????????String?strReply;
????????String?strResult;
????????if(keyword.equals('文本')){
????????????strReply?=?'這是個文本消息';
????????????strResult?=?composeTextReply(msg,?strReply);
????????}
????????else?if(keyword.equals('圖文')?||?keyword.equals('單圖文')){
????????????WeChatNews?news?=?new?WeChatNews('蘋果WWDC2014召開在即',?'2014?年似乎將成為又一個“蘋果之年”，熱愛和不那么熱愛蘋果的人都對它的一舉一動保持著關注和揣測——以下是蘋果?WWDC?2014?的13大看點：',?'http://a.36krcnd.com/photo/2014/4e3ae0dac4884bb91934a689b72f8f8b.png',?'http://www.36kr.com/p/212479.html');
????????????List<wechatnews>?newsList?=?new?List<wechatnews>();
????????????newsList.add(news);
????????????strResult?=?composeNewsReply(msg,?newsList);
????????}
????????else?if(keyword.equals('多圖文')){
????????????WeChatNews?news1?=?new?WeChatNews('蘋果WWDC2014召開在即',?'2014年似乎將成為又一個蘋果之年，熱愛和不那么熱愛蘋果的人都對它的一舉一動保持著關注和揣測——以下是蘋果?WWDC?2014?的13大看點：',?'http://a.36krcnd.com/photo/2014/4e3ae0dac4884bb91934a689b72f8f8b.png',?'http://www.36kr.com/p/212479.html');
????????????WeChatNews?news2?=?new?WeChatNews('Facebook?CEO?馬克·扎克伯格再做慈善，為灣區(qū)學校捐贈?1.2?億美元',?'據(jù)?re/code消息，F(xiàn)acebook?CEO?馬克·扎克伯格與妻子Priscilla?Cha?(中文名陳慧嫻)?計劃向灣區(qū)學校捐贈?1.2?億美元。',?'http://a.36krcnd.com/photo/2014/e64d647389bfda39131e12fa9d606bb6.jpg',?'http://www.36kr.com/p/212476.html');
????????????WeChatNews?news3?=?new?WeChatNews('Nokia收購Siri的同門師弟Desti，為自家地圖業(yè)務HERE融入更多人工智能',?'Nokia最近收購了一家地圖公司Desti，來補強自家的地圖業(yè)務HERE。',?'http://a.36krcnd.com/photo/2014/25490e2b8e63ced9586f0a432eebb972.jpg',?'http://www.36kr.com/p/212484.html');
????????????List<wechatnews>?newsList?=?new?List<wechatnews>();
????????????newsList.add(news1);
????????????newsList.add(news2);
????????????newsList.add(news3);
????????????strResult?=?composeNewsReply(msg,?newsList);
????????}
????????else?if(keyword.equals('音樂')){
????????????Map<string>?music?=?new?Map<string>();
????????????music.put('title',?'愛你的宿命');
????????????music.put('description',?'張信哲');
????????????music.put('musicUrl',?'http://zhangmenshiting.baidu.com/data2/music/119826740/1197655931401552061128.mp3?xcode=80587c819993d49621a8dce05e5bb8c9e36664380262dc7e&song_id=119765593');
????????????music.put('musicHQUrl',?'http://zhangmenshiting.baidu.com/data2/music/119826740/1197655931401552061128.mp3?xcode=80587c819993d49621a8dce05e5bb8c9e36664380262dc7e&song_id=119765593');
????????????strResult?=?composeMusicReply(msg,?music);????????????
????????}
????????return?strResult;
????}</string></string></wechatnews></wechatnews></wechatnews></wechatnews>

###?#######

代碼的思路應該來說比較直接，從第4行的if開始判斷用戶發(fā)送過來的文本是什么，根據(jù)不同的關鍵字來確定不同的返回內容，第一個if里將返回給用戶單圖文信息，這里先構造了一個WeChatNews數(shù)組，當然數(shù)組里只有一個WeChatNews對象，將這個數(shù)組交給composeNewsReply來完成最終的XML文構建；第一個else if也很類似，只不過這里的WeChatNews數(shù)組里有三條新聞，關于composeNewsReply方法的細節(jié)我們稍后介紹；最后一個else if里展示了如何回復音樂，這里我們構建了一個Map對象存儲音樂的詳情，并調用composeMusicReply方法來完成最終的XML文構建，同樣該方法的細節(jié)稍后就會介紹到。

上面的思路應該來說還是比較清楚的，接下來介紹composeNewsReply方法的全部代碼：

private?static?String?composeNewsReply(IncomingMsg?msg,?List<wechatnews>?newsList){
????????String?strNews?=?'';
????????String?newsTpl?=?'<item><title></title>
<description></description><picurl></picurl><url></url></item>';
????????for(WeChatNews?news?:?newsList){
????????????String[]?arguments?=?new?String[]{news.title,?news.description,?news.picUrl,?news.url};
????????????strNews?+=?String.format(newsTpl,?arguments);
????????}
????????String?strTmp?=?'<xml><tousername></tousername><fromusername></fromusername><createtime>1234567890</createtime><msgtype></msgtype><articlecount></articlecount><articles>'?+?strNews?+?'</articles></xml>';
????????String[]?arguments?=?new?String[]{msg.fromUserName,?msg.toUserName,?String.valueOf(newsList.size())};
????????String?results?=?String.format(strTmp,?arguments);
????????return?results;
}</wechatnews>

?

了解該方法代碼前先要了解回復圖文信息的XML格式，關于此點可以參照騰訊公司鏈接：回復圖文消息 ，與前文介紹到的普通文本消息大同小異，可以留意到里面有個ArticleCount字段用來指定回復的消息里能有幾條圖文新聞，最大是10，超過10則會無法響應；另外Article節(jié)點下方每一個item均是一條圖文消息。為此，上述代碼的第3行先構造一個每條新聞的模板，接著從第4行開始輪詢新聞列表里的每一條新聞，并構造相應的XML文。從第8行開始構造整個圖文回復的字符串模板，并在第9、10行通過相應參數(shù)將模板轉換為最終的XML字符串。

再接下來介紹composeMusicReply，該方法的全部代碼如下：

private?static?String?composeMusicReply(IncomingMsg?msg,?Map<string>?music){
????????String?strTitle?=?music.get('title');
????????String?strDesc?=?music.get('description');
????????String?strURL?=?music.get('musicUrl');
????????String?strHQURL?=?music.get('musicHQUrl');
????????String?musicTpl?=?'<xml><tousername></tousername><fromusername></fromusername><createtime>12345678</createtime><msgtype></msgtype><music><title></title>
<description></description><musicurl></musicurl><hqmusicurl></hqmusicurl></music></xml>';
????????String[]?arguments?=?new?String[]{msg.fromUserName,?msg.toUserName,?strTitle,?strDesc,?strURL,?strHQURL};
????????String?results?=?String.format(musicTpl,?arguments);
????????return?results;
}</string>

同樣了解該方法要首先了解回復音樂信息的XML格式，可以參照騰訊公司鏈接：回復音樂消息，上面代碼與前面方法比較類似，就不再贅述。（這里的Map對象也許有點多余，可以考慮是否可以和回復視頻的方法整合到一起，否則不需要額外的Map對象開銷，直接將標題、描述、鏈接等信息傳給composeMusicReply方法即可）。

運行效果

?

完成后直接保存代碼便可立即生效，回復圖文、多圖文、音樂的運行效果分別如下：

????????? ?????????

更多Force.com微信開發(fā)系列申請測試帳號及回覆圖文訊息相關文章請關注PHP中文網(wǎng)！

?