2. 新增调用的 JS 方法 :getrelated 3. 新增调用的 JS 方法 :playstate 修改 uimode 属性值为 5 的说明 2. 和时间有关的属性和方法加入单位说明 3. 新增 getbufferpercent 方法 4. 修改 setvolume

Size: px

Start display at page:

Download "2. 新增调用的 JS 方法 :getrelated 3. 新增调用的 JS 方法 :playstate 修改 uimode 属性值为 5 的说明 2. 和时间有关的属性和方法加入单位说明 3. 新增 getbufferpercent 方法 4. 修改 setvolume"

帜雍
5 years ago
Views:

1 编号 : 编写人 : 类型 : 接口文档保密级别 : 公开修改记录 : 时间修改描述修改人新增 buffertime 属性修改 src 属性说明删除 purl 属性修改频道 xml 中的 purl 说明 buftime 改为 buffertime 2. 修改 buffertime 属性说明 3. 新增 logo 属性 4. 新增 language 属性 5. 新增 setlanguage 方法新增获取播放时间等多个方法新增 starttime 属性 2. 新增 endtime 属性删除 endtime 属性 2. 修改 starttime 属性 3. 新增 start 和 end 属性新增 getdownloadpath 方法新增 lockcontrolbar 属性 playback 改为 playback 2. 新增 related 属性 3. 新增相关视频列表 xml 新增 adinterval 属性新增 verify 属性修改 usep2p 属性说明 2. 新增 speedurl 属性 3. 修改 adurl 属性说明新增 startdelay 属性新增 autoplay 属性新增 uimode 属性新增调用的 JS 方法 :isready 修改 logo 属性说明 2. 新增 xml 格式 :logo 3. 新增 xml 格式 : 打点 4. buffertime 属性默认值从 1 改为新增 showtime 属性新增一种 uimode 2. 新增 showtopmenu 属性 3. 新增 showrightmenu 属性 4. 新增 showcontrolbar 属性 buffertime 属性默认值从 0.1 改为 1.

2 2. 新增调用的 JS 方法 :getrelated 3. 新增调用的 JS 方法 :playstate 修改 uimode 属性值为 5 的说明 2. 和时间有关的属性和方法加入单位说明 3. 新增 getbufferpercent 方法 4. 修改 setvolume 方法说明新增 loop 属性 2. 新增 item 属性 3. 修改文件 xml 中 url 的说明新增 customparam 属性新增调用的 JS 方法 :onverifycomplete 新增 getfilename 方法 2. 新增 allowjs 属性修改 src 属性说明新增 share 属性新增 cturl 属性新增设置属性说明 2. 新增调用方法说明修改 play 方法说明修改 allowjs 属性说明修改 getdownloadpath 方法说明新增 previousvideo 方法 2. 新增 nextvideo 方法 3. 新增 showpnbutton 属性 4. 新增调用的 JS 方法 :previousvideo 5. 新增调用的 JS 方法 :nextvideo 新增 allowclickpause 属性 2. 新增 allowpausewhenlive 属性新增 tasktimeout 属性修改 play 方法说明 2. 修改 pause 方法说明 3. 修改 resume 方法说明 4. 修改 stop 方法说明 5. 修改 seek 方法说明新增 comments 属性 2. 新增 sendcomment 方法修改频道 xml 中 purl 的说明新增问题列表 xml 新增 questions 属性修改问题列表 xml 2. 新增 showcomment 方法 3. 新增 hidecomment 方法 4. 新增 setquestions 方法

3 5. 新增答案验证结果 xml 修改问题列表 xml 删除 setquestions 方法修改节目 xml 修改问题列表 xml 新增 cover 属性 2. 修改 starttime 属性说明修改 getplaytime 方法说明修改 customparam 属性说明

4 目录目录 VJTVPlayer 属性表 VJTVPlayer 方法表 VJTVPlayer 调用的 JS 方法 xml 格式频道节目广告文件打点分享相关视频验证结果 Logo 弹幕问题列表答案验证结果. 19 附录如何设置 VJTVPlayer 的属性发送弹幕请求 20

5 1. VJTVPlayer 属性表 ID 名字用途说明 1 showlist 显示 / 隐藏列表 0: 隐藏列表 1: 显示列表默认 :1 2 src 指定播放源地址支持的地址格式 :http vjms vjmsl 时移回放地址时移回放地址格式 : vjms://ip:tport:nport/live/cid=&begin=...&time= 资源名称 begin 参数格式 : yyyymmddthhmmss 日期和时间之间用 T 隔开, 如 T curl 指定获取频道列表 (xml) 的地址 4 furl 指定获取文件地址列表 (xml) 的地址 5 adurl 指定获取广告地址列表 (xml) 的地址 6 point 指定获取打点信息 (xml) 的地址 7 playback 设置是否回放模式 ( 回放模式下, 不能使用加速器 ) 8 usep2p 设置默认是否使用加速器 9 title 设置顶部菜单显示的文字 10 scale 设置默认画面比例模式注 : 非回放模式下, 设置该属性后, 会自动隐藏列表不能与 src 属性共用该属性用于播放文件时切换清晰度, 不能与 src 属性共用该属性支持 vjms 广告文件 (*.vva) 0: 非回放模式 1: 回放模式若没指定, 将自动识别 0: 不使用, 可手动加速 1: 使用, 失败时自动切换直连模式 2: 使用且必须在加速模式下播放默认 :0 0: 原始比例 1:4:3 2:16:9 3: 屏幕大小

6 默认 :3 11 pmode 设置是否显示默认列表 default: 显示默认列表 none: 显示空列表默认 :default 12 buffertime 设置缓冲时间单位 : 秒默认 :1 13 logo 添加播放器 logo 需要改变 logo 的属性, 传入获取 logo 信息 (xml) 的地址不需要, 则直接传入 logo 文件的地址支持的 logo 文件格式 :swf png jpeg 14 language 切换播放器语言 zh_cn: 中文 en_us: 英文默认 :zh_cn 15 starttime / skiptime 设置开始跳转时间单位 : 秒默认 :0 16 start 设置开始时间单位 : 秒默认 :0 17 end 设置结束时间单位 : 秒默认 :0 18 lockcontrolbar 设置鼠标移出时, 是否隐藏控制栏 0: 隐藏 1: 不隐藏默认 :0 19 related 指定获取相关视频列表 (xml) 的地址 20 adinterval 设置重复获取 vjms 广告间隔设为 0 时, 表示仅在连接时获取单位 : 秒默认 :0 21 verify 设置验证地址验证地址格式 ( 注 : 参数顺序必须一致 ): mode: 指定验证方式可供选择的值 : 0: 密码 1: 用户名 + 密码 vid: 视频标识请求地址格式 : x&pwd=xxx 以 POST 方式发送请求 mode: 验证方式 vid: 视频标识 account: 用户名,mode=0 时, 省略 pwd: 密码, 采用 MD5 大写加密注 : 验证结果需要以 xml 格式返回, 具体见 xml 格式中的验证结果 22 speedurl 设置加速器下载地址若没指定, 默认是当前目录下的 VJOcx3-ch-setup.exe

7 获取失败后, 会从 " cx3-ch-setup.exe" 下载 23 startdelay 设置加速器延时单位 : 秒仅对直播有效, 默认 :20 24 autoplay 设置是否自动播放 0: 不自动播放 1: 自动播放默认 :1 25 uimode 设置播放器界面模式 1: 完整 2: 只显示视频框 3: 只显示视频框和控制条 ( 隐藏设置按钮和进度条 ) 4: 只显示视频框和控制条 ( 隐藏设置按钮 ) 5: 只显示控制条 ( 隐藏设置截图和全屏按钮 ), 可在播放仅有音频的文件时使用默认 :1 26 showtime 设置是否显示系统时间 0: 不显示 1: 显示默认 :1 27 showtopmenu 设置是否显示顶部菜单 0: 不显示 1: 显示默认 :1 28 showrightmenu 设置是否显示右侧菜单 0: 不显示 1: 显示默认 :1 29 showcontrolbar 设置是否显示控制条 0: 不显示 1: 显示默认 :1 30 loop 设置是否循环播放 0: 不循环 1: 循环默认 :0 注 : 如果 src 属性指定的是 vjmsl 地址, 则该属性用于设置是否列表循环播放 31 item 设置优先播放的 url 序号序号从 0 开始, 默认 0 注 : 该属性仅当 furl 属性指定的文件 xml 中包含 vjmsl 地址时有效 32 customparam 设置 customparam 的值 customparam 的值会在访问控制和连接加速器时上报, 仅在播放 vjms 地址时有效 33 allowjs 设置是否允许播放器调用 JS 方法 0: 不允许 1: 允许

8 默认 :1 34 share 指定获取分享信息 (xml) 的地址 35 cturl 指定获取字幕信息的地址 36 showpnbutton 设置是否显示上一集 / 下一集按钮 37 allowclickpause 设置是否允许单击暂停 38 allowpausewhenlive 设置播放直播时是否允许暂停 39 tasktimeout 设置连接加速器超时时间 40 comments 指定获取弹幕信息 (xml) 的地址 41 questions 指定获取问题列表 (xml) 的地址 42 cover 指定获取封面的地址注 : 该属性设为 0 时, 播放器的方法和调用的方法都不可用支持的文件格式 :srt 0: 不显示 1: 显示默认 :0 0: 不允许 1: 允许默认 :1 0: 不允许 1: 允许默认 :0 单位 : 秒默认 :5 2. VJTVPlayer 方法表 ID 名字参数返回用途说明 1 play / play2 完整的 flashvars 参数字符串无播放指定的源源地址前必须加上类型标识, 如 "src=vjms://" 注 1: 自版本开始, 新增 play2 方法 IE8 及以下版本, 只能用 play2 方法其它浏览器,play 和 play2 方法均可用注 2: 以下版本, 只能用

9 play 方法, 且不支持 IE8 及以下版本的浏览器及以上版本, 建议用 play2 方法 2 setlanguage 语言环境字符串无切换播放器语言支持的参数 : zh_cn en_us 3 getplaytime / 无当前播放时获取播放时单位 : 秒 getplaytime2 间间注 : 自版本开始, 新增 getplaytime2 方法, 其余参考 play 方法注意事项 4 getduration 无播放总时长获取播放时单位 : 秒长 5 pause / pause2 无当前播放时间暂停播放注 : 参考 play 方法注意事项 6 resume / resume2 无无恢复播放注 : 参考 play 方法注意事项 7 stop / stop2 无无停止播放注 : 参考 play 方法注意事项 8 seek / seek2 跳转的时间无调整进度单位 : 秒注 : 参考 play 方法注意事项 9 setvolume 无无设置音量范围 : getdownloadpat h 1. 地址后面追加文件名的分隔符 2. 是否只追加扩展名下载地址获取下载地址参数 1, 默认 /, 若为空, 表示不追加文件名参数 2, 默认 false, 可省略, 参数 1 为空时忽略 11 setadinterval 间隔时间无设置重复获取设为 0 时, 表示仅在 vjms 广告间连接时获取单位 : 隔秒默认 :0 12 getbufferpercent 无缓冲时间的获取缓冲时间范围 :0-100 百分比百分比 13 getfilename 无文件名获取当前播放文件的文件名 14 previousvideo 无无播放上一个视注 : 仅当播放地址为

10 频 vjmsl 地址时有效 15 nextvideo 无无播放下一个视频如果当前播放的是列表中最后一个视频, 若 loop 属性为 1, 则自动播放第一个视频, 否则停止播放 16 sendcomment 弹幕内容 (json 字符串 ) 注 : 仅当播放地址为 vjmsl 地址时有效无发送弹幕 json 字符串中的字段名与发送请求的字段名必须相同, 没有指定的字段将采用默认值 17 showcomment 无无显示弹幕 18 hidecomment 无无隐藏弹幕发送请求的字段名参考附录中的发送弹幕请求 3. VJTVPlayer 调用的 JS 方法注意 : 下列方法, 只要页面代码里有与其名字一样的 js 方法, 播放器就会自动调用 ID 名字参数用途返回 1 share 无获取分享地址信分享地址信息 (xml) 息 2 lighton 无开灯无 3 lightoff 无关灯无 4 isready 无播放器提供的外无部接口注册完毕后调用 5 getrelated 无获取相关视频列表地址 ( 点播播相关视频列表信息 (xml) 放完毕后调用 ) 6 playstate 播放器状态可能的值 : ready: 准备完毕 playing: 正在播放 buffering: 正在缓冲 paused: 已暂停 complete: 播放完毕报告播放器状态无

11 previous: 播放上一个视频 next: 播放下一个视频 7 onverifycomplete 1. 验证结果汇报验证结果无可能的值 : 0: 失败 1: 成功 2. 原因 8 previousvideo 无播放上一个视频无 9 nextvideo 无播放下一个视频无 4. xml 格式注 : 所有 xml 文件必须采用 utf8 编码 4.1. 频道 <vjtv>  <channel size="n" first="0"> <channel0>  <name></name>  <purl></purl>  <url>  <sm></sm>  <sd></sd>  <hd></hd> </url> </channel0> <channeln> <name></name>

12 <purl></purl> <url> <sm></sm> <sd></sd> <hd></hd> </url> </channeln> </channel> </vjtv> 南京纳加软件有限公司广州纳加信息科技有限公司 4.2. 节目 <list>  <cname></cname>  <date></date>  <item size="n"> <item0>  <name></name>  <time></time>  <duration></duration>  <enabled></enabled>  <clip size="n"> <clip0>  <start></start>  <end></end>  <text></text> </clip0> <clipn> <start></start> <end></end> <text></text>

13 </clipn> </clip> </item0> <itemn> <name></name> <time></time> <duration></duration> <enabled></enabled> <clip size="n"> <clip0> <start></start> <end></end> <text></text> </clip0> <clipn> <start></start> <end></end> <text></text> </clipn> </clip> </itemn> </item> </list> 南京纳加软件有限公司广州纳加信息科技有限公司 4.3. 广告 <ad>   <buffer size="n" canclose="1"> <buffer0>  <width></width>  <height></height>  <url></url>  <duration></duration>  <link></link>

14 </buffer0> <buffern> <width></width> <height></height> <url></url> <duration></duration> <link></link> </buffern> </buffer>  <paused size="n" canclose="1"> <paused0> <width></width> <height></height> <url></url> <duration></duration> <link></link> </paused0> <pausedn> <width></width> <height></height> <url></url> <duration></duration> <link></link> </pausedn> </paused> <! 停止广告 --> <stop size="n" canclose="1"> <stop0> <width></width> <height></height> <url></url> <duration></duration> <link></link> </stop0> <stopn> <width></width> <height></height> <url></url> <duration></duration> <link></link> 南京纳加软件有限公司广州纳加信息科技有限公司

15 </ad> </stop> </stopn> 南京纳加软件有限公司广州纳加信息科技有限公司 4.4. 文件 <file>  <url>  <sm></sm>  <sd></sd>  <hd></hd> </url> </file> 4.5. 打点 <filedesc> <desc>  <filename></filename> </desc> <points size="n">  <point name="" time="" image="" text=""/> </points> < /filedesc >

16 4.6. 分享 <share>  <video></video>  <flash></flash>  <html></html> </share> 4.7. 相关视频 <related>  <next><next>  <item size="n"> <item0>  <url></url>  <image></image>  <title></title>  <text></text>  <duration><duration> </item0> <itemn> <url></url> <image></image> <title></title> <text></text> <duration><duration> </itemn> </item> </related>

17 4.8. 验证结果 <verify>  <result></result>  <reason></reason>  <url></url> </verify> 4.9. Logo <logo>  <url></url>  <x></x>  <y></y>  <width></width>  <height></height>  <alpha></alpha> </logo> 弹幕 <i>  <chatserver></chatserver>  <chatid></chatid>  <d p=""></d> <d p=""></d>

18 </i> 南京纳加软件有限公司广州纳加信息科技有限公司详细说明 : 字段名说明 chatserver 弹幕服务器地址, 发送弹幕时, 会向该地址发送请求 chatid 弹幕广播的索引 ( 暂时忽略 ) d 弹幕内容 p 弹幕属性, 每个参数之间用, 隔开第一个参数是弹幕出现的时间, 以秒数为单位第二个参数是弹幕的模式,1..3 滚动弹幕 4 底端弹幕 5 顶端弹幕 6. 逆向弹幕 7 精准定位 8 高级弹幕第三个参数是字号,12 非常小,16 特小,18 小,25 中,36 大,45 很大,64 特别大第四个参数是字体的颜色, 以 HTML 颜色的十位数为准第五个参数是 Unix 格式的时间戳, 基准时间为 :00:00 第六个参数是弹幕池,0 普通池 1 字幕池 2 特殊池目前特殊池为高级弹幕专用第七个参数是发送者的 ID, 用于屏蔽此弹幕的发送者功能 ( 没有设为 0) 第八个参数是弹幕在弹幕数据库中 rowid 用于历史弹幕功能 ( 没有设为 0) 例如 : <d p="166.1,1,25, , ,0,ce083fe2, "> 安全帽 </d> 以上弹幕内容表示 : 在整个视频秒的时候, 上部出现普通滚动弹幕, 字号为 12, 颜色为 (10 进制,16 进制为 &HFFFFFF, 即白色 ), 弹幕的发布日期为 (UNIX 时间戳, 为 1970 年 1 月 1 日 8 时到弹幕发布时间之间的秒数差 ), 弹幕发出者的 ID 为 ce083fe2, 内容为 : 安全帽问题列表 <questions>  <title></title>  <checkurl></checkurl>

19  <times size=""> <t>  <time></time>  <allowplay></allowplay>  <qs size=""> <q>  <id></id>  <type></type>  <text></text>  <image></image>  <choices size="">  <c></c> </choices> </q> </qs> </t> </times> </questions> 答案验证结果 <result>  <rids></rids>  <wids></wids>  <allowplay></allowplay> </result>

20 附录 1. 如何设置 VJTVPlayer 的属性 1) 使用 object 和 embed 标签嵌入 flash 时, 需要把所有要设置的属性都写在 flashvars 参数的 value 里如下图所示 : 设置 src logo 和 usep2p 属性 2) 使用 swfobject 嵌入 flash 时, 需以 object 变量的形式传入 swfobject 的 embedswf 方法的第 7 个参数 ( 注意 :VJTVPlayer 压缩包里的页面以该方法嵌入 flash) 如下图所示 : 设置 src logo 和 usep2p 属性 2. 发送弹幕请求每次用户发送弹幕, 播放器会向弹幕 xml 中记录的弹幕服务器地址发送 post 请求, 服

21 务器可根据收到的内容保存弹幕南京纳加软件有限公司广州纳加信息科技有限公司具体请求内容如下 : 字段名说明 stime 弹幕出现的播放时间, 单位 : 秒 mode 弹幕的模式可能的值 : 1-3: 滚动弹幕 4: 底端弹幕 5: 顶端弹幕 6: 逆向弹幕 7: 精准定位 8: 高级弹幕 size 弹幕字体大小 color 弹幕字体颜色, 以 HTML 颜色的十位数为准 date 指示弹幕发布的日期时间 timestamp 指示发送弹幕的时间, 格式 :Unix 格式的时间戳, 基准时间为 :00:00, 单位 : 秒 text 弹幕内容

手册 doc

手册 doc 1. 2. 3. 3.1 3.2 3.3 SD 3.4 3.5 SD 3.6 3.7 4. 4.1 4.2 4.3 SD 4.4 5. 5.1 5.2 5.3 SD 6. 1. 1~3 ( ) 320x240~704x288 66 (2G SD 320x2401FPS ) 32M~2G SD SD SD SD 24V DC 3W( ) -10~70 10~90% 154x44x144mm 2. DVR106