帮助手册>功能配置>初始化配置

flashvars对象里所有属性的功能

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

在调用播放器时,都需要给播放器传递一些参数,比如视频地址,是否默认播放等。在ckplayer中,默认传递的这些参数都由一个对象来定义,即var falshvars={}。该对象里包含了各种需要传递的属性。比如p是用来定义视频默认暂停还是播放或未加载。

flashvars对象示例:

var flashvars={
    f:'http://vf3.mtime.cn/Video/2016/04/14/flv/160414173112113429.flv',
    c:0,
    p:1
};

该示例定义了一个视频播放地址(f),并同时定义了配置文件使用ckplayer.js中的ckstyle()函数(c),p=1说明视频自动播放。

请注意:

一:该对象的属性并不是固定的,如果你开发一个插件需要用到动态传值,也可以在该对象中自定义参数。

二:flashvars对象所定义的参数并不是只能在调用播放器时定义,也可以在其它地方定义,比如ckplayer.js中的ckstyle()函数中的flashvars或ckplayer.xml中的<flashvars></flashvars>中,如果使用动态调用视频地址的方式,也可以在调用文件里定义。有关于这个的详细说明在本文的最下方有详细的说明。

参数按功能可以分为以下几大类:

1、视频调用类:s,f,a

2、配置加载类:c,x

3:前置广告类:l,r,t,y

4:暂停广告类:d,u

5:缓冲广告类:z

6:初始化类:i,e,v,p,h,q,b,m,o,w,g,j,k,n,wh,lv,loaded

7:直播配置类:st,fc,un,up

8:插件(自定义)类:my_title,my_url,my_pic

9:其它

三:这些参数并不是固定的,也可以自定义。比如不使用f指定视频地址,而使用file指定视频地址。这个功能为属性替换功能,可以在配置文件里设置替换规则

四:下面介绍中所用到的数组间隔符为"|",也可以指定为其它符号。可以在配置文件里设置数组间隔符

下面列出flashvars对象中所有的ckplayer本身的参数以及常用插件所用到的参数:

s

默认值:0

参数说明:视频地址调用方式,共分6种方式,分别如下:

0=普通调用,此时f='视频地址,支持http协议和rtmp协议视频,支持多个视频地址组合成一个完整的视频进行播放,中间用|隔开',详细可查看普通形式调用

1=网址形式,此时f='输出视频地址的一个网址(支持动态规则)',详细可查看文本形式的调用

2=XML形式,此时f='输出视频地址的一个XML格式网址(支持动态规则)',详细可查看XML文件调用方式

3=SWF普通形式。此时f='一个swf文件,该swf文件向播放器发送网址',详细可查看普通swf形式调用

4=SWF视频流形式,此时f='一个swf文件,该swf文件向播放器发送视频流',详细可查看视频流形式swf文件调用方式

5=json形式,此时f='输出视频地址的一个json格式网址(支持动态规则)',详细可查看JSON形式调用方式

f

默认值:无

示例:f:'http://vf3.mtime.cn/Video/2016/04/14/flv/160414173112113429.flv'

参数说明:该值是配合s使用的,具体值视s值决定。详细说明请参考s值

a

默认值:无

参数说明:该值是配合s,f使用,当s=0时,a值为空,当s>0时,可以使用a值和f值动态组装成新的地址,示例:

var flashvars={
    s:1,
    f:'geturl.php?id=[$pat]',
    a:'12'
}

该示例是以s=1举例,此时,播放器会访问geturl.php?id=12这个地址。该地址里输出一个视频地址供播放器播放。如果此时网址里有多个参数,则使用方法如下:

var flashvars={
    s:1,
    f:'geturl.php?id=[$pat]%26id2=[$pat1]',
    a:'12|ab'
}

此时会访问:geturl.php?id=12&id2=ab这个地址,请注意,f的值不能有&,如果有,需要用%26代替,请自行转换。a值会以|为分隔成一个数组,从上面的地址可以看出[$pat]为被替换成数组下标0的值:12,[$pat1],[$pat2]则以此类推,支持无限个参数,另外注意的是[$pat]和[$pat0]是等效的,详细可查看文本形式的调用

c

默认值:1

参数说明:该值指定播放器加载何种配置文件来配置播放器的界面,语言,设置。0=加载ckplayer.js中的ckstyle()函数

1=调用ckplayer.xml来做配置。

另注意:即使指定了c值,在当前配置不能加载到时同样会自动加载另一项配置。比如c=0时,播放器找不到ckstyle()函数,则会自动请求ckplayer.xml

x

默认值:无

参数说明:该值可以另外指定配置文件,当c=1时,可以不使用默认的ckplayer.xml,而指定另外的配置文件,当c=0时,可以不调用ckstyle(),你可以根据需要指定调用另外的函数

i

默认值:无

参数说明1支持HTML5,该值是指定播放器默认暂停或默认不加载视频情况下显示一张图片在播放器上。

参数说明2:该值兼容HTML5,即HTML5同时也用这个值指定初始默认图片

p

默认值:0

参数说明支持HTML5,设置视频是否自动播放,

0=默认暂停

1=默认播放

2=默认不加载视频

v

默认值:80

参数说明支持HTML5,音量,取值范围0-100,该值只是设置默认音量,用户可以通过键盘操作音量大于100

h

默认值:0

参数说明:该参数只对http协议视频有效,播放视频时采用何种方式拖动视频

0=简单拖动,即只能在已加载的内容里进行拖动

1=按关键帧进行拖动,此设置需要服务器支持,同时需要视频本身包含关键帧

2=按关键时间点进行拖动,此设置需要服务器支持,同时需要视频本身包含关键时间点

3=按后缀名自动判断按关键帧(mp4)还是时间点(flv)进行拖动

4=按关键字判断。即,如果视频地址中包含mp4,则按关键帧,包含flv则按时间点

示例说明:比如按关键时间点拖动时,比如拖动到20秒,播放器则会重新请求如1.flv?start=20,这个start是服务器上默认的参数。如果更改了此项配置,则需同时改变q值

q

默认值:start

参数说明:当h>0时,拖动后的参数属性。比如按关键时间点拖动时,比如拖动到20秒,播放器则会重新请求如1.flv?start=20,这个start是服务器上默认的参数,可以更改

o

默认值:无

参数说明:当p=2时,默认不加载视频,但又需要在播放器上显示一个总时间,则这里可以设置总时间,该参数支持以|间隔的数组形式。即如果视频是多段视频,则这里也需一一对应

w

默认值:无

参数说明:当p=2时,默认不加载视频,但同时设置了o值,这里需要对应设置视频的字节数,支持以|间隔的数组形式

g

默认值:0

参数说明:视频直接从该时间点进行播放,可以用于跳过片头或记忆播放功能,该参数支持如下格式

Int(大于0的数字)=直接从指定的秒数进行播放

String(时:分:秒)=标准时间格式,比如02:50,则从2分50秒进行播放,01:20:02,表示从1小时20分2秒进行播放

j

默认值:0

参数说明:跳过片尾功能,该功能只支持在所设置的时间点发送播放结束命令

大于0时,表示当播放到该时间时则发送命令。如200,则播放到200秒时发送结束命令

小于0时,表示当播放到(总时间-该时间点)时发送命令,比如视频总时间为1000秒,j=100,则播放到900秒时发送结束命令

k

默认值:无

参数说明:提示点功能,进度栏上支持提示点功能,提示点只能提示文字信息。该值指定提示点所在的时间

示例:k:'30|60|100',说明在30秒,60秒,100秒的时间点上显示一个提示点

n

默认值:无

参数说明:提示点功能,当k属性不为空时,需要同步设置该属性。也是以|为间隔的数组

示例:n:'提示1|提示2|提示3',跟上面的k属性配置使用时说明在鼠标经过30秒的提示点时会显示文字"提示1",以此类推

e

默认值:1

参数说明支持HTML5,播放结束时的动作:

0=调用js函数,默认是:function playerstop(){},可以在配置文件里更改

1=循环播放

2=暂停播放并且不调用广告

3=调用视频推荐列表的插件

4=清除视频流并调用js功能

5=暂停播放并且调用暂停广告

m

默认值:无

参数说明支持HTML5,指定视频的链接地址,当该参数不为空时。点击视频会跳转到该地址

lv

默认值:0

参数说明:指定播放器是否是直播形式

0=普通方式

1=直播形式,此时播放器的进度条将被锁定。显示时间的文本内容也显示:正在直播。可以在language.xml时更改显示文字

wh

默认值:无

参数说明:指定视频的宽高比,比如16:9,则宽高按16:9的宽高比进行显示

st

默认值:0

参数说明:rtmp协议直播时是否需要进行secureToken验证

fc

默认值:0

参数说明:rtmp协议直播时是否需要进行FCSubscribe验证

un

默认值:无

参数说明:rtmp协议直播时采用secureToken或FCSubscribe验证时的用户名

up

默认值:无

参数说明:rtmp协议直播时采用secureToken或FCSubscribe验证时的密码

l

默认值:无

参数说明:前置广告地址,支持以|隔开的数组形式,支持普通的jpg,png图片,swf以及视频,当有多个广告时支持顺序播放,随机播放全部广告,随机播放指定数量的广告

示例:r:'adv.png|adv.jpg|adv.swf|adv.flv'

r

默认值:无

参数说明:前置广告的链接地址,支持以|隔开的数组形式,swf可以不是必需要指定链接地址

示例:r:'linkjpg.htm|linkpng.htm||linkflv.htm'

t

默认值:无

参数说明:前置广告的播放时间,如果广告是视频广告,则不是必需要设置

示例:t:'5|6|10|15'

y

默认值:无

参数说明:如果不想在这里设置广告内容,则可以通过y参数指定一个动态地址来设置广告

示例:y:'adv.php',adv.php里输出{r->adv.png|adv.jpg|adv.swf|adv.flv}{t->5|6|10|15},注意,adv.php里不能有其它html语言

d

默认值:无

参数说明:暂停广告地址,支持以|隔开的数组形式,支持普通的jpg,png图片,swf,注意不支持视频

u

默认值:无

参数说明:暂停广告链接地址,多个广告需以|隔开,swf不是必需要设置链接地址

z

默认值:无

参数说明:缓冲时显示的广告,使用该功能要在配置文件里设置启用才行

b

默认值:0

参数说明:是否允许和播放器进行交互,0=允许,1是不允许

loaded

默认值:无

参数说明:播放器加载后调用的js函数名称,应用示例可查看:单独监听/删除监听的一个示例,以及:示例:控制播放器暂停/播放

er

默认值:无

参数说明:加载失败或播放视频失败时显示的文字,如果定义了该属性,则language.xml里的pr_noload节点需包含字符:“[$error]”

fs

默认值:0

参数说明:是否允许全屏模式下在播放器中输入文本,该属性主要用来在制作插件时用到文本框时才需要。详细的可以了解:支持全屏模式下输入文本


插件所需要的参数不在此处一一列出。具体可以查看插件使用的说明

Powered by ckplayer.com  
Copyright©ckplayer,2011-2016