CPSP接口開(kāi)發(fā)培訓(xùn)(共105張)

1、1n 規(guī)范概述規(guī)范概述n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n業(yè)務(wù)能力介紹業(yè)務(wù)能力介紹n業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n即綜合業(yè)務(wù)接入網(wǎng)關(guān)，將中國(guó)電信的網(wǎng)絡(luò)能力高度抽象，向提供標(biāo)即綜合業(yè)務(wù)接入網(wǎng)關(guān)，將中國(guó)電信的網(wǎng)絡(luò)能力高度抽象，向提供標(biāo)準(zhǔn)、統(tǒng)一的業(yè)務(wù)開(kāi)發(fā)接口，支持電信自營(yíng)增值業(yè)務(wù)、第三方

2、增值業(yè)準(zhǔn)、統(tǒng)一的業(yè)務(wù)開(kāi)發(fā)接口，支持電信自營(yíng)增值業(yè)務(wù)、第三方增值業(yè)務(wù)及企業(yè)應(yīng)用的接入。務(wù)及企業(yè)應(yīng)用的接入。n目前，規(guī)范包括目前，規(guī)范包括1212個(gè)業(yè)務(wù)能力，即：、。個(gè)業(yè)務(wù)能力，即：、。 n所有業(yè)務(wù)能力都是通過(guò)調(diào)用來(lái)實(shí)現(xiàn)的，各個(gè)業(yè)務(wù)能力有個(gè)公共部分所有業(yè)務(wù)能力都是通過(guò)調(diào)用來(lái)實(shí)現(xiàn)的，各個(gè)業(yè)務(wù)能力有個(gè)公共部分即頭結(jié)構(gòu)，頭分為上行頭和下行頭，主要攜帶一些、等基本信息即頭結(jié)構(gòu)，頭分為上行頭和下行頭，主要攜帶一些、等基本信息以便進(jìn)行鑒權(quán)。以便進(jìn)行鑒權(quán)。n n網(wǎng)絡(luò)應(yīng)用程序，使用協(xié)議實(shí)現(xiàn)。網(wǎng)絡(luò)應(yīng)用程序，使用協(xié)議實(shí)現(xiàn)。n簡(jiǎn)單的理解，就是這樣的一個(gè)開(kāi)放協(xié)議：采用作為底層通訊協(xié)議；簡(jiǎn)單的理解，就是這樣的一個(gè)開(kāi)放協(xié)議：

3、采用作為底層通訊協(xié)議；作為一致性的調(diào)用途徑，作為數(shù)據(jù)傳送的格式，允許服務(wù)提供者和作為一致性的調(diào)用途徑，作為數(shù)據(jù)傳送的格式，允許服務(wù)提供者和服務(wù)客戶經(jīng)過(guò)防火墻在進(jìn)行通訊交互。服務(wù)客戶經(jīng)過(guò)防火墻在進(jìn)行通訊交互。 n n 的描述語(yǔ)言，的描述語(yǔ)言， 定義了一套基于定義了一套基于 的語(yǔ)法，將服務(wù)描述為能夠的語(yǔ)法，將服務(wù)描述為能夠進(jìn)行消息交換的服務(wù)訪問(wèn)點(diǎn)的集合。進(jìn)行消息交換的服務(wù)訪問(wèn)點(diǎn)的集合。n ：與間，實(shí)現(xiàn)北向接口部分，主要作用是：與間，實(shí)現(xiàn)北向接口部分，主要作用是向提供標(biāo)準(zhǔn)、統(tǒng)一的業(yè)務(wù)開(kāi)發(fā)接口。向提供標(biāo)準(zhǔn)、統(tǒng)一的業(yè)務(wù)開(kāi)發(fā)接口。n其主要功能是將標(biāo)準(zhǔn)的接口封裝為內(nèi)部接其主要功能是將標(biāo)準(zhǔn)的接口封裝為內(nèi)部接口

4、，并通過(guò)將接口的同步處理方式轉(zhuǎn)換為口，并通過(guò)將接口的同步處理方式轉(zhuǎn)換為異步處理方式，將請(qǐng)求發(fā)送給平臺(tái)，以便異步處理方式，將請(qǐng)求發(fā)送給平臺(tái)，以便平臺(tái)進(jìn)行相應(yīng)的業(yè)務(wù)處理平臺(tái)進(jìn)行相應(yīng)的業(yè)務(wù)處理n 就是一個(gè)應(yīng)用程序，它向外界暴露出一個(gè)能夠通過(guò)進(jìn)行調(diào)用的。這就是就是一個(gè)應(yīng)用程序，它向外界暴露出一個(gè)能夠通過(guò)進(jìn)行調(diào)用的。這就是說(shuō)，你能夠用編程的方法通過(guò)來(lái)調(diào)用這個(gè)應(yīng)用程序。開(kāi)發(fā)工具有、等。說(shuō)，你能夠用編程的方法通過(guò)來(lái)調(diào)用這個(gè)應(yīng)用程序。開(kāi)發(fā)工具有、等。n n 調(diào)用遠(yuǎn)端對(duì)象的某個(gè)方法調(diào)用遠(yuǎn)端對(duì)象的某個(gè)方法n 返回該方法運(yùn)行后的輸出結(jié)果返回該方法運(yùn)行后的輸出結(jié)果User SOAP RequestSOAP Respo

5、nseServiceProviderWebServicen： 由提供（ 在用戶的里改。）n： 密碼（5加密）n5 加密算法如下：n密碼密匙時(shí)間戳n 密匙部分由分配，時(shí)間戳由發(fā)端設(shè)備生成；格式為,月日時(shí)分秒n： 業(yè)務(wù) n：定購(gòu)參數(shù)，群發(fā)時(shí)不填，單發(fā)時(shí)必填 業(yè)務(wù)訂購(gòu)地址，群發(fā)時(shí)不填；n 付費(fèi)地址n：的地址n：目的地址，如要發(fā)給哪個(gè)手機(jī)。n：的，也就是發(fā)到手機(jī)上顯示的號(hào)碼。在用戶的表里可以修改。n 里：n：是發(fā)多少次；n：容量即發(fā)多少條n 時(shí)間戳 格式為：格式為,月日時(shí)分秒n 業(yè)務(wù)接入碼 可選；n 業(yè)務(wù)流水號(hào)，用戶組合業(yè)務(wù)，可選；n 交易結(jié)束標(biāo)識(shí)，用戶組合業(yè)務(wù)，可選;n 事務(wù)關(guān)聯(lián) 用戶點(diǎn)播業(yè)務(wù)的事務(wù)

6、關(guān)聯(lián)，由平臺(tái)產(chǎn)生，格式如下為10位隨機(jī)序列號(hào)； 為空 （二進(jìn)制）表示無(wú)效，可選；n ：群發(fā) ：非群發(fā)（缺?。?反向調(diào)用的密碼，可選反向調(diào)用的密碼，可選 業(yè)務(wù)接入碼業(yè)務(wù)接入碼 業(yè)務(wù)業(yè)務(wù) 業(yè)務(wù)流水號(hào)，用于組合業(yè)務(wù)業(yè)務(wù)流水號(hào)，用于組合業(yè)務(wù) 事務(wù)關(guān)聯(lián)，用于點(diǎn)播業(yè)務(wù)的事務(wù)關(guān)聯(lián)，由平臺(tái)產(chǎn)生，格式為為事務(wù)關(guān)聯(lián)，用于點(diǎn)播業(yè)務(wù)的事務(wù)關(guān)聯(lián)，由平臺(tái)產(chǎn)生，格式為為10位隨機(jī)序列號(hào)；可選位隨機(jī)序列號(hào)；可選 反向調(diào)用名，可選；反向調(diào)用名，可選； n 規(guī)范介紹規(guī)范介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 概述概述n

7、 下行接口介紹下行接口介紹n 上行接口介紹上行接口介紹n 業(yè)務(wù)能力接口定義了短信業(yè)務(wù)能力集，包括應(yīng)用端發(fā)起的能力集合以及網(wǎng)絡(luò)側(cè)發(fā)起的能力集合。n用戶登錄短消息門戶網(wǎng)站，使用該服務(wù)。用戶編輯短信，點(diǎn)擊發(fā)送。門戶和 間通過(guò)短信，完成短信服務(wù)過(guò)程。 會(huì)將短信中心傳送回來(lái)的短信狀態(tài)，通知。用戶可以通過(guò)門戶網(wǎng)站查詢得知短信發(fā)送的狀態(tài)，序列圖如下：終端用戶終端用戶門戶網(wǎng)站門戶網(wǎng)站SAG SMSSAG SMS服務(wù)服務(wù)登錄portal，使用短信功能發(fā)送短信請(qǐng)求短信發(fā)送標(biāo)識(shí)短信發(fā)送狀態(tài)報(bào)告用戶查詢短信發(fā)送狀態(tài)報(bào)告1) 向簽約用戶發(fā)送短消息,業(yè)務(wù)觸發(fā)條件由應(yīng)用提供商與簽約用戶進(jìn)行預(yù)先約定，參數(shù)如下： 目的地址（或

8、地址集合）， 短消息發(fā)送者的信息 可選參數(shù)。應(yīng)用于本消息的計(jì)費(fèi)應(yīng)用可指定計(jì)費(fèi)方案名稱，由此確定這條短消息對(duì)誰(shuí)計(jì)費(fèi)以及金額幾何 短消息內(nèi)容 指示是否需要網(wǎng)絡(luò)側(cè)返回遞交狀態(tài)報(bào)告網(wǎng)關(guān)根據(jù)第三方的要求用 返回狀態(tài)報(bào)告。對(duì)本接口的調(diào)用，網(wǎng)關(guān)應(yīng)返回,標(biāo)示該短消息的發(fā)送請(qǐng)求。如果消息的長(zhǎng)度大于可支持的最大長(zhǎng)度，此條消息將被分成若干條連續(xù)的短消息進(jìn)行發(fā)送。2) 通過(guò)調(diào)用，可以查詢之前 標(biāo)識(shí)的 發(fā)送的狀態(tài)。狀態(tài)信息在 參數(shù)中返回，它與標(biāo)識(shí)的請(qǐng)求相關(guān)的一組狀態(tài)信息。狀態(tài)由用戶地址和相關(guān)的發(fā)送狀態(tài)共同標(biāo)識(shí)。 即使?fàn)顟B(tài)達(dá)到最終值，這個(gè)方法仍可被應(yīng)用多次調(diào)用。然而，狀態(tài)達(dá)到最終值之后，狀態(tài)信息只在有限的期間內(nèi)可用，超過(guò)

9、該期間，業(yè)務(wù)接入網(wǎng)關(guān)拋出策略異常。其中，返回的狀態(tài)包括：、等。3) 通過(guò)調(diào)用，應(yīng)用可以通過(guò)網(wǎng)關(guān)獲得所有滿足 標(biāo)識(shí)準(zhǔn)則的短消息。每執(zhí)行一次該方法，網(wǎng)關(guān)將返回給應(yīng)用的短消息從網(wǎng)關(guān)上刪除。此外，每條短消息在某個(gè)最大時(shí)間間隔后，會(huì)從服務(wù)器上自動(dòng)刪除。這個(gè)最大的時(shí)間間隔在離線配置階段定義。接收到的短消息信息在 參數(shù)中返回，其中包含短消息的發(fā)送者、內(nèi)容和終端用來(lái)發(fā)送消息的目標(biāo)地址。上行接口是由業(yè)務(wù)接入網(wǎng)關(guān)發(fā)起的、到業(yè)務(wù)應(yīng)用服務(wù)器的調(diào)用。4) 業(yè)務(wù)應(yīng)用服務(wù)器先前向網(wǎng)關(guān)發(fā)送了短消息，如果帶有 字段，則當(dāng)網(wǎng)關(guān)獲得狀態(tài)報(bào)告時(shí)，即調(diào)用本接口將短消息的遞交狀態(tài)報(bào)告給應(yīng)用。該狀態(tài)報(bào)告以 和 的組合進(jìn)行標(biāo)識(shí)。狀態(tài)信息在

10、中具體描述。5) 業(yè)務(wù)觸發(fā)條件由應(yīng)用提供商與運(yùn)營(yíng)商進(jìn)行預(yù)先約定，當(dāng)業(yè)務(wù)接入網(wǎng)關(guān)收到發(fā)給特定地址的短消息時(shí)，即調(diào)用本接口，將短消息發(fā)送給業(yè)務(wù)應(yīng)用服務(wù)器。 由業(yè)務(wù)接入網(wǎng)關(guān)調(diào)用，將短消息的接收通知應(yīng)用。僅當(dāng)收到的短消息滿足預(yù)先約定的提供準(zhǔn)則時(shí)，網(wǎng)關(guān)才會(huì)發(fā)出通知。這個(gè)提供準(zhǔn)則由 進(jìn)行標(biāo)識(shí)。短消息通過(guò)標(biāo)識(shí)，包括參數(shù)標(biāo)識(shí)短消息的內(nèi)容，參數(shù)，即能被應(yīng)用監(jiān)視的短消息的目的地址，參數(shù) 包含了發(fā)送者地址。應(yīng)用可采取適當(dāng)?shù)臉I(yè)務(wù)邏輯來(lái)處理收到的短消息。上圖為應(yīng)用提交短消息的調(diào)用流程：上圖為應(yīng)用提交短消息的調(diào)用流程：1-6）提交發(fā)送請(qǐng)求給，應(yīng)答在接入認(rèn)證完成）提交發(fā)送請(qǐng)求給，應(yīng)答在接入認(rèn)證完成(10)或向提交或向提交(

11、14)之后返之后返回；回；7-10）通過(guò)模塊向進(jìn)行鑒權(quán)批價(jià)處理，當(dāng)鑒權(quán)失敗時(shí)，直接進(jìn)入）通過(guò)模塊向進(jìn)行鑒權(quán)批價(jià)處理，當(dāng)鑒權(quán)失敗時(shí)，直接進(jìn)入21通通知鑒權(quán)失??；知鑒權(quán)失??；11-14）通過(guò)模塊向提交短消息，返回成功后將信息入庫(kù)；）通過(guò)模塊向提交短消息，返回成功后將信息入庫(kù)；15-18）收到來(lái)自的短消息回執(zhí)；）收到來(lái)自的短消息回執(zhí)；19-22）通過(guò)模塊向進(jìn)行鑒權(quán)批價(jià)確認(rèn)處理；）通過(guò)模塊向進(jìn)行鑒權(quán)批價(jià)確認(rèn)處理；23-28）向返回發(fā)送狀態(tài)報(bào)告（不要求狀態(tài)報(bào)告時(shí)無(wú)此流程）。）向返回發(fā)送狀態(tài)報(bào)告（不要求狀態(tài)報(bào)告時(shí)無(wú)此流程）。注：接入認(rèn)證見(jiàn)后圖。注：接入認(rèn)證見(jiàn)后圖。n 規(guī)范介紹規(guī)范介紹n 業(yè)務(wù)能力接口介紹業(yè)

12、務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 概述概述n 下行接口介紹下行接口介紹n 上行接口介紹上行接口介紹 業(yè)務(wù)能力接口定義了彩信業(yè)務(wù)能力集，包括應(yīng)用端發(fā)起的能力集合以及網(wǎng)絡(luò)側(cè)發(fā)起的能力集合。 彩信和短信的流程基本類似，區(qū)別在于彩信消息中可以包含圖片、文本等附件。用戶登錄一個(gè)卡通圖片業(yè)務(wù)門戶網(wǎng)站，為過(guò)生日的好友選擇祝福卡片，并編輯祝福短信后，點(diǎn)擊彩信發(fā)送。圖片門戶與 服務(wù)間通過(guò) 交互完成彩信的發(fā)送。同時(shí)， 服務(wù)會(huì)將彩信中心返回的狀態(tài)報(bào)告通知給圖片門戶，這樣用戶可通過(guò)門戶網(wǎng)站查詢彩信發(fā)送的狀態(tài)。下行接口是由業(yè)務(wù)應(yīng)

13、用服務(wù)器發(fā)起、到業(yè)務(wù)接入網(wǎng)關(guān)的調(diào)用。1) 業(yè)務(wù)觸發(fā)條件由應(yīng)用提供商與簽約用戶進(jìn)行預(yù)先約定，由應(yīng)用根據(jù)業(yè)務(wù)需要在恰當(dāng)時(shí)刻調(diào)用本接口，給用戶發(fā)送一條彩信。本消息調(diào)用是請(qǐng)求發(fā)送一條彩信到一組地址集合，并返回 對(duì)本消息的發(fā)送進(jìn)行標(biāo)識(shí)。網(wǎng)關(guān)根據(jù)第三方的要求用 返回狀態(tài)報(bào)告，并使用 與先前發(fā)送的消息相關(guān)聯(lián)。彩信的內(nèi)容是作為一個(gè) 附件進(jìn)行發(fā)送。第三方通過(guò) 告知網(wǎng)關(guān)是否需要返回狀態(tài)報(bào)告。2) 通過(guò)調(diào)用，可以查詢之前 標(biāo)識(shí)的 發(fā)送的狀態(tài)。狀態(tài)信息在 參數(shù)中返回，它與標(biāo)識(shí)的請(qǐng)求相關(guān)的一組狀態(tài)信息。狀態(tài)由用戶地址和相關(guān)的發(fā)送狀態(tài)共同標(biāo)識(shí)。 即使?fàn)顟B(tài)達(dá)到最終值，這個(gè)方法仍可被應(yīng)用多次調(diào)用。然而，狀態(tài)達(dá)到最終值之后，狀

14、態(tài)信息只在有限的期間內(nèi)可用，超過(guò)該期間， 業(yè)務(wù)接入網(wǎng)關(guān)拋出策略異常。其中，返回的狀態(tài)包括：、等。3) 這個(gè)操作是使用一個(gè)特殊的注冊(cè)標(biāo)識(shí)符獲得一組新的消息。該請(qǐng)求參數(shù)為和優(yōu)先參數(shù)（，可選），返回一個(gè)數(shù)組，其中包括每條彩信的彩信標(biāo)識(shí)、主題、發(fā)送方地址、目的地址等。通過(guò)該操作，應(yīng)用可以獲取特定標(biāo)識(shí)的彩信基本信息，并依據(jù)各個(gè)彩信的標(biāo)識(shí)進(jìn)一步獲取彩信地址組及彩信附件。綁定不同注冊(cè)標(biāo)識(shí)符參數(shù)是一個(gè)不在線的處理過(guò)程。 X 網(wǎng)關(guān)不允許使用一個(gè)未與應(yīng)用關(guān)聯(lián)的注冊(cè)標(biāo)識(shí)符獲取消息。4) 這個(gè)操作將依據(jù)讀取消息的不同部分，在業(yè)務(wù)接入網(wǎng)關(guān)建立本地文件并且返回 標(biāo)識(shí)。應(yīng)用可以僅僅讀取每個(gè)文件或?qū)⑵湟枣溄拥男问匠尸F(xiàn)給最終用

15、戶。5) 這個(gè)操作將依據(jù)這個(gè)操作將讀取整條消息。在返回的消息中，數(shù)據(jù)以附件形式返回。上行接口是由業(yè)務(wù)接入網(wǎng)關(guān)發(fā)起的、到業(yè)務(wù)應(yīng)用服務(wù)器的調(diào)用。6) 業(yè)務(wù)應(yīng)用服務(wù)器先前向網(wǎng)關(guān)發(fā)送了彩信，網(wǎng)關(guān)對(duì)該消息的發(fā)送分配了一個(gè)標(biāo)識(shí)符。當(dāng)網(wǎng)關(guān)獲得狀態(tài)報(bào)告時(shí)，即調(diào)用本接口將彩信的遞交狀態(tài)報(bào)告給應(yīng)用。本接口的調(diào)用是將先前遞交彩信的狀態(tài)報(bào)告告知應(yīng)用，該彩信以 和 的組合進(jìn)行標(biāo)識(shí)。狀態(tài)信息在 中具體描述。7) 業(yè)務(wù)觸發(fā)條件由應(yīng)用提供商與運(yùn)營(yíng)商進(jìn)行預(yù)先約定，當(dāng)業(yè)務(wù)接入網(wǎng)關(guān)收到發(fā)給特定地址的消息時(shí)，即調(diào)用本接口，將消息發(fā)送給業(yè)務(wù)應(yīng)用服務(wù)器。當(dāng)網(wǎng)關(guān)收到發(fā)送到特定業(yè)務(wù)激活號(hào)碼的新消息時(shí)，將把消息作為附件通知到應(yīng)用。參數(shù)標(biāo)識(shí)業(yè)務(wù)

16、激活號(hào)碼，標(biāo)識(shí)與接收消息相關(guān)的所有信息。n 規(guī)范介紹規(guī)范介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 概述概述n 下行接口介紹下行接口介紹n 上行接口介紹上行接口介紹 業(yè)務(wù)能力接口定義了定位業(yè)務(wù)能力集，包括應(yīng)用端發(fā)起的能力集合以及網(wǎng)絡(luò)側(cè)發(fā)起的能力集合。 定位業(yè)務(wù)能力集可分為一下三類：位置信息同步查詢：應(yīng)用向 查詢一個(gè)或一組用戶位置信息，網(wǎng)關(guān)同步返回位置信息告知應(yīng)用。位置信息異步查詢（事件觸發(fā)）：應(yīng)用調(diào)用一次位置請(qǐng)求，指定范圍區(qū)域。在查詢周期內(nèi)，用戶進(jìn)入指定區(qū)域或離開(kāi)指定區(qū)域，網(wǎng)絡(luò)將上報(bào)用戶

17、位置信息。位置信息異步查詢（周期性觸發(fā)）：應(yīng)用可以調(diào)用一個(gè) 請(qǐng)求，網(wǎng)絡(luò)按一定頻率周期性上報(bào)用戶位置信息。 下行接口是由業(yè)務(wù)應(yīng)用服務(wù)器發(fā)起、到業(yè)務(wù)接入網(wǎng)關(guān)的調(diào)用。下行接口可分為兩類：定位信息同步查詢和定位信息異步查詢。1) 定位信息同步查詢接口，查詢一個(gè)終端用戶的位置信息，參數(shù)如下：需定位的終端地址；：要求精度，以米為單位；：可接受的精度，以米為單位。定位結(jié)果通過(guò)返回給應(yīng)用，包括經(jīng)度、緯度以及終端地址等。其中，緯度值以浮點(diǎn)數(shù)（-90.0000 +90.0000）形式表示，單位為十進(jìn)度的度（方向與分鐘和秒鐘相反），正值表示赤道以北，負(fù)值表示赤道以南。經(jīng)度值以浮點(diǎn)數(shù)（-180.0000 +180.0

18、000）形式表示，單位為十進(jìn)度的度（方向與分鐘和秒鐘相反），正值表示本初子午線（格林威治）以東，負(fù)值表示本初子午線（格林威治）以西，直到第180 條子午線。2) 定位信息同步查詢接口， 查詢一個(gè)與某個(gè)特定位置間的距離，該特定的位置以經(jīng)度和緯度來(lái)表示，參數(shù)如下：終端地址：指定位置的緯度:指定位置的經(jīng)度返回終端與指定點(diǎn)間的距離，以米為單位。3) 定位信息同步查詢接口，和接口類似，區(qū)別在于可以獲取一組終端用戶的位置信息，參數(shù)和一樣。定位結(jié)果通過(guò)數(shù)組返回給應(yīng)用，其中除了包含中的基本信息外，還包括位置報(bào)告狀態(tài)以及錯(cuò)誤值（當(dāng) 為“”時(shí)有效）。4) 定位信息異步查詢接口（事件觸發(fā)），用于請(qǐng)求 以一定原則上報(bào)

19、一個(gè)或多個(gè)終端的位置信息。報(bào)告上報(bào)的原則為用戶進(jìn)入或離開(kāi)指定的區(qū)域。該請(qǐng)求的參數(shù)包括終端地址組、原點(diǎn)的經(jīng)緯度、范圍的半徑、產(chǎn)生報(bào)告的原則、是否立即查詢、上報(bào)最大頻度、最大時(shí)長(zhǎng)以及上報(bào)次數(shù)等。業(yè)務(wù)接入網(wǎng)關(guān)收到該請(qǐng)求后，通過(guò)按照應(yīng)用的要求上報(bào)終端位置信息，錯(cuò)誤信息通過(guò)上報(bào)應(yīng)用，上報(bào)結(jié)束時(shí)調(diào)用通知應(yīng)用。5) 定位信息異步查詢接口（周期性觸發(fā)），用于請(qǐng)求 按照一定的精度周期性上報(bào)一個(gè)或多個(gè)終端的位置信息。該接口和區(qū)域定位類似，也是通過(guò)等接口通知應(yīng)用定位結(jié)果。6) 請(qǐng)求 停止周期性或事件觸發(fā)性的上報(bào)一個(gè)或多個(gè)用戶的狀態(tài)信息。周期性及事件觸發(fā)性定位請(qǐng)求中將該請(qǐng)求的異步位置查詢的請(qǐng)求標(biāo)識(shí)（）帶給業(yè)務(wù)接入網(wǎng)關(guān)

20、，應(yīng)用通過(guò)該標(biāo)識(shí)通知停止上報(bào)。上行接口是由業(yè)務(wù)接入網(wǎng)關(guān)發(fā)起的、到業(yè)務(wù)應(yīng)用服務(wù)器的調(diào)用。7) 該接口用于業(yè)務(wù)接入網(wǎng)關(guān)向應(yīng)用返回需要查詢的終端用戶位置信息。該通知消息通過(guò)參數(shù)和應(yīng)用下發(fā)的周期性或事件觸發(fā)異步位置查詢請(qǐng)求相關(guān)聯(lián)，位置信息放在數(shù)組中，當(dāng)請(qǐng)求是事件觸發(fā)的異步位置查詢請(qǐng)求時(shí)，通過(guò)參數(shù)指明當(dāng)前位置上報(bào)的原則。8) 該接口用于業(yè)務(wù)接入網(wǎng)關(guān)查詢用戶位置消息出現(xiàn)錯(cuò)誤時(shí)，通知業(yè)務(wù)應(yīng)用服務(wù)器。該通知消息通過(guò)參數(shù)和應(yīng)用下發(fā)的周期性或事件觸發(fā)異步位置查詢請(qǐng)求相關(guān)聯(lián)，參數(shù)指明錯(cuò)誤報(bào)告對(duì)應(yīng)的終端地址，指明錯(cuò)誤原因。9) 當(dāng)位置報(bào)告的最大時(shí)長(zhǎng)或者次數(shù)到時(shí)，則 結(jié)束周期性監(jiān)視狀態(tài)。接口通過(guò)參數(shù)和應(yīng)用下發(fā)的周期性或

21、事件觸發(fā)異步位置查詢請(qǐng)求相關(guān)聯(lián)。n 規(guī)范介紹規(guī)范介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 概述概述n 下行接口介紹下行接口介紹n 上行接口介紹上行接口介紹 業(yè)務(wù)能力接口定義了業(yè)務(wù)能力集，包括應(yīng)用端發(fā)起的能力集合以及網(wǎng)絡(luò)側(cè)發(fā)起的能力集合。 和短信的流程基本類似，基本業(yè)務(wù)流程如下：應(yīng)用程序向業(yè)務(wù)接入網(wǎng)關(guān)提交推送請(qǐng)求，業(yè)務(wù)網(wǎng)關(guān)返回請(qǐng)求標(biāo)識(shí)。應(yīng)用程序可以根據(jù)返回的請(qǐng)求標(biāo)識(shí)主動(dòng)向業(yè)務(wù)接入網(wǎng)關(guān)查詢狀態(tài)，也可以等待業(yè)務(wù)接入網(wǎng)關(guān)發(fā)出推送結(jié)果通知。下行接口是由業(yè)務(wù)應(yīng)用服務(wù)器發(fā)起、到業(yè)務(wù)接入網(wǎng)關(guān)的調(diào)用。1

22、) 本操作請(qǐng)求把一個(gè)消息的 地址推送到一組目標(biāo)地址，并且返回一個(gè)請(qǐng)求標(biāo)識(shí)（）以唯一標(biāo)識(shí)這個(gè)消息。應(yīng)用程序可以稍后用 查詢消息狀態(tài)。第三方通過(guò) 告知網(wǎng)關(guān)是否需要返回狀態(tài)報(bào)告。網(wǎng)關(guān)根據(jù)第三方的要求用 返回狀態(tài)報(bào)告，并使用 與先前發(fā)送的消息相關(guān)聯(lián)。2) 通過(guò)調(diào)用，可以查詢之前 標(biāo)識(shí)的推送請(qǐng)求的處理狀態(tài)。狀態(tài)信息在 參數(shù)中返回，它與標(biāo)識(shí)的請(qǐng)求相關(guān)的一組狀態(tài)信息。狀態(tài)由用戶地址和相關(guān)的發(fā)送狀態(tài)共同標(biāo)識(shí)。 即使?fàn)顟B(tài)達(dá)到最終值，這個(gè)方法仍可被應(yīng)用多次調(diào)用。然而，狀態(tài)達(dá)到最終值之后，狀態(tài)信息只在有限的期間內(nèi)可用，超過(guò)該期間， 業(yè)務(wù)接入網(wǎng)關(guān)拋出策略異常。其中，返回的狀態(tài)包括：、等。上行接口是由業(yè)務(wù)接入網(wǎng)關(guān)發(fā)起的

23、、到業(yè)務(wù)應(yīng)用服務(wù)器的調(diào)用。3) 本操作向客戶端應(yīng)用程序通知推送結(jié)果。本接口的調(diào)用是將先前遞交的推送請(qǐng)求的狀態(tài)報(bào)告告知應(yīng)用，該短消息以 和 的組合進(jìn)行標(biāo)識(shí)。狀態(tài)信息在 中具體描述。n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力介紹業(yè)務(wù)能力介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 概述概述n 下行接口介紹下行接口介紹 業(yè)務(wù)能力接口定義了語(yǔ)音呼叫業(yè)務(wù)能力集，該業(yè)務(wù)能力集只有應(yīng)用端發(fā)起到業(yè)務(wù)接入網(wǎng)關(guān)調(diào)用的能力集合。 提供

24、了一種靈活的方式來(lái)傳遞語(yǔ)音信息。接口非常簡(jiǎn)單，不需要開(kāi)發(fā)者去管理呼叫的產(chǎn)生，也不需要與呼叫交互來(lái)發(fā)送語(yǔ)音消息。 有三種機(jī)制可以用于語(yǔ)音消息的內(nèi)容：文本：使用（）引擎來(lái)播放語(yǔ)音內(nèi)容（例如，）：使用放音設(shè)備來(lái)播放：使用 瀏覽器來(lái)播放 目前只支持文本放音。 應(yīng)用調(diào)用接口請(qǐng)求放音，網(wǎng)關(guān)返回請(qǐng)求標(biāo)識(shí)，應(yīng)用根據(jù)該關(guān)聯(lián)標(biāo)識(shí)查詢呼叫狀態(tài)，同時(shí)應(yīng)用也可以根據(jù)該關(guān)聯(lián)標(biāo)識(shí)取消放音服務(wù)。1) 調(diào)用該接口用于創(chuàng)建一個(gè)到用戶的呼叫，該用戶由標(biāo)識(shí)，并且播放位于 的 文件信息。當(dāng)系統(tǒng)接收到請(qǐng)求后，調(diào)用會(huì)立即返回結(jié)果（實(shí)際的呼叫異步進(jìn)行）。返回值將被用來(lái)標(biāo)識(shí)這次請(qǐng)求。這個(gè)操作被用來(lái)對(duì)單個(gè)終端播放一條信息。這里提供的應(yīng)該是單個(gè)終

25、端，而不是群組。如果提供了群組，則應(yīng)用將收到。、和該接口類似，只是播放的語(yǔ)音內(nèi)容不同。2) 調(diào)用 來(lái)得到先前請(qǐng)求的當(dāng)前狀態(tài)。先前請(qǐng)求由 來(lái)標(biāo)識(shí)，得到值，指明當(dāng)前播放狀態(tài)為已播放、正在播放、還未播放或是發(fā)生錯(cuò)誤。3) 調(diào)用 取消或停止由 標(biāo)識(shí)的先前請(qǐng)求。返回值為，包含了在放棄請(qǐng)求時(shí)刻的狀態(tài)。n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力介紹業(yè)務(wù)能力介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 概述概述n 下行接口介紹下

26、行接口介紹 業(yè)務(wù)能力接口定義了第三方呼叫業(yè)務(wù)能力集，該業(yè)務(wù)能力集只有應(yīng)用端發(fā)起到業(yè)務(wù)接入網(wǎng)關(guān)調(diào)用的能力集合。 描述第三方呼叫，用于創(chuàng)建并管理應(yīng)用發(fā)起的呼叫。此 的范圍就是以簡(jiǎn)單的方式為應(yīng)用開(kāi)發(fā)商提供創(chuàng)建呼叫的功能。事實(shí)上，通過(guò)使用這個(gè)第三方呼叫 ，應(yīng)用開(kāi)發(fā)商不需要掌握詳細(xì)的電信知識(shí)，就能調(diào)用呼叫處理功能。 基本流程： 業(yè)務(wù)門戶提供用戶點(diǎn)擊撥號(hào)的業(yè)務(wù)界面，用戶只需通過(guò)點(diǎn)擊網(wǎng)頁(yè)就可以建立語(yǔ)音呼叫。業(yè)務(wù)網(wǎng)關(guān)會(huì)在業(yè)務(wù)請(qǐng)求收到后返回一個(gè)能唯一標(biāo)識(shí)該次呼叫的參數(shù)。用戶也可以通過(guò)業(yè)務(wù)界面停止該呼叫。1) 第三方觸發(fā)一語(yǔ)音增值業(yè)務(wù)，通過(guò) 指示網(wǎng)關(guān)發(fā)起業(yè)務(wù)呼叫。網(wǎng)關(guān)呼通主叫，再連接被叫。作為可選，應(yīng)用還可以提供

27、計(jì)費(fèi)（）指示。返回的參數(shù)（）用于標(biāo)識(shí)此呼叫， 可以用它來(lái)監(jiān)視這個(gè)呼叫的狀態(tài)，或是取消呼叫等。2) 調(diào)用 獲得指定呼叫（由 標(biāo)識(shí)）的當(dāng)前狀態(tài)。呼叫結(jié)束后，在靜態(tài)配置的有效期內(nèi)，網(wǎng)關(guān)將保存呼叫狀態(tài)，以供查詢。返回的狀態(tài)信息包括呼叫狀態(tài)、開(kāi)始時(shí)間、時(shí)長(zhǎng)等。3) 通過(guò)呼叫標(biāo)識(shí)指示網(wǎng)關(guān)結(jié)束 呼叫。如果呼叫還處于初始階段，網(wǎng)關(guān)將放棄呼叫。如果呼叫已經(jīng)建立，網(wǎng)關(guān)將切斷呼叫。4) 通過(guò)呼叫標(biāo)識(shí)指示網(wǎng)關(guān)放棄 呼叫。如果呼叫還未建立，指示網(wǎng)關(guān)放棄 呼叫，如果呼叫已經(jīng)建立，呼叫將不受影響。n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹

28、業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力介紹業(yè)務(wù)能力介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 概述概述n 上行接口介紹上行接口介紹 業(yè)務(wù)能力接口定義了網(wǎng)絡(luò)發(fā)起到第三方呼叫的業(yè)務(wù)能力集， 用于處理網(wǎng)絡(luò)中的簽約用戶發(fā)起的呼叫，一個(gè)第三方的應(yīng)用將決定此呼叫將如何處理。 基本是一個(gè)被叫屬性觸發(fā)的業(yè)務(wù)能力集，包括兩類接口，四種觸發(fā)方式：接口可分為兩類和：兩類接口都是依照事先配置的事件觸發(fā)呼叫，不同的是接口是網(wǎng)關(guān)用來(lái)通知 ，而中定義的接口網(wǎng)關(guān)不但將呼叫通知，并等待 的下一步動(dòng)作指示。觸發(fā)方式包括：被叫忙觸發(fā)、被叫不可達(dá)觸發(fā)、被叫無(wú)應(yīng)答觸發(fā)和接入

29、碼觸發(fā)。1) 類接口類接口包括四個(gè)：、，這四個(gè)接口的參數(shù)及返回值類型一致，只是觸發(fā)方式不同。在此以為例說(shuō)明。在一個(gè)基本呼叫中，當(dāng)被叫忙時(shí)，觸發(fā)智能業(yè)務(wù)。網(wǎng)關(guān)向 進(jìn)行智能請(qǐng)求， 進(jìn)行相關(guān)業(yè)務(wù)判斷，指示網(wǎng)關(guān)進(jìn)行動(dòng)作。 指示網(wǎng)關(guān)動(dòng)作有三種： ： 正常地處理網(wǎng)絡(luò)中的被叫忙事件 ： 結(jié)束呼叫 ： 重新路由到應(yīng)用指定的目標(biāo)地址 當(dāng)應(yīng)用指示的網(wǎng)關(guān)動(dòng)作是時(shí)，返回的中還包含重新路由的地址。2) 類接口類接口包括四個(gè)：、，這四個(gè)接口的參數(shù)類型一致，只是觸發(fā)方式不同。在此以為例說(shuō)明。在一個(gè)基本呼叫中，當(dāng)被叫忙時(shí)，觸發(fā)智能業(yè)務(wù)，網(wǎng)關(guān)將被叫忙事件通知給。該類請(qǐng)求的參數(shù)和類接口類似，包括主叫號(hào)碼、被叫號(hào)碼以及主叫方名稱（

30、可選）， 類接口沒(méi)有返回值。n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力介紹業(yè)務(wù)能力介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 概述概述n 下行接口介紹下行接口介紹n 上行接口介紹上行接口介紹 ，即，增強(qiáng)呼叫業(yè)務(wù)集，分為應(yīng)用側(cè)發(fā)起的呼叫和網(wǎng)絡(luò)側(cè)發(fā)起的呼叫。 在 和 中描述的呼叫控制，無(wú)論是第三方發(fā)起的還是網(wǎng)絡(luò)發(fā)起的，應(yīng)用和網(wǎng)絡(luò)的交互都是一次性的。在呼叫建立后，應(yīng)用無(wú)法對(duì)呼叫的進(jìn)展保持跟蹤，因而也不能根據(jù)呼叫的具體

31、進(jìn)展情況作進(jìn)一步的處理；同時(shí)，應(yīng)用也無(wú)法利用網(wǎng)絡(luò)專有資源向用戶提供服務(wù)。這在很大程度上限制了應(yīng)用開(kāi)發(fā)商開(kāi)發(fā)業(yè)務(wù)的靈活性和多樣性。增強(qiáng)型呼叫控制，以簡(jiǎn)單的方式為應(yīng)用開(kāi)發(fā)商提供持續(xù)控制一個(gè)呼叫的功能。 下行接口即類接口，應(yīng)用側(cè)發(fā)起的呼叫，是由 到業(yè)務(wù)應(yīng)用服務(wù)器的調(diào)用。第三方可以發(fā)起一個(gè)呼叫，也可以根據(jù)呼叫標(biāo)識(shí)查詢呼叫狀態(tài)或結(jié)束呼叫。1) 第三方觸發(fā)一語(yǔ)音增值業(yè)務(wù)，通過(guò) 指示網(wǎng)關(guān)發(fā)起業(yè)務(wù)呼叫，并返回呼叫標(biāo)識(shí)。請(qǐng)求參數(shù)：(主叫號(hào)碼)、 （指示網(wǎng)關(guān)的處理動(dòng)作）、（計(jì)費(fèi)標(biāo)識(shí)）、（是否抑止）;響應(yīng)消息攜帶呼叫標(biāo)識(shí)；用戶點(diǎn)擊網(wǎng)頁(yè)觸發(fā)語(yǔ)音增值業(yè)務(wù)，啟動(dòng)業(yè)務(wù)邏輯，指示網(wǎng)關(guān)先呼通主叫，主叫摘機(jī)應(yīng)答后，網(wǎng)關(guān)按照的指示

32、處理呼叫。若 的指示為用戶交互時(shí)，網(wǎng)關(guān)處理結(jié)束后必須上報(bào)；若 的指示為呼叫時(shí)， 應(yīng)指明網(wǎng)關(guān)是否需要上報(bào)呼叫處理結(jié)果。n 指示主叫摘機(jī)應(yīng)答后，網(wǎng)關(guān)的處理動(dòng)作：n 與用戶語(yǔ)音交互n 連接一個(gè)指定的被叫n 失敗后，無(wú)條件順呼n 同振n2) n第三方根據(jù)已建立呼叫的呼叫標(biāo)識(shí)調(diào)用 來(lái)指示網(wǎng)關(guān)中斷終端正在進(jìn)行的行為（放音、通話），開(kāi)始一個(gè)新的處理動(dòng)作， 為新的處理動(dòng)作的指示。被中斷的終端為已被連接至系統(tǒng)的終端。3) 業(yè)務(wù)觸發(fā)條件： 業(yè)務(wù)已觸發(fā)，并得到了呼叫標(biāo)識(shí) 。應(yīng)用：應(yīng)用調(diào)用 查詢業(yè)務(wù)是否還正常進(jìn)行，實(shí)現(xiàn)與 之間的激活測(cè)試機(jī)制。4) 業(yè)務(wù)觸發(fā)條件： 業(yè)務(wù)已觸發(fā)，并得到了呼叫標(biāo)識(shí) 。應(yīng)用：根據(jù)呼叫標(biāo)識(shí)調(diào)用

33、指示網(wǎng)關(guān)切斷呼叫，結(jié)束業(yè)務(wù)呼叫服務(wù)。 上行接口即類接口，網(wǎng)絡(luò)側(cè)發(fā)起的呼叫，是由 到業(yè)務(wù)應(yīng)用服務(wù)器的調(diào)用。 生成呼叫標(biāo)識(shí)， 根據(jù)該標(biāo)識(shí)指示 進(jìn)行放音、呼叫接續(xù)、同振、順呼、彩鈴等動(dòng)作。1) 用戶通過(guò)撥打業(yè)務(wù)接入碼方式進(jìn)行業(yè)務(wù)觸發(fā)， 將業(yè)務(wù)請(qǐng)求通知。 收到業(yè)務(wù)請(qǐng)求，啟動(dòng)業(yè)務(wù)應(yīng)用（），開(kāi)始增值業(yè)務(wù)服務(wù)。網(wǎng)關(guān)將呼叫信息（主、被叫）和業(yè)務(wù)觸發(fā)原因上報(bào)給。 通過(guò)業(yè)務(wù)邏輯判斷，指示網(wǎng)關(guān)如何處理當(dāng)前呼叫。若處理的動(dòng)作為用戶交互時(shí)，網(wǎng)關(guān)處理結(jié)束后必須上報(bào)；若處理的動(dòng)作為呼叫時(shí)， 需要指示網(wǎng)關(guān)上報(bào)呼叫處理結(jié)果，否則網(wǎng)關(guān)不上報(bào)。網(wǎng)關(guān)通知 業(yè)務(wù)請(qǐng)求時(shí)，呼叫的狀態(tài)為： 被叫忙 被叫不可達(dá) 被叫無(wú)應(yīng)答 主叫摘機(jī) 業(yè)務(wù)接入

34、碼呼叫 呼叫流程觸發(fā)情況 呼叫流程觸發(fā)情況 指示網(wǎng)關(guān)的處理動(dòng)作為： 結(jié)束呼叫 與用戶語(yǔ)音交互 連接一個(gè)指定的被叫 失敗后，無(wú)條件順呼 同振2) 業(yè)務(wù)觸發(fā)條件：當(dāng)網(wǎng)關(guān)根據(jù)應(yīng)用指示對(duì)業(yè)務(wù)請(qǐng)求的處理動(dòng)作為呼叫時(shí)，如：呼一個(gè)被叫、同振、順呼，并且 指示網(wǎng)關(guān)呼叫處理結(jié)束后上報(bào)呼叫處理結(jié)果。網(wǎng)關(guān)呼叫處理結(jié)束，通過(guò) 上報(bào)呼叫處理結(jié)果。 收到呼叫處理結(jié)果，進(jìn)行業(yè)務(wù)判斷，指示網(wǎng)關(guān)下一步的處理動(dòng)作，下一步動(dòng)作和中的返回值一致，網(wǎng)關(guān)通知 呼叫處理結(jié)果分以下幾種： 呼叫失?。罕唤忻?呼叫失?。罕唤胁豢蛇_(dá) 呼叫失?。罕唤袩o(wú)應(yīng)答 呼叫失敗： 終端離線 呼叫完成：被叫掛機(jī) 呼叫完成：呼叫限制到3) 業(yè)務(wù)觸發(fā)條件：當(dāng)網(wǎng)關(guān)根據(jù)

35、應(yīng)用指示對(duì)業(yè)務(wù)請(qǐng)求的處理為進(jìn)行用戶交互時(shí)，如：向用戶播放語(yǔ)音、放音收號(hào)、取 腳本進(jìn)行用戶交互。用戶交互結(jié)束后，網(wǎng)關(guān)通過(guò) 上報(bào)用戶交互結(jié)果。 根據(jù)網(wǎng)關(guān)上報(bào)的用戶交互結(jié)果進(jìn)行業(yè)務(wù)判斷，指示網(wǎng)關(guān)下一步的處理動(dòng)作。 下一步動(dòng)作和中的返回值一致，網(wǎng)關(guān)通知 用戶交互結(jié)果如下： 用戶交互結(jié)束，無(wú)收號(hào) 用戶交互結(jié)束，有收號(hào) 號(hào)碼 用戶交互失敗 4) 網(wǎng)關(guān)將被叫應(yīng)答、主叫掛機(jī)等呼叫事件以通知的方式告知。通知的事件包括以下幾種： 被叫應(yīng)答主叫掛機(jī)主叫忙主叫無(wú)應(yīng)答主叫不可達(dá)各個(gè)呼叫控制步驟通過(guò)上行接口參數(shù)中的呼叫標(biāo)識(shí)相互關(guān)聯(lián)。n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介

36、紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力介紹業(yè)務(wù)能力介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 概述概述n 下行接口介紹下行接口介紹n 上行接口介紹上行接口介紹n ：即（ ）；即非結(jié)構(gòu)化補(bǔ)充數(shù)據(jù)業(yè)務(wù)。是一種基于網(wǎng)絡(luò)，可以提供綜合性、交互式信息服務(wù)的數(shù)據(jù)業(yè)務(wù)! n與短消息業(yè)務(wù)（）都是通過(guò)網(wǎng)絡(luò)的信令通道傳遞的。不同之處在于短消息屬于存儲(chǔ)轉(zhuǎn)發(fā)方式，則屬于面向?qū)υ挿绞健．?dāng)用戶訪問(wèn)業(yè)務(wù)時(shí)，該對(duì)話通路保持連接，直到對(duì)話結(jié)束。n 用于在應(yīng)用和用戶之間的建立的交互，以此完成一些信息的交互。n下行接口類包括如下接口

37、類：n n上行接口類包括如下接口類：n n接口類接口類1 1 nn由應(yīng)用發(fā)起的請(qǐng)求，將信息傳遞給網(wǎng)關(guān)由應(yīng)用發(fā)起的請(qǐng)求，將信息傳遞給網(wǎng)關(guān); ;應(yīng)用調(diào)用本接口，向網(wǎng)關(guān)發(fā)起交互請(qǐng)求。應(yīng)用調(diào)用本接口，向網(wǎng)關(guān)發(fā)起交互請(qǐng)求。 n交互的內(nèi)容中描述。該消息的目的地址交互的內(nèi)容中描述。該消息的目的地址由描述。由描述。n應(yīng)用的請(qǐng)求網(wǎng)關(guān)返回應(yīng)用的請(qǐng)求網(wǎng)關(guān)返回, ,以使本次交互與后以使本次交互與后續(xù)的交互關(guān)聯(lián)起來(lái)。續(xù)的交互關(guān)聯(lián)起來(lái)。n方法有和方法有和: : n接口類接口類2 2： n1 1n網(wǎng)關(guān)調(diào)用本接口，向應(yīng)用發(fā)起交互請(qǐng)求網(wǎng)關(guān)調(diào)用本接口，向應(yīng)用發(fā)起交互請(qǐng)求及消息內(nèi)容。網(wǎng)關(guān)通過(guò)標(biāo)識(shí)這次特定的及消息內(nèi)容。網(wǎng)關(guān)通過(guò)標(biāo)識(shí)這

38、次特定的交互。交互的內(nèi)容在中描述。請(qǐng)求的發(fā)交互。交互的內(nèi)容在中描述。請(qǐng)求的發(fā)起者由描述。網(wǎng)關(guān)通過(guò)請(qǐng)求應(yīng)用給出下起者由描述。網(wǎng)關(guān)通過(guò)請(qǐng)求應(yīng)用給出下一步的交互的信息。一步的交互的信息。n2n在交互已成功建立之時(shí)，網(wǎng)關(guān)調(diào)用本在交互已成功建立之時(shí)，網(wǎng)關(guān)調(diào)用本接口，將用戶的反饋信息告知應(yīng)用。網(wǎng)接口，將用戶的反饋信息告知應(yīng)用。網(wǎng)關(guān)通過(guò)標(biāo)識(shí)這次的特定的交互。交互的關(guān)通過(guò)標(biāo)識(shí)這次的特定的交互。交互的內(nèi)容在中描述。請(qǐng)求的發(fā)起者由描述。內(nèi)容在中描述。請(qǐng)求的發(fā)起者由描述。網(wǎng)關(guān)通過(guò)請(qǐng)求應(yīng)用給出下一步交互信息。網(wǎng)關(guān)通過(guò)請(qǐng)求應(yīng)用給出下一步交互信息。n3. n網(wǎng)關(guān)調(diào)用本接口告知應(yīng)用交互被中止，網(wǎng)關(guān)調(diào)用本接口告知應(yīng)用交互被中

39、止，并在參數(shù)中給出中止原因。網(wǎng)關(guān)通過(guò)標(biāo)識(shí)并在參數(shù)中給出中止原因。網(wǎng)關(guān)通過(guò)標(biāo)識(shí)這次特定的交互。這次特定的交互。n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力介紹業(yè)務(wù)能力介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n概述n下行接口介紹n上行接口介紹業(yè)務(wù)：即 終端狀態(tài)業(yè)務(wù)。 查詢終端狀態(tài)和終端狀態(tài)報(bào)告。n業(yè)務(wù)下行接口類即類接口，調(diào)用該接口查詢一個(gè)終端用戶的當(dāng)前狀態(tài)信息。n1. n調(diào)用，獲取終端地址列表信息，返回 中的參數(shù)類型

40、為終端狀態(tài)列表信息。n2. n通過(guò)本操作 請(qǐng)求周期性的上報(bào)一個(gè)或者多個(gè)用戶的狀態(tài)信息，并返回對(duì)本請(qǐng)求的進(jìn)行標(biāo)識(shí)。n其中方法中包括如下參數(shù)：n參數(shù)： 監(jiān)聽(tīng)異步請(qǐng)求返回值，接收用戶的狀態(tài)的地址信息。n參數(shù)： 需要獲取的用戶狀態(tài)的終端地址數(shù)組n參數(shù)： 指定報(bào)告的一些狀態(tài)，用于所有終端；n參數(shù)： 是否立即檢查狀態(tài)標(biāo)識(shí)n參數(shù)： 狀態(tài)通知的最大頻率 ，報(bào)告間隔的最小時(shí)間n參數(shù)： 報(bào)告時(shí)長(zhǎng)。若則使用 中的默認(rèn)值n參數(shù)： 報(bào)告次數(shù)的上限，“0”為無(wú)限制n輸出：n3. n請(qǐng)求停止周期性的上報(bào)一個(gè)或者多個(gè)用戶的狀態(tài)信息。n接口類接口類 n1 1n通過(guò)本操作通過(guò)本操作 業(yè)務(wù)接入網(wǎng)關(guān)向應(yīng)用返回業(yè)務(wù)接入網(wǎng)關(guān)向應(yīng)用返回n

41、需要查詢的用戶狀態(tài)信息。需要查詢的用戶狀態(tài)信息。n2 2 n通過(guò)本操作智能業(yè)務(wù)接入網(wǎng)關(guān)查詢用戶狀態(tài)消息時(shí)，出通過(guò)本操作智能業(yè)務(wù)接入網(wǎng)關(guān)查詢用戶狀態(tài)消息時(shí)，出現(xiàn)的錯(cuò)誤現(xiàn)的錯(cuò)誤, ,通知業(yè)務(wù)應(yīng)用服務(wù)器。通知業(yè)務(wù)應(yīng)用服務(wù)器。n3 3n通過(guò)操作通過(guò)操作 ，當(dāng)狀態(tài)報(bào)告的最大時(shí)長(zhǎng)或者次數(shù)限制到時(shí)，當(dāng)狀態(tài)報(bào)告的最大時(shí)長(zhǎng)或者次數(shù)限制到時(shí)，則結(jié)束周期性的監(jiān)視狀態(tài)。則結(jié)束周期性的監(jiān)視狀態(tài)。n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力

42、介紹業(yè)務(wù)能力介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n概述n下行接口介紹n上行接口介紹n本服務(wù)用于實(shí)現(xiàn)符合中國(guó)電信的結(jié)構(gòu)體和標(biāo)準(zhǔn)的支付能力。n通過(guò)使用本業(yè)務(wù)能力接口，可以在用戶的銀行、虛擬的通訊帳戶上扣除因用戶使用服務(wù)，或者購(gòu)買商品而產(chǎn)生的費(fèi)用。同時(shí)，為適用中國(guó)電信現(xiàn)狀，本業(yè)務(wù)能力接口還增加了對(duì)用戶直接從電信統(tǒng)一門戶或者門戶購(gòu)買的商品的方式的支持，以及對(duì)派獎(jiǎng)活動(dòng)的支持。n注意：n本接口參考原2.0規(guī)范中的部分的內(nèi)容，但是與其不兼容。若要兼容2.0 規(guī)范需對(duì)本接口進(jìn)行擴(kuò)展。1.支付接口類：支付接口類：該接口用于用戶購(gòu)買商品或服務(wù)后，從用戶帳戶中扣除因該接口用于用戶購(gòu)買商品或服務(wù)后，從用戶帳戶中扣

43、除因商品交易或服務(wù)交易而發(fā)生的費(fèi)用，以及對(duì)派獎(jiǎng)活動(dòng)的商品交易或服務(wù)交易而發(fā)生的費(fèi)用，以及對(duì)派獎(jiǎng)活動(dòng)的支持。支持。包括包括4個(gè)操作：個(gè)操作：1.支付請(qǐng)求；支付請(qǐng)求；2.支付確認(rèn)；支付確認(rèn)；3.沖正；沖正；4.派獎(jiǎng)派獎(jiǎng)針對(duì)每個(gè)操作分別為：針對(duì)每個(gè)操作分別為：向請(qǐng)求扣費(fèi)；：向請(qǐng)求扣費(fèi)；： 通知扣費(fèi)完成；通知扣費(fèi)完成；： 發(fā)現(xiàn)問(wèn)題后，對(duì)原來(lái)的成功的交易進(jìn)行沖正；發(fā)現(xiàn)問(wèn)題后，對(duì)原來(lái)的成功的交易進(jìn)行沖正；： 向用戶的帳戶中充入獎(jiǎng)勵(lì)給用戶的金額；向用戶的帳戶中充入獎(jiǎng)勵(lì)給用戶的金額；2.2.通知接口：通知接口：該接口用于向發(fā)起通知類信息。包括該接口用于向發(fā)起通知類信息。包括2 2個(gè)：和。個(gè)：和。操作方法包括：

44、操作方法包括：1.1.購(gòu)買通知購(gòu)買通知該操作主要用于向通報(bào)：用戶已經(jīng)從電信統(tǒng)一接入門戶上該操作主要用于向通報(bào)：用戶已經(jīng)從電信統(tǒng)一接入門戶上訂購(gòu)了他們公司的產(chǎn)品或服務(wù)。訂購(gòu)了他們公司的產(chǎn)品或服務(wù)。2.2.支付通知支付通知該操作主要用于向通報(bào)：用戶預(yù)授權(quán)，可以進(jìn)行業(yè)務(wù)處理。該操作主要用于向通報(bào)：用戶預(yù)授權(quán)，可以進(jìn)行業(yè)務(wù)處理。包括通知的包括通知的 已經(jīng)對(duì)用戶預(yù)授權(quán)成功。已經(jīng)對(duì)用戶預(yù)授權(quán)成功。n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口

45、介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n 業(yè)務(wù)能力接口介紹業(yè)務(wù)能力接口介紹n概述n業(yè)務(wù)能力接口介紹（1）n業(yè)務(wù)能力接口介紹（2）n業(yè)務(wù)能力接口介紹（3）n業(yè)務(wù)能力接口介紹（4）n用于向用戶提供呈現(xiàn)信息，并將這些呈現(xiàn)的信息提供給訂閱這些信息的用戶。業(yè)務(wù)允許呈現(xiàn)信息被一個(gè)或更多的用戶獲取，同樣也允許注冊(cè)呈現(xiàn)信息。這些接口的典型的客戶端可以是呈現(xiàn)信息的提供者，也可以是呈現(xiàn)信息的使用者n序列圖n如 訂閱呈現(xiàn)信息序列圖n觀察者應(yīng)用向業(yè)務(wù)接入網(wǎng)關(guān)發(fā)送訂閱請(qǐng)求。業(yè)務(wù)接入網(wǎng)關(guān)通知服務(wù)器，等n服務(wù)器得到確認(rèn)消息后，業(yè)務(wù)接入網(wǎng)關(guān)將訂閱結(jié)果返回給觀察者應(yīng)用。n接口類接口類n使用本接口的客戶端的角色是觀察者。該接口

46、使用本接口的客戶端的角色是觀察者。該接口類只包含一個(gè)，即，是業(yè)務(wù)能力的基本操作。類只包含一個(gè)，即，是業(yè)務(wù)能力的基本操作。n用來(lái)在服務(wù)器上注冊(cè)用戶，只有用戶在注冊(cè)之用來(lái)在服務(wù)器上注冊(cè)用戶，只有用戶在注冊(cè)之后，用戶才能使用消息訂閱呈現(xiàn)者信息或者使后，用戶才能使用消息訂閱呈現(xiàn)者信息或者使用消息發(fā)布自身信息。用消息發(fā)布自身信息。n參數(shù)：（注冊(cè)用戶，即觀察者），（保持注冊(cè)參數(shù)：（注冊(cè)用戶，即觀察者），（保持注冊(cè)的存活時(shí)間，的存活時(shí)間，0表示注銷）表示注銷）n響應(yīng)消息：（注冊(cè)結(jié)果，響應(yīng)消息：（注冊(cè)結(jié)果，:成功或成功或:失?。ⅲㄗ⑹。ⅲㄗ?cè)狀態(tài)的超期時(shí)間）冊(cè)狀態(tài)的超期時(shí)間）n接口類接口類n使用本接口的

47、客戶端的角色是觀察者。觀察者使用本接口的客戶端的角色是觀察者。觀察者使用的本類的接口集合來(lái)獲取呈現(xiàn)的數(shù)據(jù)。再使用的本類的接口集合來(lái)獲取呈現(xiàn)的數(shù)據(jù)。再訂閱呈現(xiàn)數(shù)據(jù)后，觀察者可在選擇輪詢或通知訂閱呈現(xiàn)數(shù)據(jù)后，觀察者可在選擇輪詢或通知的模式來(lái)接收呈現(xiàn)數(shù)據(jù)。該接口類屬于下行接的模式來(lái)接收呈現(xiàn)數(shù)據(jù)。該接口類屬于下行接口?？凇該接口類包含四個(gè)：該接口類包含四個(gè)：n1) : 訂閱呈現(xiàn)信息訂閱呈現(xiàn)信息n2) : 獲取呈現(xiàn)信息獲取呈現(xiàn)信息(暫不實(shí)現(xiàn)暫不實(shí)現(xiàn))n3) : 通知模式請(qǐng)求呈現(xiàn)信息通知模式請(qǐng)求呈現(xiàn)信息(暫不實(shí)現(xiàn)暫不實(shí)現(xiàn))n4) : 主動(dòng)停止呈現(xiàn)信息通知主動(dòng)停止呈現(xiàn)信息通知(暫不實(shí)現(xiàn)暫不實(shí)現(xiàn))n1n本接

48、口用來(lái)調(diào)用用戶的呈現(xiàn)信息。假設(shè)觀察者之前已經(jīng)本接口用來(lái)調(diào)用用戶的呈現(xiàn)信息。假設(shè)觀察者之前已經(jīng)被鑒權(quán)，因此其標(biāo)識(shí)為可識(shí)別的，能與服務(wù)器總的簽約被鑒權(quán)，因此其標(biāo)識(shí)為可識(shí)別的，能與服務(wù)器總的簽約信息關(guān)聯(lián)。調(diào)用該方法，將聯(lián)系被呈現(xiàn)的用戶，并請(qǐng)求信息關(guān)聯(lián)。調(diào)用該方法，將聯(lián)系被呈現(xiàn)的用戶，并請(qǐng)求他授權(quán)給觀察者。由于這個(gè)過(guò)程涉及到用戶交互，因此他授權(quán)給觀察者。由于這個(gè)過(guò)程涉及到用戶交互，因此不會(huì)馬上就有響應(yīng)。將使用的不會(huì)馬上就有響應(yīng)。將使用的()來(lái)通知觀察者。來(lái)通知觀察者。n如果被呈現(xiàn)的用戶是一個(gè)組，這要聯(lián)系組中的每一個(gè)成如果被呈現(xiàn)的用戶是一個(gè)組，這要聯(lián)系組中的每一個(gè)成員，要求他們授權(quán)，對(duì)每個(gè)成員，觀察者都

49、要得到一個(gè)員，要求他們授權(quán)，對(duì)每個(gè)成員，觀察者都要得到一個(gè)通知，僅在訂閱完成后且被呈現(xiàn)的用戶允許對(duì)其屬性進(jìn)通知，僅在訂閱完成后且被呈現(xiàn)的用戶允許對(duì)其屬性進(jìn)行接入后，觀察者才能在使用行接入后，觀察者才能在使用()或者或者()之后獲取信息。之后獲取信息。 n參數(shù)說(shuō)明參數(shù)說(shuō)明:n請(qǐng)求消息參數(shù)：請(qǐng)求消息參數(shù)：表示一個(gè)空的數(shù)組表示所有屬性。描述用戶需要這些數(shù)表示一個(gè)空的數(shù)組表示所有屬性。描述用戶需要這些數(shù)據(jù)是為了哪個(gè)應(yīng)用而定。據(jù)是為了哪個(gè)應(yīng)用而定。 包含了在通知接口之后的消息中使用的關(guān)聯(lián)符。在這個(gè)包含了在通知接口之后的消息中使用的關(guān)聯(lián)符。在這個(gè)接口的級(jí)別上，訂閱是不過(guò)期的，盡管它可以呈現(xiàn)用戶接口的級(jí)別上，訂閱是不過(guò)期的，盡管它可以呈現(xiàn)用戶的底層被結(jié)束，請(qǐng)參考方法，參數(shù)用于標(biāo)識(shí)應(yīng)用是否取的底層被結(jié)束，請(qǐng)參考方法，參數(shù)用于標(biāo)識(shí)應(yīng)用是否取消對(duì)狀態(tài)的訂閱；消對(duì)狀態(tài)的訂閱；n響應(yīng)消息返回訂閱狀態(tài)的超期時(shí)間；響應(yīng)消息返回訂閱狀態(tài)的超期時(shí)間；n接口類：接口類：n 該接口類的接口都屬于上行接口（即回調(diào)該接口類的接口都屬于上行接口（即回調(diào)的接口），呈現(xiàn)使用者通過(guò)這些接口將相關(guān)信的接口），呈現(xiàn)使用者通過(guò)這些接口將相關(guān)信息通知給；其響應(yīng)結(jié)構(gòu)體都是空的。息通知給；其響應(yīng)結(jié)構(gòu)體都是空的。包括四個(gè)：