IPTV业务SP接入技术规范V2.2
——增值业务视频播放接口扩展
1流媒体播放地址获取接口
目前《IPTV业务SP接入接口规范 V2.2》中为增值业务SP的视频播放提供两个接口【9.2.3 视频播放接口】：【9.2.3.3 全屏播放接口】及【9.2.3.4 窗口播放接口】。
通过视频播放接口SP可以根据ContentID（播放的媒体内容的ID，用于标识不同的媒体播放内容，32位Integer）进行视频的播放。规范中所提供的接口由业务能力平台提供的SmallScreen及FullScreen页面中进行控制。
由于业务扩展的需要，增值业务SP需要能够对于扩展JS MediaPlayer对象进行进一步控制，因此需要扩展《IPTV业务SP接入技术规范》中对于增值业务视频播放的接口以支持增值业务SP对于MediaPlayer对象的完全控制
1.1接口说明
调用本接口时，业务能力平台EPG为SP提供根据视频内容的ContentID获取该ContentID对应的流媒体播
放mediastr JSON对象（《机顶盒与IPTV业务运营平台接口技术规范V2.2》【D 2.3 媒体相关参数的描述】及【D 2.4 将媒体参数封装为JSON对象】中定义，见附录A）。
1.2接口定义
要求业务能力平台在《IPTV业务SP接入接口规范V2.2》的【9.2.3.4 窗口播放接口】节中定义的SmallScreen中提供以下方法进行ContentID及mediastr JSON对象的转换：
1、媒体播放地址获取接口
调用方法：JavaScript 1.5及以上
调用方向：增值业务页面–> 业务能力平台SmallScreen页面
方法定义：string getMediastr( string ContentID )
入口参数：播放的媒体内容的ID，用于标识不同的媒体播放内容，32位string
返回值：mediastr JSON对象
备注说明: 增值业务页面可以根据此方法获取被封装为JSON对象的播放媒体媒体描述信息
示例代码：
说明：
其中彩部分是第三方开发所有需要做的工作，<head><body>区中间加入的部分相对固定，需注意示例代码中红部分的写法。对应绿部分提供了通过ContentID获取mediastr JSON对象的getMediastr方法（即本接口定义的方法），其中紫部分需要与<body></body>区中的紫部分保持一致。
对于增值业务厂商来说蓝部分是关键：其中的<div>标签是用来定位图中画位置和大小的；
<iframe>标签是真正的播放页面，标签中的src参数请填入指定的业务能力平台SmallScreen页面地址，具体填写方式请参考以下说明：
1. host：为媒体播放控制服务器地址，通过CTCGetConfig(‘EPGDomain’)方法获得；
2. MediaService：媒体播放控制页面所在的文件夹路径，必须以此命名且大小写敏感；
iframe参数传递3. SmallScreen：媒体播放控制页面名，为支持WebService的jsp页面，必须以此命名且大小写敏感；
4.Left：相对于所在浏览器窗口左上角的右向偏移的象素点个数(默认值为0)；
5.Top：相对于所在浏览器窗口左上角的向下偏移的象素点个数(默认值为0)
6. Width：媒体播放器显示视频的窗口宽度的象素点个数(默认值为默认页面设计空间的宽度，对PAL来说为720)；
7. Height：媒体播放器显示视频的窗口高度的象素点个数(默认值为默认页面设计空间的高度，对PAL来说为576)；
8. ContentID：播放的媒体内容的ID，用于标识不同的媒体播放内容，32位Integer；
9. CycleFlag：是否循环播放指定的媒体内容。( 0：不循环播放（默认值）；其他：循环播放)，参数名大小写敏感。
10. GetCntFlag：是否通过本接口获取ContentID的标志位。当本标志位为0或未在参数中添加时，表示SmallScreen页面立即开始播放视频，SP调用getMediastr方法后将返回空字符串；当本标志位为1时，表示SmallScreen页面无需播放视频，只需在getMediastr方法中返回视频描述信息mediastr即可。参数名大小写敏感。
1.3视频播放接口更新
在《IPTV业务SP接入技术规范V2.2》【9.2.3.4 窗口播放接口】中定义了通过iframe 完成窗口视频播放的接口，由于该接口只提供对于窗口视频的直接播放而无法进行播放控
制，因此SP在调用1.2接口中定义的方法时会出现视频直接播放的情况，因此对于【9.2.3.4 窗口播放接口】进行更新。
1、窗口播放指定媒体内容请求
承载协议： HTTP Get
接口方向：增值业务服务器–> 媒体播放控制服务器
调用接口：例如：EPGDomain/MediaService/SmallScreen
接口功能:  请求在指定窗口位置，播放指定的媒体内容
备注说明: 播放请求地址需符合下表中的说明，并参考使用说明中的例子进行填写
指定的播放页面服务地址定义：
string 不定M EPGDomain http请求中的媒体播放服务
器地址，通过
CTCGetConfig(‘EPGDomain’)方
法获得，带有’/’表示仍然存在
下级目录
string 12 M MediaService 媒体播放控制页面所在的文
件夹路径，必须以此命名且大
小写敏感，带有’/’表示仍然有
下级目录
string 12 M SmallScreen 媒体播放控制页面名，为支持
WebService的jsp页面，必须
以此命名且大小写敏感
指定的播放页面参数定义：
Integer 128 M
Left 相对于所在浏览器窗口左上
角的右向偏移的象素点个数
(默认值为0)
Integer 128 M
Top 相对于所在浏览器窗口左上
角的向下偏移的象素点个数
(默认值为0)
Integer 128 M
Width 媒体播放器显示视频的窗口
宽度的象素点个数(默认值
为默认页面设计空间的宽度，
对PAL来说为720)
Integer 128 M
Height 媒体播放器显示视频的窗口
高度的象素点个数(默认值
为默认页面设计空间的高度，
对PAL来说为576)
ContentID 播放的媒体内容的ID，用于标Integer 32 M

版权声明：本站内容均来自互联网，仅供演示用，请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198，我们将在24小时内删除。