2024互动电视数字媒体服务综合集成平台接口技术条件

目前 引 终端UA信息接入规 终端CDN接入规 HttpHeader参数规范要 终端提供JS函 播放URL规范要 组 包 运 贮 附录A（规范性附录）错误代 附录B（规范性附录）ISO/IEC13828-1TS格 VOD接入流程，减少终端VOD的交互指令长度。当点播和EPG时移时，云平台将播放信息通过云终端软件传递给机顶盒，机顶盒开始向云媒体接入平台申请播放，云媒体接入平台完成与CDN的交互端。GB/T17975.1-20101GB/T28161-2011GB/T28160-2011GB/T14857-1993SJ/T10351-1993IETFRFC1889RTP:ATransportProtocolforReal-TimeApplicationsIETFRFC768--UDP:UserDatagramProtocolIETPRFC793TCP:TransmissionControlProtocolIETFRFC2326--RTSP:RealTimeStreamingProtocolIETFRFC2616–HTTP1.1：HyperTextTransferProtocolUser-Agent，它是一个特殊字符串头，使得服务器能够识别客户使用的操作系统及版本、CPU类终端UAUser-Agent信息中加入终端的版本信息等体现终端的能力，且需要在httpheader里面将系统可能用到的参数及能力上报。终端需要提供给平台方的JS页面模式下点播和时移的播放URL时移和回看URL终端CDNHttp请求的Header示例1POSTPOST/ContextHTTP/1.0Host:<host-name:port>X-TERMINAL-MODEL:003-AC23Content-Type:txt/xmlWasu/1.0(param1;param2;param3;……;Wasu/1.0表示华数User-Agent表1attribute_nameHttpHeaderX-TERMINAL-MODEL,X-TERMINAL-ID等参数为终端访问业务门户时所需携带的属性，更多相表2HEADERIPQAM表3X-TERMINAL-MODEL例：HMT210EFeiyueSoyea示例2：UAPOSTPOST/ContextHTTP/1.0Host:<host-User-Agent:Wasu/1.0(mvver1.0;hwver1.0;swver1.0;uiver1.0;caver1.0)X-TERMINAL-MODEL:HMT210EContent-Type:txt/xml注1：UA重启终端JS获取加密串JSTSGjs函数获取机密获取修改反写数据JS //UserID TERMINAL_UserProfile//UserProfile :机顶盒开机后使用DHCPIPDNS服务表 DHCP扩展协议如DHCPDiscover，其中Vendor-class-identifier值为向机顶盒发DHCPOffer，提供地址、掩码、网关、DNS服务器地址。其中Vendor-class- 值向服务器发DHCPRequest 其Vendor-class-identifier值为向机顶盒发DHCPACK 注DHCP3、4步，以获图1终端开机检测UserIDKey)Result值执行反写，反写的内容有：UserID、UserProfileIndexUrlkey(密钥)、TsgUrl、TERMINALID、UserIDReturnURL地址，由系统端控制后续操作；ReturnURL图2终端开机检测UserIDKeyTERMINALID,终端收到返回结果后，将auth-token。加密方式：（3DES(auth-token+”$”+useridTerminalid密钥))TERMINALIDUserIDEncryptString；其中EncryptString以参数方式跟在URL中认证失败，则访问ReturnURL3DES （3DES，法采用ECBPKCS5Padding24字符“0base643DES中PKCS5Padding80x01-0x081个0x0780x08。终端在开机时主动发出激活认证请求，如机顶盒在开机流程结束时仍未收到UC无法打开在线DBMN&动发起的激活&认证请求不超过三次（包括开机时网络正常后进行的激活认证请求，如单次开机后终342接口方式：HTTP激活请求的httpheaderHeader表5HeaderX-1TERMINALIDUserID，UserProfile2auth-token时：TERMINALID、UserID必填，UserProfile3：认证有效时：TERMINALID、UserIDEncryptStringUserProfile://表6Action<messagemodule="DOLPHIN" UserProfile="userProfileVALUE"key=”keyVALUE”IndexUrl="indexUrlVALUE" 表7BASE64处理之后放XML中终端开机认证成功访问的URLURL，系统将终端导向终端检测URLTSGTSG终端开机认证成功后如切换到直播后访问DVBMENUURL后访问的DVBMENUURL表8result到终端，并提示用户重启发起开机认证，以便httpheader中携带反写的UserID业务失败，失败来自于BOSS<messagemodule="DOLPHIN" 表9接口方式：HTTP表10类型/反写的访问地址：访问地址：httpXML<messagemodule="DOLPHIN"<headeraction="WRITESUCC"command="WriteSucc"sequence="10000000001"component-id="WriteSucc"/><WriteSuccReqTERMINALID="123"时移及回看模式下TERMINAL终端获取TSG服务地址的方式，在终端激活成功后，由系统将TSG图 终端开机过程中，需要向TSG系统请求支持时移的直播频道列表，主要传递参数为TERMINALID和终端开机认证过程中系统端传递给终端的加密以后的校验串，其中校验串是终端传递给TSG系统。rtsp开头的，那么终端在时移播放的时候应该通过播放器访问该图4主要参数为TSID、SERVICEIDTERMINALID。如果用户没有订购服务，那么TSG如果用户已经订购服务，那么TSG系统将用户重定向到播放页面（play.jsp）,播放页面将给出RTSP播放链接，由终端向CDN请求播放。终端向CDN发起RTSP流程同点播，由页面完成所有判断，最终返回用户RTSP播放URL，URL4096接口方式：HTTPPOST参数以POST示例5POST/POST/ContextHTTP/1.0Host:<TSG-host-name:port>User-Agent:<TERMINAL-software-info>Content-Type:txt/xmlContent-Length:length<XMLHTTP/1.0HTTP/1.0200Server:TSGServer/1.0Content-Type:text/xmlContent-Length:length<xmlHTTP+XML形式的接口都采用短连接同步接口方式，且消息体需要满足规范规定的消息格式。消息结构为标准的XMLrootXMLelementMESSAGE，MESSAGEElementheaderbodyheader为固定格式，body为消息主体不同消XMLschema图5XMLschema表11消息所属模块编码，本模块暂时定义为表12complexTypeBODY示例7<?xmlversion="1.0"encoding="GBK"<Messagemodule="TSG"version="1.0"command="GET_CHANNEL_LIST_AND_CODE"/>

<?xml<?xmlversion="1.0"encoding="GBK"<Messagemodule="TSG"version="1.0"<Headeraction="RESPOND"command="<Bodyerrcode="0"errstring="OK"<Codeid<Channeltsid="234"serviceid="123"TStime="3600"desc="中央五台示例8终端在调用获取频道列表接口的时候，访问TSG系统的服务地址为如下的格式：的请求，TSG系统将返回支持时移的频道列表；对于不合法的请求，TSG系统将返回错误代码和空的图6BODY表13图7回应消息表14BODY表15BODYCODE把终端id时移节目时的代码，用法是在本身的url地址后面加rtsp://crd_ip:554/ts/cctv-5？code＝wefg表16BODYCHANNELtsid一同唯一的确定了一个时需要调用授权接口进行播放授权操作，授权成功以承载模式（比如VOD(点播)，broadcast（广播当终端调用请求频道接口获得的直播频道回看地址是http（pla.jsp面中包含最终的RTSP播放地址；如果授权失败，那么TSG系统会将用户重定向到一个错误页面上。http://tsgdomain/authpath?treminalid=xxx&tsid=xxx=serviceid=xxxhttp://tsgdomain/authpath是请求频道接口中返回的Channel对象的url表17tsid一同唯一的确响应命令：HTTP302表18LDAPXmlXml内容错误，也就是说xml格少了Body这个节点等终端RegionID的获取参见《华数机顶盒VOD终端与CDN图8CDN点播URL点播模式下播放URL由Portal示例9红色部分CRDdomain为CDN端的CRDMediafilepathURL，此地址EPG请求地址要做URLEncode表19一定的算法对相关内容进行加密计算以后得终端需要自行判断该参数决定正确的网络方时移URLrtsp请求URL4096CRDdomain为CDN端的CRD/channelURL，此地址TSG端可以从数据中获得；请求地址要做URLEncode；表20格式为YYYYMMDDThhmmssZ，YYYY=四数字显示"年" =两数字显示月"(01=January, =两数字显示一个月份中的"日"(01~31) =两数字显示"时"(00~23)(不允许使用am/pm) =两数字显示"分00~ =两数字显示"秒"(00~59)时区的消减设定:UTC(CoordinatedUniversalTime),使用"Z"显示RTSP请求消息头部中格式同start-time终端与CDN系统的通讯包括从终端获得点播URL1～N次重定向后到最后定位到视频3秒。终端获得点播URL，从中获取CDN入口服务器的IP地址、端口，并启动RTSP时，包括每次重定向后的DESCRIBE请求）,RegionID为十六进制数DESCRIBErtsp://15:5555/2.ts?token=abcd1234RTSP/1.0CSeq:1Accept:User-Agent:VODPlayerV1.1 CDN导向服务器返回的内容重定向指令遵循RTSP规范的“302REDIRECT”命令，而终端只需要根据命令中LocationURL重新发送DESCRIBE命令即可，这样的循环可能有多次；RTSP/1.0302MovedTemporarilyCSeq:Server:Onewave-Location:CDN系统最终将终端定向到提供服务的视频服务器（UServer服务器UServer服务器将回复“200OK”命令。具体格式见下一章节。TSOverIPIPTCPTSOverQAM协议信令基于IP网络，采用TCPHFC网络进行下传。x-RegionID参数携带区域，而如果访问TSOverIPx-RegionID参数。服务器将该信息传递给CSG，CSG通过该信息分配合理的数据下传信道。DESCRIBErtsp://15:5555/2.mpg?token=abcd1234RTSP/1.0CSeq:1Accept:User-Agent:VODPlayerV1.1当终端发送的DESCRIBE请求到UServer服务器后，UServer服务器对此点播进行认证，并给该点播请求需要的资源。如果成功UServer服务器将向终端回复“200OK”命令。如果为TSOverIPQAMSDP信息中携带点播需要的信道信息。信道信息包括频点（x-frequency）PMTPID（x-pid）x－frequencykHZ。如果TSOverIP协议，在SDP中没有信道信息。对于TrackSDP我们也在ISMA标准的基础上根据需要进行修改。将只包括“m”和“a＝control”参数。m3MP2TTS4ES流的ESmpgv(MPEG2video)、mpga(MPEG2audio)、avc（H.264video、mp4v(MP4video)、mp4a(MP4audio)ISMAvideoconfig信息也将不再SDPES流中周期获得。(这个主要考虑和DVB的一致)a=x-frequencya=x-pid只在TSOverIPQAMRTSP/1.0200Server:UServerCSeq:1Content-Base:o=-17024150894281335390INIP4c=INIP4t=0m=video0MP2Tm=audio0MP2TmpgaSETUP终端向Server发送SETUP请求要求在点播中添加一个EStrackID来标识。如果添加成功Server将向终端回复“200OK”。TSOverIPQAM和TSOverIP的SETUP消息的主要区别在于Transport格式。如果是TSOverIPQAM，如下所示：SETUPrtsp://:5555/2.mpg/trackID=0RTSP/1.0CSeq:2User-Agent:VODPlayerV1.1Transport:MP2TRTSP/1.0200Server:UServerCseq:2Session:Cache-Control:no-cacheTransport:MP2T如果是TSOverIP,SETUPrtsp://:5555/2.mpg/trackID=0RTSP/1.0CSeq:2User-Agent:VODPlayerV1.1Transport:MP2T/TCPRTSP/1.0200Server:UServerCseq:2Session:Cache-Control:no-cacheTransport:MP2T/TCP，RTSP这里的关键信息是trackID，告知具体需要建立哪个媒体流。Transport字段表示用TS直接封装和传MPEG2/H.264。PLAY终端通过PLAYCSeq:Session:Range:x-prebuffer:maxtime=20.00Scale:2.0User-Agent:VODPlayer能力大小给出。假设盒子的最大缓存为8MB，片源码率为3.75Mb，建议盒子用缓存的70%计算x-prebuffer8*8/3.75*70%=12。RTS（RFC2326以没有Range参数，服务器将接着暂停点发包。播放，Scale1。和请求的点略有差别Scale参数中给出实际的播放倍率。RTSP/1.0200Server:Cseq:Scale:Session:x-Ts-info参数传输的是Rangebegin的pts对应的timestampPES中的中的PTSDTS)PlayNPTPES中的数x-Ts-info中的数据差值进行进度条计算(差值×Scale)，计算样例如下： Scale:当前解码数据的PTScur-当前播放时间(秒begin(秒cur-tsx-Ts-PAUSE终端发送PAUSECSeq:Session:User-Agent:VODPlayer如果Server允许该请求将向终端回复“200OK”RTSP/1.0200Server:UServerCseq:6Session:通过PLAY和PAUSE请求的组合，可以完成定点播放、暂停继续、播放速度调整多项功能。定点播放和播放速度调整时，PLAY请求都需要有Range暂停继续时，不清空终端端缓存，PLAY请求中的prebuffer应该根据实际剩余的缓存大小给终端发送TEARDOWNCSeq:Session:User-Agent:VODPlayerRTSP/1.0200Server:UServerCseq:7Session:Connection:终端可以发送TEARDOWN请求要求去除某个ESCSeq:Session:User-Agent:VODPlayer,Server:Session:CSeq:x-x-Reason:这里的CSeqCSeq表 "ADMINKICK"SOURCEBEGINSESSION"IPLOGIN"LOGINTRANSFERREQUIRE"AUTH"NOBEGINPROXYSESSION"PROXY"EXITRTSP终端通过OPTIONS30秒。如果在限定时间（60秒）内终端未发送该请求，服务器端将认为终端已经死亡，而将其踢除。OPTIONSrtsp://:5555/2.mpgRTSP/1.0CSeq:11User-Agent:VODPlayerRTSP/1.0200Server:UServerCseq:11Session:SET_PARAMETER(NODATAPLAY20030秒钟之内无法从CABLE上收到需要的ES流时，将通过SET_PARAMETER来通告UServer服务器CABLE没有需要的数据。User-Agent:VODPlayerV1.1Session:CSeq:x-Info:"NORTSP/1.0200Server:UServerCseq:12Session:SETUP终端发送GET_PARAMETERGET_PARAMETERrtsp://:8333/live_1RTSP/1.0CSeq:11Session:User-Agent:QTS(qtver=6.5.1;os=WindowsNTRTSP/1.0200Server:UServerCseq:11Session:x-Timeshift_Current:clock=20051108T143025.25Z对于指定CLOCK的PLAYget_parameter注：不能频繁调用get_parameter命令，建议在PLAY，以及绘制进度条的时候调用此接口来获PLAYPLAY请求的RangePLAY回应中的Range 另外对于指定CLOCK的PLAYget_parameter获取当前时移范PAUSESET_PARAMETER（NODATA）SET_PARAMETERrtsp://22:2048/temp/live_1RTSP/1.0Session:CSeq:表示快进到文件尾。此时终端应切换到DVB状态进行直播。SET_PARAMETERrtsp://22:2048/temp/live_1RTSP/1.0Session:CSeq:SET_PARAMETERrtsp://22:2048/temp/live_1RTSP/1.0Session:CSeq:终端与IPQAMIPQAMfrequencySDPx-pidPMT表的PID。PMT表获取点播对应ES流的数量及每个ES的PID。根据ES的PID过滤出音视频数据流对应的TS包。ES流中start-unit-indicate被置“1”TS包视为一个PES包的开始，从该包一直到下一个此类包前一包中所有TS的净荷组成一个PES数据包。剥离PES数据包头，提取MPEG2/H.264ES。PES包的具体格式见ISO/IEC13818-11.17。根据PTSDTS图9TSTSOverIP中，UServerRtsp中以类似于Rtpoverrtsp方式在RtspTS数据。7个TS4bytesinterleavehead作为一个包发送。数据格式如上：第一个字节固定为$,第二个字节为interleaveidTs基本流中，interleaveid6，后两个字节length7*188。PESESES流中不但包含了点播对应的音视频的帧，而且还包含了音MPEG2VideoESESsequence_header、sequence_extension、group_of_picture_header、picture_headpicture_data30X0000011个字节的起始码值组成。起始码值遵循ISO/IEC13818-2图10MPEG2sequence_header、sequence_extension、group_of_picture_header等单元包含了ES的配置信息，他们在ESIpicture的前面。根据sequence_headersequence_extension可以获取视频解码器初始化需要的分辨率和profile、图11sequence_header图12sequence_extensiongroup_of_picture_header、picture_head的结构遵循ISO/IEC13818-2图13group_of_pictures_header图14picture_headerH.264VideoESH264ESNAL单元组成，NAL0x000001NAL数据存0x03，如下所示：NAL的结构遵循标准ISO/IEC14496-图15NAL图16NAL各种NALISO/IEC14496-图17SequenceparametersetNAL图18codecslicNAL图19codecslicheaderNAL图20seiNAL将会接收URLEYV