搜索:
向播放器添加插件
增加功能
使用说明
插件制作示例
监听动作插件
修改右键
修改/增加右键菜单
修改,添加右键

调用播放器时的属性列表及相关说明

在查阅该文之前需要了解的内容如下:

调用播放器时的配置说明

正文:

在页面中调用播放器的主要代码形式如下:

var videoObject = {};
var player=new ckplayer(videoObject);

videoObject是一个对象,本文将列出该对象所有属性及属性的意义,注:是否必需指的是调用播放器时该属性是不是必需要设置

container
属性类型:string
功能说明:播放器窗口的idName或className
是否必需:必需
兼容环境:html5,flashplayer
默认值:自定义
属性说明:播放器所放置容器的idName(前面需加#,如container:'#video'),或className(前面需加.,如container:'.video')
variable
属性类型:string
功能说明:调用播放器的函数名称
是否必需:必需
兼容环境:html5,flashplayer
默认值:自定义
属性说明:该属性主要提供给flashplayer播放器使用,flashplayer在需要和调用函数交互时会使用到
video
属性类型:string/array/object
功能说明:定义播放地址,关于这个属性的详细说明可查看“安装调用->视频地址形式”
是否必需:必需
兼容环境:html5,flashplayer
默认值:
属性说明:该属性定义视频地址。可以是字符形式,可以是数组形式或对象形式,关于这个属性的使用可以参考手册中的以下内容:
普通视频地址
指定视频格式
页面地址调用
普通页调用形式
JSON调用-兼容形式
JSON调用-非兼容
视频地址加密
unescape
属性类型:Boolean
功能说明:播放地址是否需要使用解码,比如你的视频地址里包含“,”,播放器默认会认为该地址是多段视频地址组合而成的。此时你需要对该地址进行UrlEncode编码并同时设置unescape:true
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:
autoplay
属性类型:boolean
功能说明:是否自动播放
是否必需:非必需
兼容环境:html5,flashplayer
默认值:false
属性说明:false=默认暂停,true=默认播放,该属性还涉及到默认是否加载视频,可以在ckplayer.js或ckplayer.xml里找到节点config的autoLoad节点设置
loop
属性类型:boolean
功能说明:播放结束后是否循环播放
是否必需:非必需
兼容环境:html5,flashplayer
默认值:false
属性说明:false=播放结束后暂停,true=播放结束后重新播放
volume
属性类型:number
功能说明:初始音量
是否必需:非必需
兼容环境:html5,flashplayer
默认值:0.8
属性说明:初始化播放器的音量,如果静音,则设置成0,数值为0-1之间的小数
poster
属性类型:string
功能说明:封面图片
是否必需:非必需
兼容环境:html5,flashplayer
默认值:
属性说明:定义播放器默认暂停时显示的一张图片地址。
live
属性类型:boolean
功能说明:是否是直播视频
是否必需:非必需
兼容环境:html5,flashplayer
默认值:false
属性说明:false=点播/直播回看,true=直播视频
seek
属性类型:int
功能说明:默认跳转时间
是否必需:非必需
兼容环境:html5,flashplayer
默认值:0
属性说明:视频开始播放时要跳转的时间,该值主要用来做跳过片头等功能
drag
属性类型:string
功能说明:拖动时指定拖动请求的属性
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:视频跳转时间播放时,如果在flashplayer里需要跳转到未下载的时间点进行播放,播放器会向服务器请求一个新的视频地址如:temp.mp4?start=1255这样的地址,start=关键帧或关键帧对应的时间点,如果服务器不是用start来传递就需要设置drag=指定的属性。但在有些服务器端并不是按默认的来运行可以指定所有视频格式都按关键帧来跳转或都按关键时间点进行跳转,此时需要设置darg:'time_start'或'frames_start'。
duration
属性类型:int
功能说明:显示总时间
是否必需:非必需
兼容环境:flashplayer
默认值:0
属性说明:视频在默认不加载的情况下显示总时间
preview
属性类型:object
功能说明:预览图片地址
是否必需:非必需
兼容环境:html5,flashplayer
默认值:
属性说明:该属性定义播放器预览图片,属性类型为一个对象,对象里包含二个属性:file(array):定义预览图片的地址数组,scale(int):定义截图时间间隔,单位:秒。
示例如下:
preview:{
    file:['01.jpg','02.jpg'],
    scale:2
}
如果不想用对象传递,也可以用字符传递,示例如下:
preview:'01.jpg,02.jpg',
previewscale:2,
promptSpot
属性类型:array
功能说明:提示点
是否必需:非必需
兼容环境:html5,flashplayer
默认值:
属性说明:显示在播放器进度栏上的提示点,数组形式,数组里的数据是对象形式,各个对象有二个属性,分别是words:提示点的文字,time:提示点时间。
示例如下:
promptSpot:[
  {
     words:'提示点文字01',
     time:16
   },
  {
      words:'提示点文字02',
      time:60
   }
]
如果不需要使用对象传递,也可以用字符串形式的,示例如下(注意,s要小字):
promptspot:'提示点01,提示点02',
promptspottime:'16,60',
cktrack
属性类型:string
功能说明:字幕文件
是否必需:非必需
兼容环境:html5,flashplayer
默认值:
属性说明:定义字幕文件的路径,仅支持一个字幕文件,但字幕文件里支持多行。如果你有多个字幕文件,请合并成一个。
loaded
属性类型:string
功能说明:播放器加载后触发的函数
是否必需:非必需
兼容环境:html5,flashplayer
默认值:
属性说明:播放器加载成功后(并非视频加载成功)所要回调的js函数
debug
属性类型:boolean
功能说明:是否启用调试模式,正式使用时请设置为false
是否必需:非必需
兼容环境:html5,flashplayer
默认值:false
属性说明:该功能虽然兼容与html5及flashplayer,但主要是用于在flashplayer里使用。
flashplayer
属性类型:boolean
功能说明:是否强制使用flashplayer播放
是否必需:非必需
兼容环境:html5,flashplayer
默认值:false
属性说明:flase=播放器自动判断,优先使用html5播放器,true=仅使用flashplayer播放
config
属性类型:string
功能说明:指定配置函数(文件)
是否必需:非必需
兼容环境:html5,flashplayer
默认值:ckplayerConfig(ckplayer.xml)
属性说明:当在js环境中调用时,此处指定函数名称,当使用ckplayer.xml调用时,可以指定路径
rotation
属性类型:int
功能说明:默认旋转的角度
是否必需:非必需
兼容环境:flashplayer
默认值:0
属性说明:该功能只支持90,180,270,-90,-180,-270。如果视频的所在域相对于播放器域没有权限,则不能使用该属性
adfront
属性类型:string
功能说明:前置广告文件路径列表
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:支持swf,png,jpg,gif,mp4,flv,f4v,多个广告用英文逗号隔开
adfrontlink
属性类型:string
功能说明:前置广告的链接地址
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:该属性和adfront对应(即多个时用竖线隔开)。如果adfront是swf有自己的链接地址时,则对应的adfronglink设置成空即可
adfronttime
属性类型:string
功能说明:前置广告每个广告的播放时长
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:需和adfront对应。如果是视频广告并且必需强制播放完视频,则可以配置文件里进行设置,配置文件的设置可以查看“功能配置->功能配置”相关文章
adpause
属性类型:string
功能说明:暂停广告文件路径列表
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:支持swf,gif,png,jpg,不支持视频广告,请务必注意,多个用英文逗号隔开
adpauselink
属性类型:string
功能说明:暂停广告的链接地址
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:需和adpause对应,如果是swf,则留空
adpausetime
属性类型:string
功能说明:暂停广告如果是多个的话需要设置每个广告的播放时长
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:需要adpause对应。如果暂停广告仅有一个则不需要设置
adinsert
属性类型:string
功能说明:插入广告文件路径列表
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:支持swf,jpg,jpeg,png,gif,flv,f4v,mp4,播放器播放到指定时间开始播放的广告。多个广告需用英文逗号隔开。每次播放将播放完全部广告
adinsertlink
属性类型:string
功能说明:插入广告的链接地址
是否必需:非必需
兼容环境:html5,flashplayer
默认值:
属性说明:插入广告的链接地址,需要adinsert对应,swf广告不需要链接地址时可以留空
adinserttime
属性类型:string
功能说明:插入广告列表的每个广告对应的播放时间列表
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:时间需要adinsert对应。如果是视频广告并且必需强制播放完视频,则可以配置文件里进行设置,配置文件的设置可以查看“功能配置->功能配置”相关文章
inserttime
属性类型:string
功能说明:插入广告所要插入的时间点列表
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:在视频播放过程的指定时间点进行播放。要在多点插入请用英文逗号隔开,时间设置支持固定时间,单位秒,如在100秒和200秒时播放插入广告则:inserttime:'100,200',如果需要在视频播放到1/4和1/2时插入广告,则:inserttime:'25%,50%'。
adend
属性类型:string
功能说明:结尾广告文件路径列表
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:视频播放结束播放的广告,支持swf,jpg,jpeg,png,gif,flv,f4v,mp4,要求可参考前置广告的设置
adendlink
属性类型:string
功能说明:结尾广告链接地址
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:参考前置广告adfrontlink的要求
adendtime
属性类型:string
功能说明:结尾广告单个广告对应的时间列表
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:参考前置广告adfrontime的要求
advertisements
属性类型:string
功能说明:广告配置文件的路径,使用该属性时,则上面对于广告的配置全部无效。建议使用该属性对广告单独进行配置管理
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:如果你需使用广告,强制建议使用这属性进行配置。因为支持的功能远多于上述如adfront,adpause等属性的配置。有关于advertisements属性的使用,请查看:播放器广告单独配置
securetoken
属性类型:string
功能说明:rtmp协议直播时是否需要进行secureToken验证,如果使用,该属性设置为验证字符串
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:
fcsubscribe
属性类型:boolean
功能说明:rtmp协议直播时是否需要进行FCSubscribe验证
是否必需:非必需
兼容环境:flashplayer
默认值:false
属性说明:
username
属性类型:string
功能说明:rtmp协议直播时采用secureToken或FCSubscribe验证时的用户名
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:
password
属性类型:string
功能说明:rtmp协议直播时采用secureToken或FCSubscribe验证时的密码
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:
front
属性类型:string
功能说明:在html5环境中点击上一集按钮触发的函数名称
是否必需:非必需
兼容环境:html5
默认值:
属性说明:仅支持html5环境,flashplayer环境中的上一集下一集按钮的动作需要在风格文件style.xml里进行设置
next
属性类型:string
功能说明:在html5环境中点击下一集按钮触发的函数名称
是否必需:非必需
兼容环境:html5
默认值:
属性说明:仅支持html5环境,flashplayer环境中的上一集下一集按钮的动作需要在风格文件style.xml里进行设置
crossorigin
属性类型:string
功能说明:在html5环境中跨域截图功能,需要设置该属性,同时视频所有域需要有相应权限
是否必需:非必需
兼容环境:html5
默认值:
属性说明:仅支持html5环境
crossdomain
属性类型:string
功能说明:flashplayer环境指定跨域策略文件地址,比如跨域截图时需要
是否必需:非必需
兼容环境:flashplayer
默认值:
属性说明:仅支持flashplayer环境
playbackrate
属性类型:int
功能说明:html5环境中视频默认播放速度编号
是否必需:非必需
兼容环境:html5
默认值:1
属性说明:仅支持html5环境,注意是编号,并不是指速度值,编号的设置的ckplayer.js中搜索playbackRateArr
mobileCkControls
属性类型:Boolean
功能说明:html5环境中是否使用ck控制栏
是否必需:非必需
兼容环境:html5
默认值:false
属性说明:仅支持html5环境
建议了解以下相关内容:

播放器广告单独文件配置说明

支持清晰度-兼容

Powered by ckplayer.com
Copyright©ckplayer,2011-2017( 苏ICP备11026158号 )