PlayerAPI_v1.0.0

Size: px

Start display at page:

Download "PlayerAPI_v1.0.0"

沣扈
5 years ago
Views:

1 Player API 开发指南版本 : 日期 : 北京梦之窗数码科技有限公司

2 目录 1. 概述! 接口! 配置! 插件介绍! 字幕插件!... 4 附录 1. Flash 和 Javascript 交互!... 5 附录 2. 播放器错误码!... 5

3 1. 概述利用 Player API 与 CC 视频播放器进行交互, 可以改变播放器界面实现一些增值功能目前仅限于 Flash 播放器,FlashPlayer 插件版本要求为 10.1 及以上, 播放器页面代码中须允许播放器与页面脚本通信 2. 接口接口分为两种类型 : 方法回调 ; 方法 : 播放器开放的 JavaScript 函数, 播放器的句柄需要用Object 标签的 id 属性或 embed 的 name 属性来获取 ; 回调 : 播放器运行过程中的尝试调用页面JS 函数, 可理解为事件使用方法可参考附录 1. Flash 与 JavaScript 交互 ; 接口类型 start() 方法开始播放 pause() 方法暂停播放 resume() 方法恢复播放 seek(time) 方法定位至指定时间参数 time 单位秒 getduration() 方法获取视频片长, 返回值单位秒 getposition() 方法获取当前播放时间, 返回值单位秒 getvalidquality() 方法获取当前视频可用清晰度列表, 返回类型 Array, 长度 3,index 分别表示普通清晰高清每项的可能值 0 1, 分别表示不可用可用 setquality(quality) 方法设置清晰度参数 quality 取值分别表示普通清晰高清 setvolume(volume) 方法设置音量参数 volume 取值范围 0-1 normalscreen() 方法退出全屏 setconfig(config) 方法配置播放器参数 config 为配置对象, 详见3. 配置 on_cc_player_init(vid,objectid) 回调播放器界面元素初始化时 vid : 视频唯一标识 objectid : 页面中播放器的 id 3. 配置播放器配置可以改变播放器的界面, 开启更多的回调接口, 还可以使用一些特殊的功能, 如自定义全屏字幕功能第 1 页共 6 页

4 配置的方法是在回调接口 on_cc_player_init 触发时, 调用 setconfig 方法传递一个 Object 对象, 此对象每个 key 都是一个配置项, 对应的 value 就是所配置的值播放器所支持的配置项如下 : 配置项 control_enable progressbar_enable loadingpic_enable loading_enable bigbutton_enable tip_enable alert_enable recommend_enable keyboard_enable rightmenu_enable fullscreen_enable 是否显示控制条默认 1, 设置为 0 则不显示控制条是否可操作进度条默认 1, 设置为 0 则进度条不可操作是否启用缓冲片头默认 1, 设置为 0 则不会出现缓冲片头是否显示 loading 图标默认 1, 设置为 0 则不显示 loading 图标是否显示非自动播放是播放器中间的开始按钮默认 1, 设置为 0 则不显示开始按钮是否可显示播放器顶部的提示条默认 1, 设置为 0 则不再出现提示条是否可显示播放器中间的提示面板默认 1, 设置为 0 则不再出现提示面板是否启用播放结束后的推荐界面默认 1, 设置为 0 则播放结束后不显示推荐界面是否启用按键操作默认 1, 设置为 0 则按键操作不可用是否启用右侧菜单默认 1, 设置为 0 则不显示右侧菜单是否使用自定义全屏操作默认 0, 设置为 1 可以替代 Flash 全屏 fullscreen_function 替代 Flash 全屏的 JS 函数的名称, 需 fullscreen_enable 设置为 1, 这个函数需要返回一个值以确定当前状态 (0: 正常,1: 全屏 ) player_plugins on_player_stop on_player_pause on_player_resume on_player_ready on_player_start 配置播放器插件, 详见 4. 插件介绍播放结束后回调 JS 函数的名称默认 on_spark_player_stop 暂停播放时回调 JS 函数的名称默认 on_spark_player_pause 暂停后继续播放时回调 JS 函数的名称默认 on_spark_player_resume 播放器准备就绪回调 JS 函数的名称默认 on_spark_player_ready 开始播放时回调 JS 函数的名称默认 on_spark_player_start 第 2 页共 6 页

5 配置项 on_player_seek on_player_buffering on_player_setquality on_player_volumechange on_player_playerror on_player_fullscreen 指定时间定位时回调 JS 函数的名称回调时的参数 : from : 定位之前的时间点, 单位秒 to : 定位指定的时间点, 单位秒缓冲开始或结束时回调 JS 函数的名称回调时的参数 : flag : 是否缓冲中 (0: 否,1: 是 ) 清晰度改变时回调 JS 函数的名称回调时的参数 : quality : 当前清晰度, 可能值 (0: 普通,1: 清晰,2: 高清 ) 音量改变时回调 JS 函数的名称回调时的参数 : vol : 当前音量 ( 范围 0-1) 当播放失败时回调 JS 函数的名称回调时的参数 : code : 错误码, 详见附录 2. 播放器错误码全屏或退出全屏时回调 JS 函数的名称回调时的参数 : flag : 是否全屏 (0: 否,1: 是 ) 以下代码为配置示例 <script type="text/javascript"> function customfullscreen(){! //TODO 自定义全屏 function onplaypaused(){! // 已暂停播放 function on_cc_player_init( vid, objectid ){! var config = {;! config.fullscreen_enable = 1;! config.fullscreen_function = "customfullscreen"; // 设置自定义全屏函数的名称! config.on_player_pause = "onplaypaused"; // 设置当暂停播放时的回调函数的名称!! var player = getswf( objectid );! player.setconfig( config ); function getswf( swfid ) {! if( navigator.appname.indexof( "Microsoft" )!= -1 ){!! return window[ swfid ];! else {!! return document[ swfid ];! </script> 第 3 页共 6 页

6 4. 插件介绍插件是指基于播放器实现可插拔的独立功能块, 用户通过播放器配置启用插件, 从而可以使用相应的功能要使用插件时, 在 player_plugins 配置项中添加插件的名称和参数 4.1 字幕插件字幕插件可以让播放器在播放视频的同时显示相关文字, 启用时在配置中添加插件名称 Subtitle, 参数如下 : 参数 url 字幕文件地址, 仅支持 srt 格式的字幕文件, 此参数为必需参数 size 字体大小, 默认 20 color surroundcolor font 字体颜色, 默认 0xFFFFFF 文字环绕颜色, 默认 0x 字体名称, 默认 Times New Roman bottom 文本与播放区域底部的距离占播放区域高的百分比, 默认 0.15 code 字幕文件编码, 支持 utf-8 gbk, 默认 utf-8 注意事项 : 字幕文件所在的服务器根目录需要部署一个安全策略文件 ( crossdomin.xml ), 使播放器能够跨域访问字幕文件了解更多关于安全策略文件可访问 WS5b3ccc516d4fbf351e63e3d118a9b c85.html#WS5b3ccc516d4fbf351e63e3d118a9b e08 以下代码为字幕插件配置示例 <script type="text/javascript"> function on_cc_player_init( vid, objectid ){! var config = {;! config.player_plugins = {!! Subtitle : {!!! url : " size : 20!!!, color : 0xCCCCCC!!!, surroundcolor : 0x0000FF!!!, bottom : 0.15!!!, font : " 微软雅黑 "!!!, code : "gbk"!!! ;! var player = getswf( objectid );! player.setconfig( config ); </script> 第 4 页共 6 页

7 附录 1. Flash 和 Javascript 交互播放器的 HTML 代码中 allowscriptaccess 是一个与 Javascript 交互所必需的属性, 其值必须为 always; object 标签中 id 属性是 IE 内核浏览器中获取播放器句柄的关键, 在非 IE 内核浏览器中则是 embed 标签的 name 属性 ; 它们的值不能为空, 并且不能和页面其他元素重名可使用下例中的 getswf 函数来获取播放器句柄 ; 另外播放器回调接口 on_cc_player_init 会传递参数 objectid, 在这个回调接口中使用 getswf( objectid ) 也可获取到播放器句柄 <object... id="cc_a5feb0ea05f2100b9c33dc ">!...! <param name="allowfullscreen" value="true" />! <param name="allowscriptaccess" value="always" />! <embed... name="cc_a5feb0ea05f2100b9c33dc " allowfullscreen="true" allowscriptaccess="always"... /> </object> <script type="text/javascript">! function on_cc_player_init( vid, objectid ){!! var player = getswf( objectid );!! player.start();!! function getswf( swfid ) {!! if( navigator.appname.indexof( "Microsoft" )!= -1 ){!!! return window[ swfid ];!! else {!!! return document[ swfid ];!!!! </script> 附录 2. 播放器错误码代码 102 视频列表为空 103 无效的视频列表 108 列表模式视频信息加载失败 109 视频信息加载失败 110 视频审核中 111 用户流量用尽 112 用户账号被锁 113 视频处理中第 5 页共 6 页

8 代码 114 视频被屏蔽 115 视频信息错误 116 无视频文件 205 当前域名不允许播放 207 授权播放验证未通过 304 测速失败 305 切换清晰度失败 306 播放中播放失败第 6 页共 6 页

PlayerAPI_v1.0.5.pages

PlayerAPI_v1.0.5.pages Player API 开发指南版本 : 1.0.5 日期 : 2014-10-24 北京梦之窗数码科技有限公司目录 1. 概述... 1 2. 接口... 1 3. 配置... 2 4. 插件介绍... 5 4.1 字幕插件... 5 4.2 弹幕插件... 6 附录 1. Flash 和 Javascript 交互... 7 附录 2. 播放器错误码... 9 1. 概述利用 Player