JW media player 参数和播放列表.doc

JW media player 参数和播放列表参数这些参数可以配置被嵌入到html中的播放器的行为和外观。如果使用swfobject.js，可以用addVariable()方法来配置，如果使用的embed方式，可以通过定义flashvars属性来配置变量，注意用&符号分割这些变量。被*号标注的同样适用于?JW?Image?Rotator基本变量displayheight(number）：显示区域的高度.控制区域最小高度是20px，当该值大于或等于swf的高度时，播放列表会自动隐藏，否这会显示。file*(url）：要播放文件的地址。?支持单文件播放(MP3/FLV/RTMP/JPG/SWF/PNG/GIF)，也支持播放列表。JW?Image?Rotator只支持列表height*(number）：设置swf的高度，当使用embed方式插入的时候，在embed的属性里已经设置了。但是有时候（特别是使用IE的时候）高度会变的不确定，影响了布局，这时候需要通过该参数设置下，该值的单位是pximage(url）:当你播放mp3，flv的时候，你可以通过该值设置一个预览图作为专辑封面，支持?JPG/SWF/PNG/GIF?file.?你也可以在播放列表中对每一项进行设置。shownavigation*（true,false):该参数仅被JW?Image?Rotator支持。用来显示或隐藏图片导航。transition*?(fade,bgfade,blocks,bubbles,circles,fluids,lines,random,slowfade):?该参数仅被JW?Image?Rotator支持。用来设置图片替换的效果。?设置为random?将随机的设置效果.默认值为?fade.?width*(number):设置swf的宽度，其他同height；颜色变量backcolor*(color):设置播放器的背景颜色。JW?Media?Player等默认为?0xFFFFFF?(白色)?JW?Image?Rotator默认为?0x000000?(黑色).?fontcolor*(color):设置文字和按钮的颜色。JW?Media?Player等默认为?0x000000?(黑色)?JW?Image?Rotator默认为?0xFFFFFF?(白色).?lightcolor*(color):设置被被激活状态的颜色。JW?Media?Player等默认为?0x000000?(黑色)?JW?Image?Rotator默认为?0xCC0000?(红色).?界面参数autoscroll(true,false):当播放列表过长的时候，默认会自动显示滚动条。当该值设置为true的时候，会自动根据鼠标滚动播放列表。displaywidth(number?of?pixes):设置显示区域的宽度，当设置的比较小的时候，播放列表会显示在显示区域的右侧而不是底部。kenburns*?(true,false):?用以实现在运动的时候实现kb效果（Ken?Burns?effect），注意，当图比较大，而且网速比较快的时候，建议打开，否则关闭。建议设置transition为slowfade来配合。largecontrols?(true,false):?设置该值为true用来放大控制区域的按钮。建议为视力不好的用户打开logo*?(url):?设置一个图片用来作为右上角的水印，支持所有图片格式，支持通明图层的png效果最佳。overstretch*?(true,false,fit,none):?设置图片/影片在显示区域的缩放。true等比例拉伸用来符合显示区域。false仅拉伸合显示区域。fit全屏显示。none显示原始大小。JW?Media?Player等默认为fit,JW?Image?Rotator默认为falseshowdigits?(true,false,total):?设置为false隐藏播放时间等信息用来节省控制区域的空间。设置为total用来显示全部时间。showdownload?(true,false):设置该值用来在控制区域显示下载按钮。链接到link所设置的地址。showeq?(true,false):?用来显示一个假的音频波动效果。当播放mp3的时候打设置该值可以得到很好的效果showicons*?(true,false):?用来显示或者隐藏显示区域中间的图片，JW?Media?Player等默认为true。JW?Image?Rotator默认为false；showvolume?(true,false):?用来设置是否显示音量控制按钮thumbsinplaylist?(true,false):?设置列表中是否显示预览图播放参数autostart?(true,false,muted):?设置为ture，页面加载完后会自动播放。设置为muted，会在静音模式下自动播放，并且显示区域中间有静音图标。bufferlength?(number):?设置flv的缓存时间。默认为3秒repeat*?(true,false,list):?默认为flase，从当前播放位置播放到列表尾部后停止。设置为list会播放列表中所有的项目，设置为true会循环播放。rotatetime*?(number):?设置图片的显示时间。JW?Media?Player等默认为10秒,JW?Image?Rotator默认为5秒shuffle*?(true,false):?设置为false顺序播放，设置为true无序播smoothing?(true,false):?设置为false关闭视频平滑处理，推荐设置true用以得到更好效果。但对于大屏幕或者配置低的机器设置false是有好处的start*?(second):?在使用RTMP?或?HTTP?流媒体的时候（非常规的flv/mp3)，使用该变量准确的定位开始位置。该参数设置在XSPE格式的列表中以便准且的设置文件的章节。volume*?(number):?设置音量，默认为80.互动参数audio*?(url):用这个参数来添加一个mp3文件作为单独的音频，可以作为图片的背景音乐解说等。bwfile?(url):用以带宽检测的文件的地址，可以放一个图片，或者rtmp流媒体。可以在右键菜单中查看到贷款数值。?bwstreams?(comma-separated?list?of?bitrates):和bwfile配合使用，根据带宽值来选择不同的文件。如：你要播放video.flv并且设置该项的值为100,250,500,1000,当播放器发现带宽为349kbps的时候，将会播放video_250.flv。所以他有一套有效的命名设置，他将会自动切换，哪怕是在采用播放列表的情况下。callback?(url):设置这个参数为服务端程序（php/asp)地址用来回传数据。在每个项播放和停止的时候会发送数据到服务器，以便在服务器端保存播放统计。captions?(url):?设置该值用以载入一个文本格式的文本作为字幕。播放器至支持SMIL格式和DVD的SRT格式的字幕。如果你的flv文件内置字体你可以设置该值为captionate.如果你有多频道字幕，可以设置这个值为captionate0,?captionate3等。可以在列表中设置每一个项的值。enablejs*?(true,false):?设置为true打开对javascript的支持。仅支持在线使用。javascript可以控制播放，加载媒体，获得当前播放项的详尽信息。fsbuttonlink?(url):如果用户的flashplayer版本高于（9.0.28）播放器会自动的显示一个全屏按钮。通过设置该值，你可以链接到另外的页面用以全屏显示。服务端程可以设定将要播放的文件。id?(string):?播放器的唯一标识。将会被回传到服务器端。javascriptid*?(string):如果你的页面上有多个播放器，你可以设置这个参数给每个播放器不同的id，这样就可以方便的用javascript来控制。他将回传到getUpdate（）事件中。link?(url):?通过这个参数用来设置一个可现在的版本，或者强制用户通过该地址下载当前项。可以在播放列表中为每一项设置该值。linkfromdisplay*?(true,false):设置显示区域被点击时要访问的页面。默认点击显示区域时会进行播放/暂停操作。linktarget*?(frame):?设置链接目标，_self在当前页打开。_blank在新页面中打开。streamscript?(url):设置这个参数为了兼容伪流媒体FLV文件。type?(mp3,flv,rtmp,jpg,png,gif,swf,rbs,3gp,mp4,m4v):?播放器会根据文件名的最后三个字符来判断类型。在你使用服务器端语言进行重定向时，这种方法将不会再有效。所以你可以设置这个参数来告诉播放器文件类型。你也可以在播放列表中对每一项进行设置。如果播放器找不到文件类型将会被识别为播放列表。useaudio?(true,false):?设置为false用来改变为静音状态。usecaptions?(true,false):设置为false隐藏字幕.?usefullscreen?(true,false):如果你不希望用flashplayer9的全屏模式。可以设置fsbuttonlink参数用来替换全屏按钮的事件。usekeys?(true,false):?设置为false用来取消键盘操作(SPACE,UP,DOWN,LEFT,RIGHT)注意：你必须对?=&进行字符转移。?%3F,?=?%3D,?&?%26.?你的file?变量为getplaylist.php?id=123的时候必须设置为?getplaylist.php%3Fid%3D123.播放列表当播放列表中只有一个项目的时候，播放器会用单文件播放模式进行播放。播放器根据文件名来区分单文件和播放列表文件。如你的加载文件名为test.mp3的文件，播放器会用单文件播放模式去播放mp3，因为扩展名是mp3.如果你的文件名是getlist.php,播放器会认为这是个播放列表。如果你使用了动态脚本来加载一个单文件如播放器支持三种常用的播放列表格式来确保通用性。XSPF，RSS和ATOM。播放器所支持的XSPF/RSS/ATOM列表的通用标签。表格*Image?Rotator仅支持播放列表中的第一个audio项，被用来做为背景音乐来播放。播放器会播放所有的音乐项目。*?category?元素可以用来支持广告。你可以设置该值为preroll,?postroll?或?overlay.?使用link播放列表中单项的值为广告地址。*?start元素只被XSPF的播放列表格式支持。该元素用来设置流媒体文件（HTTP?or?RTMP)的开始位置，单位为秒。*?XSPF列表格式中的location元素中如果不包含常见的扩展名(如?mp3?or?flv),可以使用meta元素指定文件格式。(如?mp3?).在使用RSS和ATOM的情况下,文件格式被自动的根据mimetype来识别。?RTMP?streams,?the?additional?id?flashvar?has?to?be?sent?as?well.?Example:?file=rtmp:/my.streaming.server/mypath?and?id=video_one.注意，当你播放单文件的时候，你支持所有的参数,如你可以添加一个