中國(guó)聯(lián)通家庭寬帶多媒體應(yīng)用平臺(tái)技術(shù)規(guī)范

1、 中國(guó)聯(lián)通公司企業(yè)標(biāo)準(zhǔn)qb/cuxxx2010中國(guó)聯(lián)通家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)技術(shù)規(guī)范與機(jī)頂盒終端接口分冊(cè)（v0.3）20010-0x-xx發(fā)布20010-0x-xx實(shí)施中國(guó)聯(lián)通公司發(fā)布中國(guó)聯(lián)通家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)技術(shù)規(guī)范-與機(jī)頂盒終端接口分冊(cè)(v0.3)中國(guó)聯(lián)通家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)技術(shù)規(guī)范與機(jī)頂盒終端接口分冊(cè)i目 錄 中國(guó)聯(lián)通家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)技術(shù)規(guī)范i 與機(jī)頂盒終端接口分冊(cè)i 目 錄i 前 言iv 中國(guó)聯(lián)通家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)技術(shù)規(guī)范v 與機(jī)頂盒終端接口分冊(cè)（v0.2）v1 范圍v2 規(guī)范性引用文件v3 縮略語(yǔ)v4 機(jī)頂盒與家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)接口框架vi

2、i4.1 機(jī)頂盒與業(yè)務(wù)管理系統(tǒng)接口viii4.2 機(jī)頂盒與業(yè)務(wù)運(yùn)營(yíng)平臺(tái)接口安全性要求viii5 機(jī)頂盒與業(yè)務(wù)管理系統(tǒng)接口（u1接口）ix5.1 u1接口描述圖ix5.2 接口時(shí)序ix5.3 接口協(xié)議內(nèi)容xii6 機(jī)頂盒與epg服務(wù)系統(tǒng)接口（u2接口）xxv6.1 機(jī)頂盒訪問(wèn)epg首頁(yè)接口（u2-1）xxv6.2 機(jī)頂盒業(yè)務(wù)使用接口(u2-2)xxvii7 機(jī)頂盒與增值服務(wù)平臺(tái)接口（u3接口）xxviii7.1 u3接口描述圖xxviii7.2 機(jī)頂盒與b/s增值服務(wù)接口（u3-1）xxviii7.3 機(jī)頂盒與c/s增值服務(wù)接口（u3-2）xxix8 機(jī)頂盒與內(nèi)容分發(fā)系統(tǒng)接口（u4-t接口）xx

3、x8.1 u4-t接口描述xxx8.2 流控制方法描述xxxiv8.3 機(jī)頂盒單播接口（u4-t-1）xlvii8.4 機(jī)頂盒組播接口（s4-t-2）l8.5 機(jī)頂盒單播時(shí)移接口（s4-t-3）li8.6 機(jī)頂盒組播時(shí)移接口（u4-t-4）liii9 互聯(lián)網(wǎng)電視機(jī)頂盒與內(nèi)容分發(fā)系統(tǒng)之間的接口（u4-h）lix9.1 總體說(shuō)明lix9.2 傳輸方式lx9.3 封裝格式lxi9.4 協(xié)議描述lxiii10 機(jī)頂盒與通信服務(wù)系統(tǒng)接口（u5接口）lxviii10.1 消息系統(tǒng)接口lxviii10.2 視頻通信系統(tǒng)接口（待定義）lxxxiii 附錄a：字段類型及通用狀態(tài)數(shù)據(jù)字典84 a.1基本數(shù)據(jù)類型8

4、5 a.2數(shù)據(jù)字典（注：全部重新整理）87 a.2.1基本參數(shù)類型87 a.2.2復(fù)合參數(shù)類型定義91 a.3soap的faultcode 92 a.3.1機(jī)頂盒 faultcode92 a.3.2服務(wù)器faultcode92 a.3.3 http請(qǐng)求響應(yīng)碼93 a.3.3 rtsp請(qǐng)求響應(yīng)碼94 附錄b：soap rpc方式實(shí)現(xiàn)模版96 b.1 xsd文件描述96 b.2 wsdl描述96 附錄c：用戶編碼規(guī)則97 附錄d：擴(kuò)展js集合97 d.1 authentication對(duì)象98 d.1.1 獲取鑒權(quán)信息98 d.1.2 設(shè)置/獲取業(yè)務(wù)參數(shù)99 d.1.3 啟動(dòng)后臺(tái)升級(jí)功能100 d.

5、2 mediaplayer對(duì)象101 d.2.1 mediaplayer的屬性101 d.2.2 mediaplayer的方法105 d.2.3 媒體相關(guān)參數(shù)的描述111 d.2.4 將媒體參數(shù)封裝為json對(duì)象113 d.2.5 mediaplayer控制的媒體流的生命周期113 d.2.6 mediaplayer相關(guān)的事件114 d.2.7用戶通過(guò)“頻道”鍵進(jìn)入頻道播放過(guò)程示例115 d.3 navigation對(duì)象118 d.3.1 navigation對(duì)象的屬性:118 d.3.2 navigation對(duì)象的方法:118 d.4 utility對(duì)象119 d.4.1 utility對(duì)象

6、的方法:119 d.5 event對(duì)象120 d.5.1 event對(duì)象的結(jié)構(gòu):120 d.5.2 event類型:121 d.5.3 event消息:121 d.5.4 event詳細(xì)信息的封裝方式123 d.6 cu_network對(duì)象124 d.6.1 ethernet對(duì)象124 附錄e：fec技術(shù)要求125 e.1 fec幀格式125 e.1.1 rtp頭要求125 e.1.2 fec結(jié)構(gòu)126 e.2 同步方式127 e.3 fec算法127 e.3.1 基本要求:127 e.3.2 解碼api定義:128 附錄f：arq技術(shù)要求129 f.1 基本要求129 f.2 交互流程130

7、 f.3消息格式132 f.3.1 get-parameter請(qǐng)求消息：132 f.3.2 get_parameter響應(yīng)消息：133 附錄g:流量控制技術(shù)要求134 g.1基本要求134 g.2交互流程136前 言本技術(shù)規(guī)范是中國(guó)聯(lián)通家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)與機(jī)頂盒終端之間的接口規(guī)范。本技術(shù)要求包含以下幾方面說(shuō)明：業(yè)務(wù)描述、接口功能、接口協(xié)議等部分。本標(biāo)準(zhǔn)由中國(guó)聯(lián)通公司產(chǎn)品創(chuàng)新部提出。本標(biāo)準(zhǔn)負(fù)責(zé)起草單位：本標(biāo)準(zhǔn)主要起草人： 本標(biāo)準(zhǔn)的修改和解釋權(quán)屬中國(guó)聯(lián)通公司產(chǎn)品創(chuàng)新部。中國(guó)聯(lián)通家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)技術(shù)規(guī)范與機(jī)頂盒終端接口分冊(cè)（v0.2）1 范圍本規(guī)范規(guī)定了機(jī)頂盒與家庭寬帶多媒體應(yīng)用業(yè)

8、務(wù)平臺(tái)的接口，包括與業(yè)務(wù)管理系統(tǒng)、epg服務(wù)系統(tǒng)、增值服務(wù)系統(tǒng)、ts內(nèi)容分發(fā)系統(tǒng)、通信服務(wù)系統(tǒng)（待定）以及與終端管理系統(tǒng)之間的詳細(xì)接口協(xié)議、字段內(nèi)容。本規(guī)范適用于機(jī)頂盒與家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)、終端管理系統(tǒng)之間的接口開(kāi)發(fā)。2 規(guī)范性引用文件下列文件中的條款通過(guò)本標(biāo)準(zhǔn)的引用而成為本標(biāo)準(zhǔn)的條款。凡是注日期的引用文件，其隨后所有的修改單（不包括勘誤的內(nèi)容）或修訂版均不適用于本標(biāo)準(zhǔn)，然而，鼓勵(lì)根據(jù)本標(biāo)準(zhǔn)達(dá)成協(xié)議的各方研究是否可使用這些文件的最新版本。凡是不注日期的引用文件，其最新版本適用于本標(biāo)準(zhǔn)。rfc1889：a transport protocol for real-time applicat

9、ionsrfc2326：real time streaming protocolrfc2327：session description protocolrfc3611：rtp control protocol extended reportsrfc3711：the secure real-time transport protocoliso/iec 13818-1 2000: generic coding of moving pictures and associated audio informationitu-t rec. h.222.0 -2000 - amendment 3: tran

10、sport of avc video data over itu-t recommendation h.222.0rfc2616: hypertext transfer protocolrfc3275: extensible makeup languagew3c: web services description language3 縮略語(yǔ)avsaudio video coding standard數(shù)字音視頻編解碼技術(shù)標(biāo)準(zhǔn)catconditional access table有條件接收表cpe customer premises equipment 用戶終端設(shè)備drmdigital right

11、s management 數(shù)字版權(quán)管理epgelectronic programmer guide電子節(jié)目單httphypertext transfer protocol 超文本傳輸協(xié)議https hypertext transfer protocol secure安全超文本傳輸協(xié)議iecinternational electrotechnical commission國(guó)際電工委員會(huì)igmpinternet group management protocol 互連網(wǎng)組管理協(xié)議ip internet protocol 網(wǎng)絡(luò)協(xié)議 isointernational organization for

12、standardization國(guó)際標(biāo)準(zhǔn)化組織mac media access control 媒體訪問(wèn)控制層mpeg2moving picture experts group 2 活動(dòng)圖像專家組2mptsmultiple programs transport stream 多節(jié)目傳輸流ntpnetwork time protocol 網(wǎng)絡(luò)時(shí)間協(xié)議os operation system 操作系統(tǒng)pat program association table 節(jié)目組合表pcrprogram clock reference 節(jié)目時(shí)鐘參考pes packet elementary stream 打包的基本

13、碼流pmtprogram map table 節(jié)目映射表psi program specific information 節(jié)目專有信息rpc remote procedure call 遠(yuǎn)程過(guò)程調(diào)用rtcpreal-time transport control protocol 實(shí)時(shí)傳輸控制協(xié)議rtpreal-time transport protocol 實(shí)時(shí)傳輸協(xié)議rtspreal-time transport streaming protocol 實(shí)時(shí)傳輸流媒體協(xié)議sipsession initiation protocol 會(huì)話初始協(xié)議sdp session description p

14、rotocol 會(huì)話描述協(xié)議soapsimple object access protocol 簡(jiǎn)單對(duì)象訪問(wèn)協(xié)議sptssingle programs transport stream 單節(jié)目傳輸流stbset top box 機(jī)頂盒stb-sim stb security identification module 機(jī)頂盒安全識(shí)別模塊tcp transmission control protocol 傳輸控制協(xié)議tsts transport stream 傳送流udp user datagram protocol 用戶數(shù)據(jù)報(bào)協(xié)議url uniform resource locator 統(tǒng)一資

15、源定位符 utccoordinated universal time 協(xié)調(diào)世界時(shí)/世界標(biāo)準(zhǔn)時(shí)間vod video on demand 視頻點(diǎn)播 wsdl web service description language web服務(wù)描述語(yǔ)言xmlextensible markup language 可擴(kuò)展標(biāo)記語(yǔ)言xsd xml schema infoset model xml數(shù)據(jù)定義文件4 機(jī)頂盒與家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)接口框架機(jī)頂盒與家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)間的接口主要有：與業(yè)務(wù)管理系統(tǒng)間的接口、與業(yè)務(wù)管理系統(tǒng)（互聯(lián)網(wǎng)電視）間的接口、與epg服務(wù)系統(tǒng)間的接口、與增值業(yè)務(wù)系統(tǒng)間的接口、與內(nèi)

16、容分發(fā)系統(tǒng)間的接口、與內(nèi)容服務(wù)系統(tǒng)（互聯(lián)網(wǎng)電視）間的接口、與通信服務(wù)系統(tǒng)間的接口，以及與終端管理系統(tǒng)間的接口。其中，終端管理系統(tǒng)可以獨(dú)立于家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)單獨(dú)構(gòu)建，也可作為家庭寬帶多媒體應(yīng)用業(yè)務(wù)平臺(tái)內(nèi)部子系統(tǒng)，與其他系統(tǒng)之間松耦合。4.1 機(jī)頂盒與業(yè)務(wù)管理系統(tǒng)接口u1-t接口：機(jī)頂盒與業(yè)務(wù)管理系統(tǒng)接口。承載協(xié)議：http get/post機(jī)頂盒通過(guò)u1接口與業(yè)務(wù)管理系統(tǒng)交互，完成開(kāi)機(jī)用戶應(yīng)用認(rèn)證、頻道列表獲取、業(yè)務(wù)入口地址獲取、用戶注銷等功能。u1-h接口：互聯(lián)網(wǎng)電視終端與業(yè)務(wù)管理系統(tǒng)（互聯(lián)網(wǎng)電視）接口u2接口：機(jī)頂盒與epg服務(wù)系統(tǒng)接口。 承載協(xié)議：http post/get機(jī)頂盒

17、通過(guò)s2接口與epg服務(wù)系統(tǒng)交互，完成獲得epg首頁(yè)及其他epg資源、epg切換等功能。u3接口：機(jī)頂盒與增值服務(wù)平臺(tái)接口。 承載協(xié)議：http post/get、自定義協(xié)議機(jī)頂盒通過(guò)s3接口與增值服務(wù)平臺(tái)交互，完成基于b/s和c/s形式的增值服務(wù)。u4-t接口：機(jī)頂盒與內(nèi)容分發(fā)系統(tǒng)接口 承載協(xié)議：mpeg2-ts、rtsp，rtp，rtcp 機(jī)頂盒通過(guò)u4-t接口與ts內(nèi)容分發(fā)系統(tǒng)交互，完成點(diǎn)播、組播、單播時(shí)移和組播時(shí)移等功能u4-h接口：互聯(lián)網(wǎng)電視終端與內(nèi)容分發(fā)系統(tǒng)接口u5接口：機(jī)頂盒與通信服務(wù)系統(tǒng)接口承載協(xié)議：sip、http、soap機(jī)頂盒通過(guò)s5接口與通信服務(wù)系統(tǒng)交互，完成視頻通信、

18、短信、彩信等業(yè)務(wù)交互u6接口：機(jī)頂盒與終端管理系統(tǒng)接口承載協(xié)議：http、soap、tr069機(jī)頂盒通過(guò)u6接口與終端管理系統(tǒng)交互，完成終端管理、軟件升級(jí)、性能監(jiān)測(cè)等功能。4.2 機(jī)頂盒與業(yè)務(wù)運(yùn)營(yíng)平臺(tái)接口安全性要求機(jī)頂盒與iptv業(yè)務(wù)運(yùn)營(yíng)平臺(tái)接口交互的安全性，通過(guò)iptv用戶密碼（password）或iptv sim卡密鑰（ickey）、用戶令牌（usertoken）協(xié)同完成。終端在接入認(rèn)證過(guò)程中，使用用戶密碼或iptv sim卡密鑰通過(guò)安全認(rèn)證，并獲取usertoken作為當(dāng)前交互過(guò)程的認(rèn)證憑據(jù)。usertoken在超過(guò)有效期、終端瀏覽器關(guān)閉連接、終端退出業(yè)務(wù)使用后失效。當(dāng)usertoken

19、超出其有效期時(shí)，epg服務(wù)系統(tǒng)判定其為失效，并自動(dòng)將終端重定向至業(yè)務(wù)管理系統(tǒng)進(jìn)行重新認(rèn)證，認(rèn)證結(jié)束繼續(xù)使用服務(wù)。當(dāng)終端接收到響應(yīng)錯(cuò)誤代碼或發(fā)生其他錯(cuò)誤，導(dǎo)致無(wú)法繼續(xù)使用iptv業(yè)務(wù)時(shí)，則重新發(fā)起到業(yè)務(wù)管理系統(tǒng)的應(yīng)用認(rèn)證流程，應(yīng)用認(rèn)證結(jié)束重定向訪問(wèn)epg首頁(yè)。5 機(jī)頂盒與業(yè)務(wù)管理系統(tǒng)接口（u1接口）5.1 u1接口描述圖機(jī)頂盒與業(yè)務(wù)管理系統(tǒng)之間具有以下接口功能模塊：1) 互聯(lián)網(wǎng)電視終端開(kāi)機(jī)注冊(cè)接口（u1-h-1）2) 互聯(lián)網(wǎng)電視終端認(rèn)證接口（u1-h-2）3) iptv機(jī)頂盒開(kāi)機(jī)認(rèn)證接口（u1-t-1）4) iptv頻道列表獲取接口（u1-t-2）5) iptv業(yè)務(wù)入口列表獲取接口（u1-t-3

20、）6) iptv機(jī)頂盒注銷接口（u1-t-4）5.2 接口時(shí)序5.2.1 互聯(lián)網(wǎng)電視機(jī)頂盒開(kāi)機(jī)注冊(cè)訪問(wèn)流程互聯(lián)網(wǎng)電視機(jī)頂盒終端注冊(cè)流程圖互聯(lián)網(wǎng)電視機(jī)頂盒終端訪問(wèn)流程圖5.2.2 互聯(lián)網(wǎng)電視訂購(gòu)/點(diǎn)播/使用流程5.2.3 iptv機(jī)頂盒開(kāi)機(jī)應(yīng)用認(rèn)證流程圖機(jī)頂盒開(kāi)機(jī)應(yīng)用認(rèn)證流程圖1. 用戶身份認(rèn)證及獲取資源服務(wù)器列表l 機(jī)頂盒向業(yè)務(wù)管理系統(tǒng)通過(guò)http get方式發(fā)送用戶身份認(rèn)證請(qǐng)求，上傳信息包括userid；l 業(yè)務(wù)管理系統(tǒng)產(chǎn)生隨機(jī)encrytoken字段，該字段用于認(rèn)證加密的挑戰(zhàn)字；l 業(yè)務(wù)管理系統(tǒng)通過(guò)http response返回包含擴(kuò)展加密js腳本、encrytoken等內(nèi)容的頁(yè)面；l 機(jī)

21、頂盒通過(guò)調(diào)用擴(kuò)展js函數(shù)對(duì)encrytoken、userid、stbid、ip、mac等信息進(jìn)行加密后，通過(guò)http post方式發(fā)送到業(yè)務(wù)管理系統(tǒng)；l 業(yè)務(wù)管理系統(tǒng)進(jìn)行身份驗(yàn)證，驗(yàn)證通過(guò)后通過(guò)http response以擴(kuò)展js腳本的形式返回認(rèn)證結(jié)果并設(shè)置資源服務(wù)器列表等信息；l 機(jī)頂盒使用認(rèn)證返回的升級(jí)服務(wù)器地址，通過(guò)本地升級(jí)功能進(jìn)行版本檢查并按需要進(jìn)行升級(jí)。2. 獲取頻道列表l 機(jī)頂盒通過(guò)http get的請(qǐng)求方式，向業(yè)務(wù)管理系統(tǒng)發(fā)起獲取頻道列表的請(qǐng)求；l 業(yè)務(wù)管理系統(tǒng)通過(guò)http response以擴(kuò)展js腳本的形式返回頻道列表。3. 獲取業(yè)務(wù)入口列表l 機(jī)頂盒通過(guò)http get的請(qǐng)

22、求方式，向業(yè)務(wù)管理系統(tǒng)發(fā)起獲取業(yè)務(wù)入口列表的請(qǐng)求；l 業(yè)務(wù)管理系統(tǒng)通過(guò)http response以擴(kuò)展js腳本的形式返回業(yè)務(wù)入口列表。4. 用戶注銷l 用戶關(guān)機(jī)或退出業(yè)務(wù)，主動(dòng)發(fā)起注銷請(qǐng)求；l 業(yè)務(wù)管理系統(tǒng)執(zhí)行用戶注銷操作，并通過(guò)http response返回空內(nèi)容。5.3 接口協(xié)議內(nèi)容本接口采用http get、post/http response+js的方式承載，請(qǐng)求采用http get、post的方式，采用url參數(shù)、post內(nèi)容的方式傳遞所需的參數(shù)，返回內(nèi)容采用js的方式組織、傳遞、操作。5.3.1 互聯(lián)網(wǎng)電視終端注冊(cè)激活1、注冊(cè)激活接口方式：http get接口方向：互聯(lián)網(wǎng)電視終端

23、互聯(lián)網(wǎng)電視平臺(tái)接口說(shuō)明：用戶開(kāi)機(jī)首先發(fā)送tvid（head頭中）以及被分配到的user-key（head頭中,如果未注冊(cè)則該key為空）到互聯(lián)網(wǎng)電視平臺(tái)。 請(qǐng)求消息：表5-3-1-1用戶注冊(cè)激活請(qǐng)求參數(shù)說(shuō)明名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選action用戶請(qǐng)求行為string10m消息示例：http:/domain/service?action=active2、回應(yīng)消息接口方式：http get接口方向：互聯(lián)網(wǎng)電視平臺(tái)互聯(lián)網(wǎng)電視終端接口描述：業(yè)務(wù)管理系統(tǒng)校驗(yàn)用戶發(fā)送的tvid是否已經(jīng)注冊(cè)，如果是則進(jìn)入下發(fā)一個(gè)臨時(shí)token作為認(rèn)證加密串的組成部分進(jìn)入開(kāi)機(jī)認(rèn)證流程。消息示例：active的屬性

24、名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選code激活校驗(yàn)錯(cuò)誤碼，0-已被激活；1-未被激活，如果未被激活進(jìn)入流程注冊(cè)激活(直接將用戶 重定向到運(yùn)營(yíng)支撐系統(tǒng)，由運(yùn)營(yíng)支撐系統(tǒng)負(fù)責(zé)彈出注冊(cè)頁(yè)面由用戶輸入)，如果激活則進(jìn)入認(rèn)證流程string1mdescription錯(cuò)誤碼描述string10mencrypt-token臨時(shí)token，加密串的組成部分,code為0時(shí)有效string10mregister-url注冊(cè)地址，code為1時(shí)有效string10m5.3.2 互聯(lián)網(wǎng)電視終端認(rèn)證1、開(kāi)機(jī)認(rèn)證接口方式：http get接口方向：互聯(lián)網(wǎng)電視終端 互聯(lián)網(wǎng)電視平臺(tái)接口說(shuō)明：用戶開(kāi)機(jī)發(fā)送認(rèn)證的加密字串信息到

25、互聯(lián)網(wǎng)電視平臺(tái)。 請(qǐng)求消息：http:/domain/service?action=auth&token=djkde334jklieakjdiekjdkjakdieeoir03334kjkdljksjoiejkfjkjkjk表5-3-1-2用戶開(kāi)機(jī)認(rèn)證請(qǐng)求參數(shù)說(shuō)明名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選action用戶請(qǐng)求行為，參見(jiàn)消息約定string1mdescription請(qǐng)求認(rèn)證的加密串，加密算法為3des+base64，加密的串組成為下發(fā)的用戶標(biāo)識(shí)+加密臨時(shí)token，加密key為下發(fā)的加密keystring10m2、回應(yīng)消息直接重定向到門戶首頁(yè)。5.3.3 iptv機(jī)頂盒認(rèn)證1、認(rèn)證請(qǐng)求

26、承載協(xié)議：http get接口方向：機(jī)頂盒 業(yè)務(wù)管理系統(tǒng)調(diào)用接口：http:/iptvauthdomain/authenticationurl接口功能：機(jī)頂盒調(diào)用頁(yè)面請(qǐng)求進(jìn)行用戶開(kāi)機(jī)認(rèn)證請(qǐng)求備注說(shuō)明：采用url傳遞參數(shù)表5-3-1-3用戶認(rèn)證請(qǐng)求名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選userid用戶登錄業(yè)務(wù)帳號(hào)string36maction當(dāng)前操作，開(kāi)機(jī)認(rèn)證時(shí)為 “l(fā)ogin”string10m認(rèn)證請(qǐng)求示例：http:/iptvauthdomain/authenticationurl?userid=12345678&action=login2、認(rèn)證請(qǐng)求挑戰(zhàn)字響應(yīng)承載協(xié)議：http respons

27、e接口方向：業(yè)務(wù)管理系統(tǒng) 機(jī)頂盒接口功能：返回頁(yè)面要求機(jī)頂盒進(jìn)行信息加密認(rèn)證備注說(shuō)明：采用擴(kuò)展js腳本傳遞參數(shù)及后續(xù)指令表5-3-1-4 用戶認(rèn)證請(qǐng)求挑戰(zhàn)字響應(yīng)名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選encrytoken業(yè)務(wù)管理系統(tǒng)為該用戶分配的臨時(shí)身份證明，只用于認(rèn)證加密string32m注：認(rèn)證響應(yīng)內(nèi)容包含js方式的authentication對(duì)象cugetauthinfo接口函數(shù)，要求瀏覽器支持。認(rèn)證請(qǐng)求響應(yīng)示例：http/1.1 200 okdate: sat, 26 aug 2006 07:30:58 gmtcache-control: no-store, no-cache, must-

28、revalidate, post-check=0, pre-check=0pragma: no-cachecontent-length: 450content-type: text/htmlfunction doauth()document.authform.authenticator.value= authentication.cugetauthinfo(d6d0b9fab5e7d0c5c9cfbaa3d4bad6c6);document.authform.submit();3、機(jī)頂盒上傳認(rèn)證信息承載協(xié)議：http（post）接口方向：機(jī)頂盒 業(yè)務(wù)管理系統(tǒng)調(diào)用接口：由認(rèn)證請(qǐng)求返回頁(yè)面確定接口

29、功能：機(jī)頂盒調(diào)用post請(qǐng)求上傳認(rèn)證信息備注說(shuō)明：采用post信息傳遞參數(shù)表5-3-1-5用戶上傳認(rèn)證信息請(qǐng)求名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選userid用戶登錄業(yè)務(wù)帳號(hào)string36mauthenticator加密后的參數(shù)串，包含各個(gè)輸入?yún)?shù)，具體參數(shù)和加密方法見(jiàn)下表stringm表5-3-1-6請(qǐng)求authenticator包含參數(shù)名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選random隨機(jī)數(shù)字digit string=8mencrytoken用于autenticator產(chǎn)生的臨時(shí)tokenstring32muserid用戶業(yè)務(wù)編號(hào)string20mstbid機(jī)頂盒編號(hào) string32mi

30、pip地址string39mmac機(jī)頂盒的mac地址，格式為：xx:xx:xx:xx:xx:xxstring17mreserved預(yù)留string64m說(shuō)明：l authenticator表示加密后的參數(shù)串，具體參見(jiàn)附錄d.1.1獲取認(rèn)證信息函數(shù)的返回值描述。認(rèn)證請(qǐng)求示例：post /authurl http/1.1accept: */*host: *.*.*.*user-agent: mozilla/4.73connection: closereferer: http:/ *.*.*.*/*pragma: no-cachecontent-type: application/x-www-for

31、m-urlencodedcontent-length: *authenticator=*&userid=*4、認(rèn)證響應(yīng)承載協(xié)議：http response接口方向：業(yè)務(wù)管理系統(tǒng) 機(jī)頂盒接口功能：返回認(rèn)證結(jié)果頁(yè)面，并設(shè)置資源服務(wù)器信息備注說(shuō)明：采用擴(kuò)展js腳本傳遞參數(shù)及后續(xù)指令表5-3-1-7認(rèn)證響應(yīng)名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選epgdomainepg的域名，格式類似于：http:/xxx.yyy.zzz:port/port默認(rèn)為80string256mepgdomainbackup備份epg的域名，格式類似于：http:/xxx.yyy.zzz:port/port默認(rèn)為80string

32、256oupgradedomain升級(jí)服務(wù)器的域名，格式是：http:/xxx.yyy.zzz:port/port默認(rèn)為80string256mupgradedomainbackup備份升級(jí)服務(wù)器的域名，格式是：http:/xxx.yyy.zzz:port/port默認(rèn)為80string256omanagementdomain管理服務(wù)器的domain，格式是：http:/xxx.yyy.zzz:port/port默認(rèn)為80string256mmanagementdomainbackup備份管理服務(wù)器的domain，格式是：http:/xxx.yyy.zzz:port/port默認(rèn)為80stri

33、ng256ontpdomain時(shí)鐘同步服務(wù)器地址string256mntpdomainbackup備份時(shí)鐘同步服務(wù)器地址string256ousertoken業(yè)務(wù)管理系統(tǒng)為該用戶分配的臨時(shí)身份證明string32mepggroupnmb用戶對(duì)應(yīng)的epg分組信息標(biāo)識(shí)，格式：a1a2b1b2b3c1c2c3a1a2：省份標(biāo)識(shí)，參照vnet標(biāo)識(shí)方法，如：l sh：上海l hi：海南b1b2b3：用戶類型標(biāo)識(shí)；c1c2c3：保留string8omsdomain消息系統(tǒng)入口地址string256omsdomainbackup備份消息系統(tǒng)入口地址string256o說(shuō)明：1、 如認(rèn)證失敗，則直接返回htt

34、p 200，然后重定向到手工登錄或修改用戶名密碼的頁(yè)面，并提示錯(cuò)誤信息；2、 業(yè)務(wù)管理系統(tǒng)下發(fā)配置頁(yè)面，包含指定參數(shù)和腳本，執(zhí)行過(guò)程：a) 采用js函數(shù)的方式設(shè)置各參數(shù)；b) 并調(diào)用js函數(shù)啟動(dòng)版本升級(jí)檢查功能（要求后臺(tái)執(zhí)行）；c) 攜帶usertoken、epggroupnmb參數(shù)轉(zhuǎn)入廠商平臺(tái)入口點(diǎn)；3、 需擴(kuò)展設(shè)置參數(shù)的js函數(shù)authentication 對(duì)象的cusetconfig；4、 需擴(kuò)展后臺(tái)啟動(dòng)升級(jí)功能的js函數(shù)custartupdate；5、 認(rèn)證成功后usertoken可通過(guò)cookie、session的方式進(jìn)行保存。認(rèn)證請(qǐng)求響應(yīng)示例：http/1.1 200 okset-

35、cookie: usertoken=7aa501c7143c22983b5e0a6559361001;jssessionid=ade12314da23; path=/content-type: text/html;charset=gbkcontent-length: 381date: thu, 19 oct 2006 08:50:14 gmtfunction authfinish()authentication.cusetconfig (usertoken, *);authentication.cusetconfig (epgdomain, *);authentication.cusetcon

36、fig (epgdomainbackup, *);authentication.cusetconfig (managementdomain, *);authentication.cusetconfig(managementdomainbackup,*);authentication.cusetconfig (upgradedomain, *);authentication.cusetconfig (ntpdomain, *);authentication.cusetconfig (epggroupnmb, *);authentication.custartupdate();document.l

37、ocation= http:/getchannellisturl;5.3.4 頻道列表獲取1、頻道列表獲取請(qǐng)求承載協(xié)議：http get接口方向：機(jī)頂盒 業(yè)務(wù)管理系統(tǒng)調(diào)用接口：http:/iptvauthdomain/getchannellisturl接口功能：終端調(diào)用頁(yè)面請(qǐng)求獲得直播頻道列表備注說(shuō)明：可采用cookie、session的方式傳遞usertoken表5-3-2-1 頻道列表獲取請(qǐng)求參數(shù)名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選usertoken業(yè)務(wù)管理系統(tǒng)為該用戶分配的臨時(shí)身份證明，采用cookie、session方式傳遞string32m頻道列表獲取請(qǐng)求示例：http get /g

38、etchannellisturl http/1.1host: iptvauthdomainaccept: */*user-agent: cookie: usertoken=7aa501c7143c22983b5e0a6559361001;jssessionid=ade12314da232、頻道列表獲取響應(yīng)承載協(xié)議：http response接口方向：業(yè)務(wù)管理系統(tǒng) 機(jī)頂盒接口功能：返回頁(yè)面進(jìn)行頻道列表的下發(fā)，以及對(duì)頻道的fec糾錯(cuò)功能的支持。備注說(shuō)明：采用擴(kuò)展js腳本傳遞頻道列表及后續(xù)指令表5-3-2-2 頻道列表獲取響應(yīng)名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選channelcount用戶可觀看的頻

39、道總數(shù)unsignedint4mchannellist用戶可觀看的頻道信息列表channelinfostructm表5-3-2-3channelinfostruct元素定義名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選channelid默認(rèn)頻道的channelid信息（如果服務(wù)器端沒(méi)有頻道則返回字符串“null”）string8mchannelname頻道名稱（如果服務(wù)器端沒(méi)有頻道則返回字符串“null”）string16muserchannelid用戶頻道編號(hào)（如果服務(wù)器端沒(méi)有頻道則返回-1）int4mchannelurl組播url(igmp:/組播地址:端口)/單播url（rtsp:/單播地址:端口

40、/路徑）/httl url（http:/服務(wù)地址:端口/路徑）如果服務(wù)器端沒(méi)有頻道則返回字符串“null”string256mtimeshift頻道是否支持時(shí)移1：支持0：不支持boolean1mchannelsdp頻道的sdp信息string256mtimeshifturl頻道的時(shí)移地址當(dāng)該節(jié)目不支持時(shí)移，該值無(wú)意義；當(dāng)該節(jié)目為單播直播，該值無(wú)意義。string256mchannellogostruct臺(tái)標(biāo)顯示的參數(shù)結(jié)構(gòu)，如果沒(méi)有，強(qiáng)制用空值填充，可以不處理channellogostructmchanneltype頻道類型，具體數(shù)值待定string16ochannelpurchased用戶授

41、權(quán)標(biāo)識(shí)booleanmchannelfecport頻道支持fec的端口號(hào)，若該頻道支持fec則填寫端口號(hào)，否則為空int16mchannellogostruct定義如下：表5-3-2-4 channellogostruct元素定義名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）channellogurl臺(tái)標(biāo)圖片的urlstring256positionx以屏幕和圖標(biāo)左上角為準(zhǔn)的臺(tái)標(biāo)顯示橫坐標(biāo)位置int4positiony以屏幕和圖標(biāo)左上角為準(zhǔn)的臺(tái)標(biāo)顯示縱坐標(biāo)位置int4begintime臺(tái)標(biāo)顯示開(kāi)始時(shí)間，與頻道開(kāi)始播放開(kāi)始時(shí)間相對(duì)的時(shí)間（以秒為單位）unsigened int4interval臺(tái)標(biāo)兩次顯示之間的間

42、隔時(shí)間（單位為秒，-1為臺(tái)標(biāo)一直顯示，此時(shí)忽略lasting；0代表顯示一次）int4lasting每次出現(xiàn)臺(tái)標(biāo)后的顯示時(shí)間，lasting的值一定要小于intervalunsigned int4注：認(rèn)證響應(yīng)內(nèi)容包含js方式的authentication對(duì)象的cusetconfig接口函數(shù)，要求瀏覽器支持。頻道列表獲取請(qǐng)求響應(yīng)示例：http/1.1 200 okcontent-type: text/html;charset=gbkcontent-length: 381date: thu, 19 oct 2006 08:50:14 gmtfunction configchannel ()auth

43、entication.cusetconfig (channelcount, 3);authentication.cusetconfig(channel,channelid=1,channelname=stv1,userchannelid=1,channelurl=igmp:/:3000,timeshift=1,channelsdp=/channel1.sdp,timeshifturl=rtsp://channel1,channellogurl=/log1.gif,

44、positionx=5,positiony=5,begintime=10,interval=0,lasting=10,channeltype=type1,channelpurchased=0，channelfecport=);authentication.cusetconfig(channel,channelid=2,channelname=stv2,userchannelid=2,channelurl=rtsp://channel2,timeshift=1,channelsdp=,timeshifturl=rtsp://channel

45、2,channellogurl=/log2.gif,positionx=5,positiony=5,begintime=10,interval=0,lasting=10,channeltype=type1,channelpurchased=0, channelfecport=2343);authentication.cusetconfig(channel,channelid=3,channelname=stv3,userchannelid=3,channelurl=/channel3.jsp,timeshi

46、ft=1,channelsdp=,timeshifturl=,channellogurl=,positionx=5,positiony=5,begintime=10,interval=0,lasting=10,channeltype=type1,channelpurchased=0, channelfecport=2342);document.location= http:/getservicelisturl;5.3.5 業(yè)務(wù)入口列表獲取1、業(yè)務(wù)入口列表獲取請(qǐng)求承載協(xié)議：http get接口方向：機(jī)頂盒 業(yè)務(wù)管理系統(tǒng)調(diào)用接口：http:/iptvauthdomain/getservicelisturl接口功能：終端調(diào)用頁(yè)面請(qǐng)求獲得業(yè)務(wù)列表備注說(shuō)明：可采用cookie、session的方式傳遞usertoken表5-3-3-1業(yè)務(wù)入口列表獲取請(qǐng)求名稱說(shuō)明數(shù)據(jù)類型長(zhǎng)度（字節(jié)）是否必選usertoken業(yè)務(wù)管理系統(tǒng)為該用戶分配的臨時(shí)身份證明，采用cookie、session方式傳遞string32m業(yè)務(wù)入口列表獲取請(qǐng)求示例：http get / gets