华为STB与HMS接口技术规范

1、华为stb与hms接口技术规范(ts部分)机密华为stb与hms接口技术规范(ts部分)huawei technologies co., ltd. 华为技术有限公司all rights reserved目录1接口概要描述31.1基于ts的接口描述31.2基于ts的传输协议栈31.3ts包结构和语法41.3.1mpeg-2 ts包结构41.3.2pes包结构51.3.3psi信息定义61.3.4pmt 中的视音频组件（components）62流控制方法描述72.1setup method72.2play method82.3pause method92.4announce method92.5

2、teardown method92.6describe method102.7get_parameter method122.8redirect method123机顶盒点播接口143.1开始播放143.2暂停播放163.3快进播放173.4快退播放183.5定位播放193.6退出播放203.6.1用户主动退出播放203.6.2文件结束或服务器强制退出播放214机顶盒组播接口234.1加入一个频道234.2离开一个频道241 接口概要描述1.1 基于ts的接口描述机顶盒与内容服务系统之间具有以下接口模块： 机顶盒点播接口（d1） 机顶盒组播接口（d2）stbvod服务器btv服务器hms系统d

3、1d2图1 stb与hms系统的接口框图1.2 基于ts的传输协议栈图2 基于mpeg-2 ts的传输协议栈结构上图描述了基于 mpeg-2 ts 的传输协议栈结构。基于该协议栈结构，iptv机顶盒和 iptv 内容服务系统之间的接口分为两个通道： 媒体流传输和接收通道：见上图的左半部分，即hms系统 和机顶盒之间必须按照图中所示的格式或协议来完成实际音视 频媒体流数据的传输和解包播放； 媒体流会话控制通道：见上图的右半部分，hms系统和机顶盒之间必须按照图中所示的信令协议来完成对音视频媒体流的 控制和交互，采用的协议为本规范定义的 rtsp over tcp；1.3 ts包结构和语法1.3.

4、1 mpeg-2 ts包结构 mpeg-2 ts 包结构必须符合iso/iec 13818-1 | itu-t rec. h.222.0 -2000 - amendment 3 打包结构，即如下图：图3 mpeg-2 ts的包结构 必须支持 spts，不支持 mpts； pcr 由视频 component 携带； 对h.264的ts包结构句法的定义，必须符合iso/iec 13818-1 | iso/iec 13818-1 | itu-t rec. h.222.02000 - amendment 3的标准；1.3.2 pes包结构 pes 包结构必须符合 iso/iec 13818-1 | i

5、tu-t rec. h.222.0打包结构， 具体如下图：图4 pes包结构 一帧视频数据至多打成一个pes包； h.264 的 pes 包结构的句法必须符合 iso/iec 13818-1 | itu-t rec. h.222.0 2000 - amendment 3 中的标准； 当执行快进、快退等trick mode 功能时，pes包头信息的 dsm_trick_mode_flag不进行设置，即为 0；1.3.3 psi信息定义必须能解析完整的 pat、pmt 表格，服务器可选支持 cat 表格，机顶盒 必须支持 cat 表格。且这些表格的结构必须符合 iso/iec 13818-1 |

6、itu-t rec. h.222.0 标准规范。1.3.4 pmt 中的视音频组件（components）pmt 中视音频的 stream type 必须符合 iso/iec 13818-1 | itu-t rec. h.222.0 2000 - amendment 3 中的标准，具体如下表：表1 stream_type对应表2 流控制方法描述本规范流控制协议基于标准的 rtsp 规范（rfc2326），并在此基础上进 行了必要的扩充。rtsp method 如表：表2 流控制使用的rtsp method【注】下面协议中,中括号内内容表示可选,斜体内容表示必有但数值根据实际情况可以修订。2.1

7、 setup methodc-s（从stb到服务器方向）：setup rtsp:/ rtsp/1.0cseq:3x-properties: mac_address=0050bffb9fa1transport:mp2t/rtp/tcp|udp;unicast;destination=172.18.79.120:2005;client_port=4588-4589range: now-endaccept: application/sdps-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 3location: rtsp:/server: servername|ipaddr;po

8、rtsession: 719885386transport:mp2t/rtp/tcp|udp;unicast;destination=172.18.79.120:2005;client_port=4588-4589;bandwidth=2000000;control_address=172.18.79.121;packagesize=32712/32712/188content-type: application/sdpcontent-length: 493sdp contents【注】服务器返回给客户端的信息中可以包含 location 或 server 关键域信息，机顶盒必须支持解析 lo

9、cation 和 server 关键域的信息。2.2 play methodc-s（从stb到服务器方向）：play rtsp:/ rtsp/1.0cseq: 5session: 719885386destination=172.18.79.120:2005;client_port=4588-4589scale/speed: 1.0range: npt=10-15,npt=20-25,npt=now,beginning,endx-playnow: 【注 1】c-s play 带 scale 参数请求，scale 参数至少支持 2.0、4.0、8.0、16.0, -2.0、-4.0、-8.0、-

10、16.0。快进、快退播放过程中服务器只发送 i 帧视频，音频数据不发送。【注 2】 c-s play 带 range 参数请求，range 参数由 stb 指定，为相对于节目开始的秒数。server 收到后, 应该从该指定时间开始播放.【注 3】 npt 格式中,now 代表节目的当前时间,beginning 表示节目的开始时间,end 代表节目的结束时间.s-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 5session: 719885386server: servername|ipaddr;portscale: 1.0range: npt=10-15,npt=20-

11、25, npt=now,beginning,endx-playnow: 2.3 pause methodc-s（从stb到服务器方向）：cseq: 834session: 12345678destination=172.18.79.120:2005;client_port=4588-4589【注】暂停超时时间由服务器决定。s-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 834date: 23 jan 1997 15:35:06 gmtrange: npt=45.76-,npt=now,beginning,endscale：0.000speed：0.0000002.4

12、announce methodc-s（从stb到服务器方向）：announce: rtsp:/ rtsp/1.0cseq: 834session: 12345678x-notice: xxxx “internal server error” event-date =20050729t100431.097【注 1】xxxx 取值如下:2101 表示 end of stream；2102 表示 beginning of stream；2103 表示强制退出；2104 表示定位到当前直播点；5502 表示 internal server error；5401 表示 downstream failur

13、e；【注 2】其他值可以自定义。2.5 teardown methodc-s（从stb到服务器方向）：teardown rtsp:/ rtsp/1.0session: 12345678cseq: 834destination=172.18.79.120:2005;client_port=4588-4589connection: closes-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 834session: 12345678connection: close2.6 describe methodc-s（从stb到服务器方向）：describe rtsp:/192.16

14、8.1.120:554/temp/rings.mpg rtsp/1.0accept: application/sdpcseq: 16s-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 16date: fri, 29 jul 2005 10:04:19 gmtcontent-type: application/sdpcontent-length: 309【注】sdp 的格式描述如表。sdp 举例如下：v=0o=- 1122631459319628 2139553954665140 in ip4 172.18.79.120s=rtsp sessiont=0 0i=b=as:1

15、288a=type:voda=range:npt=0-246.655c=in ip4 0.0.0.0a=control:rtsp:/:554/civil_pal_720x576.mpim=video 0 rtp/avp 128a=pmt:araxaahbaadoepaag+gq8aad6btwagz0pc0=2.7 get_parameter methodc-s（从stb到服务器方向）：get_parameter rtsp:/ rtsp/1.0cseq: 431content-type: text/parameterssession: 12345678content-length: 15pac

16、kets_receivedjitters-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 431content-length: 46content-type: text/parameterspackets_received: 10jitter: 0.3838【注】客户端定期发送 get_parameter 到服务器，服务器发送响应到机顶盒，这样可以确保整个流媒体通讯。用get_parameter进行查询获取是否支持时移，具体定义如下： stb 在直播的情况下，而且在session 已经建立的情况下，机顶盒通过rtsp的get_parameter 消息向媒体服务器查询当前录

17、制时间，格式为：get_parameter rtsp:/ip/filename rtsp/1.0x-timeshift_rangecseq: 932媒体服务器通过返回ok 响应告诉机顶盒录制时间，格式为：rtsp/1.0 200 okx-timeshift_range: clock=20051108t141020.25z -20051108t144020.25zcseq: 932“x-timeshift_range”为关键域，内容格式采用绝对时间（参见rfc2326 3.7小节）。当前直播有时移时，服务器必须回应这个请求，指示当前录制范围。第一个参数为当前录制媒体流起始时间，第二个参数为录制结

18、束的时间。2.8 redirect methodc-s（从stb到服务器方向）：redirect rtsp:/ rtsp/1.0cseq: 732location: rtsp:/ipaddr:8001range: npt=0- ;time=19960213t143205z , npt=now,beginning,endscale：1.0 session: uz3ci0k+ld-m【注】range 说明:机顶盒发送 rtsp_play 命令可以带有“range:npt=”字段，也可以不带，当带有该字 段时，服务器如果接受（200 ok），则必须从该字段规定的位置开始发送媒体流，如果 服务器拒绝，

19、则必须发送 455 回应表示拒绝。当机顶盒发送 rtsp_play 命令不带有“range:npt=”字段时，服务器如果接受（200 ok），则表示缺省从当前位置开始发送媒体流，当前位置规定如下：1) 当第一次播放时（本次有效 rtsp 连接的第一个 rtsp_play 命令），对于点播节目当 前位置为节目的起始位置，对于直播节目当前位置为媒体服务器当前接收的媒体流 位置。2) 暂停状态下恢复播放为当时停止的位置，如果不知道该位置则从头播放。3) 播放状态下快进/快退为媒体流发送的当前位置。4) 快进快退状态下播放或继续快进快退为媒体流发送的当前位置。3 机顶盒点播接口播放指定 url 的媒体

20、文件。url 定义：协议名:/服务器地址:端口/媒 体文件路径?附加信息3.1 开始播放图5 开始播放时序图describec-s（从stb到服务器方向）：describe rtsp:/192.168.1.120:554/temp/rings.mpg rtsp/1.0accept: application/sdpcseq: 16s-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 16date: fri, 29 jul 2005 10:04:19 gmtcontent-type: application/sdpcontent-length: 309setupc-s（从stb

21、到服务器方向）：setup rtsp:/ rtsp/1.0cseq:3x-properties: mac_address=0050bffb9fa1transport:mp2t/rtp/tcp|udp;unicast;destination=172.18.79.120:2005;client_port=4588-4589range: now-endaccept: application/sdps-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 3location: rtsp:/server: servername|ipaddr;portsession: 719885386t

22、ransport:mp2t/rtp/tcp|udp;unicast;destination=172.18.79.120:2005;client_port=4588-4589;bandwidth=2000000;control_address=172.18.79.121;packagesize=32712/32712/188content-type: application/sdpcontent-length: 493sdp contentsplayc-s（从stb到服务器方向）：play rtsp:/ rtsp/1.0cseq: 5session: 719885386destination=1

23、72.18.79.120:2005;client_port=4588-4589scale/speed: 1.0range: npt=10-15,npt=20-25,npt=now,beginning,endx-playnow: s-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 5session: 719885386server: servername|ipaddr;portscale: 1.0range: npt=10-15,npt=20-25, npt=now,beginning,endx-playnow: redirectc-s（从stb到服务器方向）：redire

24、ct rtsp:/ rtsp/1.0cseq: 732location: rtsp:/ipaddr:8001range: npt=0- ;time=19960213t143205z , npt=now,beginning,endscale：1.0 session: uz3ci0k+ld-m3.2 暂停播放图6 暂停播放时序图pausec-s（从stb到服务器方向）：pause rtsp:/ rtsp/1.0cseq: 834session: 12345678destination=172.18.79.120:2005;client_port=4588-4589【注】暂停超时时间由服务器决定，例

25、如30分钟。当服务器判断为超时，则发送announce通知暂停超时，原因为pause_timeout。s-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 834date: 23 jan 1997 15:35:06 gmtrange: npt=45.76-,npt=now,beginning,endscale：0.000speed：0.0000003.3 快进播放图7 快进播放时序图playc-s（从stb到服务器方向）：play rtsp:/ rtsp/1.0cseq: 5session: 719885386destination=172.18.79.120:2005;c

26、lient_port=4588-4589scale/speed: 2.0range: npt=10-15,npt=now-endx-playnow: 【注 1】c-s play 带 scale 参数请求，scale 参数至少支持 2.0、4.0、8.0、16.0。快进、快退播放过程中服务器只发送 i 帧视频，音频数据不发送。【注 2】c-s play 带 range 参数请求，range 参数由 stb 指定，为相对于节目开始的秒数。server 收到后, 应该从该指定时间开始播放.【注 3】 npt 格式中,now 代表节目的当前时间,beginning 表示节目的开始时间,end 代表节目

27、的结束时间.s-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 5session: 719885386server: servername|ipaddr;portscale: 2.0range: npt=10-15, npt=now-endx-playnow: 3.4 快退播放图8 快退播放时序图playc-s（从stb到服务器方向）：play rtsp:/ rtsp/1.0cseq: 5session: 719885386destination=172.18.79.120:2005;client_port=4588-4589scale/speed: -2.0range:

28、 npt=15-10, npt=now-beginning【注 1】c-s play 带 scale 参数请求，scale 参数至少支持-2.0、-4.0、-8.0、-16.0。快进、快退播放过程中服务器只发送 i 帧视频，音频数据不发送。【注 2】c-s play 带 range 参数请求，range 参数由 stb 指定，为相对于节目开始的秒数。server 收到后, 应该从该指定时间开始播放.【注 3】 npt 格式中,now 和代表节目的当前时间,beginning 表示节目的开始时间,end 代表节目的结束时间.s-c（从服务器到stb方向）：rtsp/1.0 200 okcseq:

29、 5session: 719885386server: servername|ipaddr;portscale: -2.0range: npt=15-10, npt=now-endx-playnow: 3.5 定位播放图9 定位播放时序图playc-s（从stb到服务器方向）：play rtsp:/ rtsp/1.0cseq: 5session: 719885386destination=172.18.79.120:2005;client_port=4588-4589scale/speed: 1.0range: npt=10-2000x-playnow: 【注 1】c-s play 带 ran

30、ge 参数请求，range 参数由 stb 指定，为相对于节目开始的秒数。server 收到后, 应该从该指定时间开始播放.【注 2】 npt 格式中,now 和代表节目的当前时间,beginning 表示节目的开始时间,end 代表节目的结束时间.s-c（从服务器到stb方向）：rtsp/1.0 200 okcseq: 5session: 719885386server: servername|ipaddr;portscale: 1.0range: npt=10-15x-playnow: 3.6 退出播放3.6.1 用户主动退出播放图10 用户退出播放时序图teardown：c-s（从stb到服务器方向）：teardown rtsp:/ rtsp/1.0session: 12345678cseq: 834destination=172.18.79.120:2005;client_port=4588-4589connection: closes-c（从服务器到stb方向）：rtsp/1.0 200