video.jsjQuery 视频插件
Video.js 是一个开源的 Html5 jquery 视频插件,这个插件可以用来处理 Flash 视频,它还是一个多平台支持的产品。 Moreover,YouTube,Vimeo 等等的视频都可以很好地通过这个插件来播放。这个插件还支持桌面应用程序和其它的手持设备。
快速入门
第1步:将 Video.js 的 Javascript 和 CSS 文件包含在页面的 head 标签中
你可以下载 Video.js 的源码放到自己的服务器上,或者使用免费的 CDN 托管版本。现在推荐将 JavaScript 文件放到 <body>
标签中,而不是 <head>
。但是 Video.js 包含了一个需要在 <head>
标签中引用的 'HTML5 Shiv',为了让旧版本的IE浏览器识别 video
标签。
注意:如果你已经使用了一个 HTML5 shiv 比如 Modernizr ,你可以在任何地方引用 Video.js 的 JavaScript 文件。但是得确保该 Modernizr 版本中包含了针对 video 的 shiv。
如果你没有使用类似 Modernizr 的库,但是仍然想在
<body>
中引用 Video.JS,你可以添加你自己的 shiv,并且在<head>
中引用它。
<script type="text/javascript"> document.createElement('video');document.createElement('audio');document.createElement('track'); </script>
CDN 版本
感谢 Fastly 上的朋友,为我们提供了一个何人都可以免费使用的CDN托管版本的 Video.js,简单地将这些文件添加到您的页面文档的 <head>
中:
<link href="http://vjs.zencdn.net/4.12/video-js.css" rel="stylesheet"> <script src="http://vjs.zencdn.net/4.12/video.js"></script>
通过包管理器安装
NPM
$ npm install --save video.js
Bower
$ bower install --save video.js
自托管
要完全实现自托管,你需要 pull 字体文件,并且让 Video.js 知道 swf 的位置。如果你只是简单地复制 dist 文件夹或者 zip 文件内容到你的项目中,也可以正常工作,但是编辑 LESS 文件重新构建或者直接编辑生成好的 CSS 文件将会使得文件路径很容易被改变。
<link href="//example.com/path/to/video-js.css" rel="stylesheet"> <script src="//example.com/path/to/video.js"></script> <script> videojs.options.flash.swf = "http://example.com/path/to/video-js.swf" </script
第2步:添加一个 HTML5 video 标签到你的页面中
有了 Video.js ,您只需使用一个HTML5 <video>
标签嵌入视频即可。 Video.js 接下来会读取标签然后让它在所有浏览器中都可以工作,并非只有支持 HTML5 video 的浏览器。除了基本的标记,Video.js 还需要一些额外的标记。
注意:如果你使用了下面章节中的另外一种设置方法,那么这里就不应该设置
data-setup
属性。
-
'data-setup' 属性告诉 Video.js 当他页面加载完成后去自动设置 video,并且从属性(选项)中读取所有配置(JSON 格式)。还有其它初始化播放器的方法,但是这个是最简单的。
-
'id'
属性 :对于同一个页面中的每个 video 应该是唯一的 -
'class'
属性包含两个样式:-
video-js
应用所需的 Video.js 功能,如全屏和字幕样式。 -
vjs-default-skin
为 HMTL 控制条应用默认的皮肤,可以被移除或重写,以创建你自己的控制条样式。
-
除此之外,include/exclude
,settings
, sources
和 tracks
属性可以像平时使用 HTML5 video 一样使用。
<video id="example_video_1" class="video-js vjs-default-skin" controls preload="auto" width="640" height="264" poster="http://video-js.zencoder.com/oceans-clip.png" data-setup='{"example_option":true}'> <source src="http://video-js.zencoder.com/oceans-clip.mp4" type='video/mp4' /> <source src="http://video-js.zencoder.com/oceans-clip.webm" type='video/webm' /> <source src="http://video-js.zencoder.com/oceans-clip.ogv" type='video/ogg' /> <p class="vjs-no-js">To view this video please enable JavaScript, and consider upgrading to a web browser that <a href="http://videojs.com/html5-video-support/" target="_blank">supports HTML5 video</a></p> </video>
如果你不想使用 auto-setup
,你可以暂时不用设置 data-setup
属性,然后手动初始化一个视频元素。
var player = videojs('really-cool-video', { /* Options */ }, function() { console.log('Good to go!'); this.play(); // if you don't trust autoplay for some reason // How about an event listener? this.on('ended', function() { console.log('awww...over so soon?'); }); });
默认情况下,大的播放按钮是被定为在左上角的,这样就不会覆盖视频内容。如果你想让这个播放按钮居中,你可以给你的 video
标签添加额外的 vjs-big-play-centered
样式,比如:
<video id="example_video_1" class="video-js vjs-default-skin vjs-big-play-centered" controls preload="auto" width="640" height="264" poster="http://video-js.zencoder.com/oceans-clip.png" data-setup='{"example_option":true}'> ... </video>
为动态加载的 HTML 元素设置 Video.js
如果你的 web 页面或者应用是动态加载 video 标签的(ajax,appendChild,等等),这样在页面加载后这个元素是不存在的,那么你会想要手动设置播放器而不是依靠 data-setup
属性。要做到这一点,首先将 data-setup
属性从 video 标签中移除掉,这样在播放器初始化的时候就不会混乱了。接下来,运行下面的 javascript ,有时在 Video.js 加载后,有时是在 video 标签被加载进 DOM 后,
videojs("example_video_1", {}, function(){ // Player (this) is initialized and ready. });
videojs 方法中的第一个参数是你的 video 标签的 ID,用你自己的代替。
第二个参数是一个选项对象。它允许你像设置 data-setup
属性一样设置额外的选项。
第三个参数是一个 'ready'
回调。一旦 Video.js 初始化完成后,就会触发这个回调。
你也可以传入一个元素本身的引用来代替元素ID:
videojs(document.getElementById('example_video_1'), {}, function() { // This is functionally the same as the previous example. }); videojs(document.getElementsByClassName('awesome_video_class')[0], {}, function() { // You can grab an element by class if you'd like, just make sure // if it's an array that you pick one (here we chose the first). });
如果您无法播放内容,您得确保使用了 正确的格式,你的 HTTP 服务器可能无法提供正确的 MIME类型 的内容
如果你已经准备开始使用 Video.js, 为了获取更多信息,文档 是你第一个需要查看的。一般来说, 播放器 API 文档 是接下来需要看的。