Query Media Plugin使用方法

jQuery Media Plugin是一款基于jQuery的网页媒体播放器插件，它支持大部分的网络多媒体播放器和多媒体格式，比如：Flash,Windows Media Player,Real Player,Quicktime,MP3,Silverlight,PDF。它根据当前的脚本配置，自动将a标签替换成div，并生成object,embed甚至是iframe代码，至于生成object还是embed，jQuery Media会根据当前平台自动判别，因此兼容性方面非常出色。下面这段代码是jQuery Media生成后的结果：

1 2 3 4 5 6 7 8 9 10 11 12 13

< div class = "media" >      < object width = "450" height = "250" attr1 = "attrValue1" attr2 = "attrValue2"          codebase = "http://www.apple.com/qtactivex/qtplugin.cab"          classid = "clsid:02BF25D5-8C17-4B23-BC80-D3488ABDDC6B" >          < param name = "src"      value = "myBetterMovie.mov" >          < param name = "autoplay" value = "true" >          < param name = "param1"   value = "paramValue1" >          < param name = "param2"   value = "paramValue2" >          < embed width = "450" height = "250" src = "myBetterMovie.mov" autoplay = "true"              attr1 = "attrValue1" attr2 = "attrValue2" param1 = "paramValue1" param2 = "paramValue2"              pluginspage = "http://www.apple.com/quicktime/download/" > </ embed >      </ object > </ div >

具体使用方法

html标记代码

1 2 3

< a class = "media" href = "sample.mov" >My Quicktime Movie</ a > < a class = "media" href = "sample.swf" >My Flash Movie</ a > < a class = "media" href = "sample.wma" >My Audio File</ a >

初始化脚本：

1	$( '.media' ).media();

选项

可以通过脚本对象或者jQuery Metadata Plugin来配置参数。

全局默认值：

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22

$.fn.media.defaults = { preferMeta: 1, // 如果为true,则标记的Meta值优先于脚本对象 autoplay: 0, // 标准化的跨播放器设置 bgColor: '#ffffff' , // 背景颜色 params: {}, // 作为param元素添加到object标记中；作为属性添加到embed标记中 attrs: {}, // 作为属性添加到object以及embed中 flashvars: {}, // 作为flashvars参数或属性添加到flash中 flashVersion: '7' , // 需要的最低flash版本 // 默认的flash视频和mp3播放器 // @see: http://jeroenwijering.com/?item=Flash_Media_Player flvPlayer: 'mediaplayer.swf' , mp3Player: 'mediaplayer.swf' , // Silverlight选项 // @see http://msdn2.microsoft.com/en-us/library/bb412401.aspx silverlight: {    inplaceInstallPrompt: 'true' , // 在适当的位置显示安装提示    iswindowless: 'true' , // 无窗口模式    framerate: '24' , // 最大帧速率    version: '0.9' , // Silverlight版本 onError: null,// onError回调函数    onLoad: null , // onLoad回调函数    initParams: null , // 对象初始化参数    userContext: null // 传到load回调函数的参数    } };

我们也可以在执行初始化脚本的时候传入一些option参数进去，如下代码：

1	$( '.media' ).media( { width: 400,height: 300,autoplay: true } );

再如代码：

1 2 3 4 5 6 7 8 9

$( '.media' ).media({    width: 450,    height: 250,    autoplay: true ,    src: 'myBetterMovie.mov' ,    attrs: { attr1: 'attrValue1' ,attr2: 'attrValue2' }, // object/embed attrs    params: { param1: 'paramValue1' ,param2: 'paramValue2' }, // object params/embed attrs    caption: false // supress caption text });

‘src’选项

src选项指定了媒体文件的地址。它没有全局的默认值。如果未显示指定src选项的值，jQuery Media Plugin将使用href或者src属性的值来代替。

播放器和格式

jQuery Media Plugin默认为播放器和格式如下表所示：

播放器	文件格式
Quicktime	aif,aiff,aac,au,bmp,gsm,mov,mid,midi,mpg,mpeg,mp4,m4a,psd,qt,qtif,qif,qti,snd,tif,tiff,wav,3g2,3pg
Flash	flv,mp3,swf
Windows Media Player	asx,asf,avi,wma,wmv
Real Player	ra,ram,rm,rpm,rv,smi,smil
Silverlight	xaml
iframe	html,pdf

mediaplayer.swf

上表说明了，mp3格式被自动对应到了flash播放器。全局配置中的$.fn.media.defaults.mp3Player指定MP3媒体由mediaplayer.swf文件播放。该swf文件是一个小型的mp3和flash视频播放器，可以从这里下载：http://www.longtailvideo.com/players/jw-flv-player/

SWFObject

这个脚本很常见，用来将Flash内容嵌入到网页中，你不用考虑不同平台的Flash嵌入方式。但这个文件并非必需。如果它加载了，jQuery Media Plugin将使用它，反之jQuery Media Plugin将按自己的默认方式生成object/embed标记。更多信息可以参考：http://code.google.com/p/swfobject/

iframe Player

默认情况下，PDF和HTML格式被映射到了iframe。它们将显示在iframe中而非object/embed标记中。

添加或者修改格式关联

这个操作可以由插件的mapformat方法实现，如

1	$.fn.media.mapformat( 'mp3' , 'quicktime' );

可用的播放器有：uicktime,flash,realplayer,winmedia,silverlight和iframe，确保播放器能够播放关联到它的文件格式。