原力P2P直播点播系统开发手册

《原力P2P直播点播系统开发手册》由会员分享，可在线阅读，更多相关《原力P2P直播点播系统开发手册（12页珍藏版）》请在装配图网上搜索。

1、北京原力创新科技有限公司 原力 P2P 直播点播系统使用手册- 1 -原力原力 P2PP2P 直播点播系统开发手册直播点播系统开发手册（控件版）（控件版）版本：2.10文档编撰： 原力科技流媒体解决方案研发中心2007 年 01 月 08 日 北京原力创新科技有限公司 原力 P2P 直播点播系统使用手册- 2 -版权信息版权信息原力P2P直播点播系统版权所有(C) (2004 2007) 北京原力创新科技有限公司，保留所有a权利文档保证声明文档保证声明本手册以提供信息为目的，所含信息可随时更改，恕不另行通知。由此情况引起的与之有关的直接或间接的损失，本公司均不负责。联系方式联系方式北北京京公公

2、司司总总部部地址： 北京市海淀区中关村软件园区8 号楼 (华夏科技大厦 )106 室邮编： 100094电话： 010-82825288 82825369 82826369 82826689Email： 公司网址： 美美国国办办事事处处地址： 410 N 5th Street, Harrison, New Jersey 邮编： 07029电话： (201) 336-2938加加拿拿大大办办事事处处地址： 2933 Garnethill Way, Oakville, Ontario邮编： L6M 5E9电话： (416) 857-5886北京原力创新科技有限公司 原力 P2P 直播点播系统使用手

3、册- 3 -目目 录录文档目的文档目的 .- 4 -目标用户目标用户 .- 4 -公司介绍公司介绍 .- 4 -环境要求环境要求 .- 4 -安装控件客户端安装控件客户端 .- 5 -接口说明接口说明 .- 5 -北京原力创新科技有限公司 原力 P2P 直播点播系统安装手册- 4 - 文档目的文档目的本文档详细介绍了原力 P2P 直播点播系统中客户端控件的使用方法以及系统后台接口、控件接口说明。 目标用户目标用户本文档可以帮助开发人员迅速掌握原力 P2P 直播点播系统中客户端控件的使用方法。 公司介绍公司介绍北京原力创新科技有限公司是国内最专业的企业及电信运营级,P2P 点播直播流媒体产品及解

4、决方案提供商，是国内领先的手机流媒体产品及解决方案提供商。致力于研发适合中国网络国情的 P2P 流媒体技术整体解决方案,为数以千万计的网民提供最优质最流畅的影视观看体验,为数以亿计的 IPTV 及 3G 手机用户提供最稳定最快捷的流媒体服务体验。 原力公司成立于 2004 年 3 月，技术力量雄厚,其中 30%来自美国及加拿大研发中心,研发人员占公司的 80%以上，经过两年的基于 P2P 直播及 P2P 点播技术的艰苦探索与研发,最终推出了商业可管理的基于 UDP 协议的 p2p 直播点播流媒体及移动流媒体系列产品。凭借公司多年来的研发积累，公司的 P2P 流媒体系统、手机流媒体系统以及其他的

5、众多产品都处于行业的领先位置。 原力公司的 P2P 视频点播和 P2P 视频直播系列产品是目前国内最专业的商业 P2P流媒体软件技术提供商，支持了网络春晚、孔子文化节、炫视听等十余家媒体近百万并发用户级别的直播点播应用,与之相应的“原力 P2P 流媒体宽带运营平台建设方案”是目前国内最早完善的商业化 P2P 流媒体一体化宽带运营平台，平台基于 P2P 视频点播、P2P 视频直播、CMS、互动聊天、网络会议等应用系统，是国内首例商业化的、一站式的宽带流媒体运营平台。系统同时支持认证计费与运营管理，彻底满足宽带流媒体运营的需要。整个平台不仅稳定可靠，而且管理方便，深受合作媒体和广大客户的高度评价。

6、 原力公司秉承“做事先做人”和“求实创新”的企业精神，经过多年的研发、实践和服务，目前已为国内外众多知名企业及单位提供着优良有流媒体运营系统及服务。 原力创新公司的目标是成为国内流媒体网络视频增值应用解决方案的最优技术提供商。公司将一直保持在 P2P 数字视频流媒体技术上的领先优势，在不断加强自己P2P 技术优先的同时，把自己在软件研发、网络等技术中积累的丰富经验与合作伙伴分享，与用户建立长期、友好的亲密合作关系，共同发展，共同进步！环境要求环境要求北京原力创新科技有限公司 原力 P2P 直播点播系统安装手册- 5 -在按照本手册使用系统之前，请您确认已经安装了原力 P2P 直播点播系统（运营

7、版） 。如未安装，您可以参照原力 P2P 直播点播系统安装手册进行安装。 安装控件客户端安装控件客户端在网页上嵌入来调用原力 P2P 客户端 ActiveX 控件以下代码：附示例页面 index.htm. 接口说明接口说明*后台接口后台接口* 后台删除接口 http:/58.211.1.86:9907/admin?cmd=o_if_delfilm&id=56&webname=SLDKFJLH&time=89377199&code=HJYMHGJMNNBGHJ命令字：o_if_addfilm参数：webname-经过 MD5（后台真实用户名+后台真实密码+time+MD5KEY1）获得的 MD5

8、 串的后 8 位字符；time-调用者机器的时间，长整型；code-经过 MD5（后台真实用户+后台真实密码+time+MD5KEY2）获得的MD5 串。Id-影片 ID；返回：成功失败都会返回一个 HTTP RESPONSE, 其中 HTTP BODY 中为下面的一个 XML参数意思：ret : 0 表示成功，其他值表示失败；双方约定Webname 中的 MD5KEY1，双方必须使用同一个 MD5KEY1（ ） ；Code 中的 MD5KEY2，双方必须使用同一个 MD5KEY2（ ） 。调用者流程1.调用者获得真实用户名、密码、MD5KEY1、MD5KEY2、当前系统时间；2.当前系统时间

9、转换为长整型；3.MD5（后台真实用户名(admin)+后台真实密码+time+MD5KEY1）获得MD5 串，取该的后 8 位字符作为 webname 的值；4.MD5（后台真实用户(admin)+后台真实密码+time+MD5KEY2）获得MD5 串；5.调用改动后的接口；北京原力创新科技有限公司 原力 P2P 直播点播系统安装手册- 6 -被调用者流程1.获得 webname 值、code 值、time 值、当前系统时间、MD5KEY1、MD5KEY2；2.用当前系统时间减去 time 值如果大于 20 分钟认定访问无效，否则有效；3.MD5（后台真实用户名(admin)+后台真实密码+

10、time+MD5KEY1）获得MD5 串，取该的后 8 位字符与获得的 webname 值比较，一致则认定有效，反之无效； 4.MD5（后台真实用户(admin)+后台真实密码+time+MD5KEY2）获得本地 MD5 串；将该串与 code 值比较，一致则认定有效，反之无效。举例调用者真实用户名为 admin密码为 forcewebname 所用 MD5KEY1 为839D8B94-E5E5-477d-B21A-E7BD2F8BDC4Acode 所用 MD5KEY2 为C578027A-390F-4486-A0C5-60E1BCEB3153当前(2007 年 1 月 11 日 23 点)的

11、一个时间为 1168528608那么计算得到webname 即后台真实用户(admin)+后台真实密码+time+MD5KEY1为adminforce1168528608839D8B94-E5E5-477d-B21A-E7BD2F8BDC4A求得 MD5 值为A759E00DC94A0223F6C6CDAF338AB140取后 8 个字符为338AB140code 即后台真实用户(admin)+后台真实密码+time+MD5KEY2为adminforce1168528608C578027A-390F-4486-A0C5-60E1BCEB3153求得 MD5 值为5C7305E1CEC983FF

12、CD1CBF9A731C3982生成的 URL 为&time=1168528608&webname=338AB140&code=5C7305E1CEC983FFCD1CBF9A731C39821.2. 后台添加接口 http:/58.211.1.86:9907/admin?cmd=o_if_addfilm&url=file%3A%2F%2F%2Fc%3A% 2Fav.rm&filename=cav&vod=1&type=rm&ptl=file&ptlimpl=std&submit=%CC%E1%BD% BB& webname=SLDKFJLH&time=89377199&code=HJYMHG

13、JMNNBGHJ 命令字：o_if_addfilm北京原力创新科技有限公司 原力 P2P 直播点播系统安装手册- 7 -参数：url 为电影的 URL；filename 为电影名；vod 直播为 0,VOD 格式为 1；ptl 为流类型，当前可选值为 http, mms, rtsp, file，目前点播采用 file 类型，直播根据信号来源类型选择。type 为文件类型, 可选值为 rm, rmvb, avi, wmv；ptlimpl 为协议实现者, 可选值为 std, ms_wms，real，分别表示标准实现，微软和REAL；url 和 filmname 必须进行编码：上例中，url 原始为

14、:http:/ filmname 为：如果有爱返回：成功失败都会返回一个 HTTP RESPONSE, 其中 HTTP BODY 中为下面的一个XMLret : 0 表示成功，其他值表示失败；filmid: 表示返回的电影 ID，如果失败，该值为 0；1.3 后台查询接口一 http:/127.0.0.1:9907/admin?cmd=getpage&page=chnlist&begin=0&count=20& webname=SLDKFJLH&time=89377199&code=HJYMHGJMNNBGHJ begin 表示开始的频道 count 表示一共显示多少个频道1.4 后台查询接口

15、二 http:/127.0.0.1:9907/admin?cmd=getpage&page=index& webname=SLDKFJLH&time=89377199&code=HJYMHGJMNNBGHJ 是返回服务器信息 *播放播放* http:/58.211.139.29:9907/admin?cmd=queryserver&id=613;/从 P2P 服务器集群中获得最终播放 id 为 613 的 P2P 服务器 IP 和端口；返回值格式为：IP：端口号，例如 58.211.139.29:9906。ForcePlayer.SetDistributeSvr(http:/10.18.3.2

16、0:9907/admin?cmd=queryserver);/设置集群服务器请求地址,如果将其设为空（ForcePlayer.SetDistributeSvr()）则不使用集群功能（注：使用集群功能前必须调用此接口）（注：使用集群功能前必须调用此接口） 。ForcePlayer.SimpleSelectByURL( forcetv:/stream/1885?tip=221.195.0.5:9906&id=355&type=RMVB&ptl=file ); /播放文件 ForcePlayer.Start( 北京原力创新科技有限公司 原力 P2P 直播点播系统安装手册- 8 -http:/ For

17、cePlayer.StartBySmil(forcetv:/stream/1885?tip=221.195.0.5:9906&id=355&type=RMVB&ptl=file ,smilcontent,userid,ip1); 播放 SMIL 文件， ForcePlayer.StartByForceP2P(Forcetv:/stream/id?tip=212.1.2.2:9906,userid);播放, ForcePlayer.StartByForceGrid(http:/58.211.139.29:9907/admin?cmd=queryserver&id=613&type=RMVB&pt

18、l=http,userid,备用 ip1); *PPShell* ForcePlayer.AutoCloseShell(LONG nFlag);控件销毁是是否关闭 shell 1：关闭，0：不关闭 ForcePlayer.ExecutePpshell(LONG nFlag);是否执行 shell 1：执行，0：不执行 ForcePlayer.SetSaveData(1,100);/开启存储到本地的功能(1:开启，0 关闭)，空间大小为100MB ForcePlayer.SetAutoBoot(1);/开机时是否自动启动(1:启动，0，不启动) ForcePlayer.SetUserID(use

19、rid);/设置用户 ID *字幕字幕* ForcePlayer.SetCaptionText(CLSID:FCD61199-E187-4ADD-8 电影频率);/滚动字幕，设为空将不显示 ForcePlayer.SetCaptionBkClolor(255,255,255);/滚动字幕的背景颜色 ForcePlayer.SetCaptionTextColor(255,0,0);/滚动字幕的字幕颜色 *标题标题* ForcePlayer.SetTitle();/标题 ForcePlayer.SetTitleTextColor(255,255 ,255);/标题颜色 *界面界面* ForcePl

20、ayer.ShowBorder(1);/是否显示边框(1:显示，0：不显示) ForcePlayer.SetBKColor(0,0,0);/设置背景颜色 ForcePlayer.ShowControlPanel(0);是否显示控制栏 1：显示，0：不显示 ForcePlayer.SetAboutInfo(文字第一行rnrn 文字第二行 rnrn ); 更改右键关于信息.*广告广告* Forceplayer.PlayAD(0,http:/58.211.139.194:8999/BMW-car.swf,30); /第一个参数有 3 种值，0 表示播前广告，-1 表示播后广告，其他正整数表示从多少秒

21、北京原力创新科技有限公司 原力 P2P 直播点播系统安装手册- 9 -插播广告；/第二个参数是一个 HTTP 的广告地址/第三个参数表示播放广告的时长*控制栏接口控制栏接口* ForcePlayer.Start( );/播放，见上面的播放说明， ForcePlayer.Stop();/停止播放 ForcePlayer.Pause(1) /暂停播放，1：暂停，0：继续 ForcePlayer.SetMute(1) /设置静音 1：静音，0：开启声音 ForcePlayer.FullScreen(1) /设置全屏 1：全屏，0:退出全屏 ForcePlayer.GetVolumn();/返回媒体文

22、件的音量(范围 0-100） ForcePlayer.SetVolumn(100) /设置媒体文件的音量(范围 0-100） ForcePlayer.GetLength()/返回媒体文件的长度（单位：秒） ForcePlayer.SetPosition(120)/设置媒体文件播放的位置（单位：秒） ForcePlayer.GetPosition()/返回媒体文件当前播放的位置（单位：秒）*新接口新接口* forceplayer.SetStartPPShellTime(10); /设置 PPSHELL 启动时间，参数意义为距离播前广告播放完成多少秒启动PPSHELL；forceplayer.Pl

23、ayAD(0,http:/58.211.139.194:8999/BMW-car.swf,30); /第一个参数有 3 种值，0 表示播前广告，-1 表示播后广告，其他正整数表示从多少秒插播广告；/第二个参数是一个 HTTP 的广告地址/第三个参数表示播放广告的时长forceplayer.SetCaptionText(CLSID:FCD61199-E187-4ADD-8 电影频率);/滚动字幕，设为空将不显示forceplayer.ShowCaption(CLSID:FCD61199-E187-4ADD-8 电影频率,posType 取值(0,1),distance);/posType=0 浮

24、动字幕在屏幕下方forceplayer.SetCaptionBkClolor(255,255,255);/滚动字幕的背景颜色forceplayer.SetCaptionTextColor(255,0,0);/滚动字幕的字幕颜色forceplayer.SetCaptionFontSize(18);/滚动字幕的字体大小forceplayer.SetCaptionSpeed(10);/滚动速度forceplayer.GetMediaType();/返回正在播放的媒体类型(1:广告，0:电影)forceplayer.GetMsgInfo();/返回状态信息forceplayer.SetStatusMs

25、g(msg);状态栏显示信息forceplayer.ShowMenu(1);1 显示右键菜单，0 不显示右键菜单快捷键alt+回车:全屏ESC：退出全屏alt+P:播放北京原力创新科技有限公司 原力 P2P 直播点播系统安装手册- 10 -alt+O:暂停alt+S:停止alt+A:向前快进alt+N:向后快进alt+M:静音alt+V:开启声音-2007-08-14-新加接口ForcePlayer.SetCaptionUrl(http:/);/设置字幕 url 字幕和下面的滚动字可以加链接,点击后弹出新的网页窗口ForcePlayer.SetStatusUrl(http:/);/设置状态栏字

26、幕 urlForcePlayer.GetMediaEndTime();/返回媒体结束时的系统时间ForcePlayer.GetPlayTimeLen();/返回有效播放时间-2007-08-20-新加接口forceplayer.SetWriteReg(0);/是否写入注册表， （1 写，0 不写）现在控件默认写入注册表forceplayer.PlayAd2(2,http:/10.18.3.13/a.gif,10);/播放挂角广告，参数用接口 PlayAd,注：只支持 gif，jpg 等图片格式增加事件PlayStatus(type,status)/type:0 电影事件 1 广告事件，stat

27、us：0 停止 1 暂停 2 播放 if( type=0)if(status=0)alert(movie stop);else if(status=1)alert(movie pause);else if(status =2)alert(movie play); 北京原力创新科技有限公司 原力 P2P 直播点播系统安装手册- 11 - else if( type=1) if(status=0)alert(ad stop);else if(status=1)alert(ad pause);else if(status =2)alert(ad play); 这个就是事件的使用方法，当事件发生时会自

28、动调用这个函数的for=ForcePlayer这个你们要改成控件的 id-2007-08-22-forceplayer.Set2Top(1);/1:IE on the top; 0:恢复-2007-08-24-forceplayer.ForceADPreDownload(10);/提前 10 秒下载广告,只对 forcead 广告有效forceplayer.ForceAd(10,forcead:/.,10);/播放 forcead 广告，参数同接口 PlayAdforceplayer.SetCornerAdSize(400,300);/设置边角广告的长宽，forceplayer.PlayAdU

29、rl2(10,http:/10.18.3.123/a.jpg,20,http:/);/边角广告加网页链接，/第一个参数有 3 种值，0 表示播前广告，-1 表示播后广告，其他正整数表示从多少秒插播广告；/第二个参数是一个 HTTP 的广告地址/第三个参数表示播放广告的时长 /第四个参数表示为点击的连接-2007-08-27-forceplayer.CompleteCloseShell(1);/最后关闭 ppshell，并等待 3 秒forceplayer.SetMaxUpRate(512);/kb,设置最大上传速度forceplayer.SetStretch(0);/是否拉伸图像，只对 rea

30、l 有用(1,拉伸，0 不拉伸)北京原力创新科技有限公司 原力 P2P 直播点播系统安装手册- 12 -2007-09-25-forceplayer.SetStatusSpeed(5);/设置 status 滚动速度forceplayer.SetCornerAdPos(1,10,10);/1,2,3,4,5 依次左上,右上,左下,右下,中间位置投放针对挂角的位置的接口.,后两个参数为偏离（左上,右上,左下,右下）的距离forceplayer.ShowCaption(CLSID:FCD61199-E187-4ADD-8 电影频率,posType 取值(0,1),distance,begintime,endtime);/posType=0 浮动字幕在屏幕下方