Video.js 是一个开源的 Html5 jquery 视频插件,这个插件可以用来处理 Flash 视频,它还是一个多平台支持的产品。 Moreover,YouTube,Vimeo 等等的视频都可以很好地通过这个插件来播放。这个插件还支持桌面应用程序和其它的手持设备。
你可以下载 Video.js 的源码放到自己的服务器上,或者使用免费的 CDN 托管版本。现在推荐将 JavaScript 文件放到 <body> 标签中,而不是 <head>。但是 Video.js 包含了一个需要在 <head> 标签中引用的 ‘HTML5 Shiv’,为了让旧版本的IE浏览器识别 video 标签。
<body>
<head>
video
注意:如果你已经使用了一个 HTML5 shiv 比如 Modernizr ,你可以在任何地方引用 Video.js 的 JavaScript 文件。但是得确保该 Modernizr 版本中包含了针对 video 的 shiv。 如果你没有使用类似 Modernizr 的库,但是仍然想在 <body> 中引用 Video.JS,你可以添加你自己的 shiv,并且在 <head> 中引用它。
注意:如果你已经使用了一个 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 install --save video.js
$ 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
有了 Video.js ,您只需使用一个HTML5 <video> 标签嵌入视频即可。 Video.js 接下来会读取标签然后让它在所有浏览器中都可以工作,并非只有支持 HTML5 video 的浏览器。除了基本的标记,Video.js 还需要一些额外的标记。
<video>
注意:如果你使用了下面章节中的另外一种设置方法,那么这里就不应该设置 data-setup 属性。
data-setup
‘data-setup’ 属性告诉 Video.js 当他页面加载完成后去自动设置 video,并且从属性(选项)中读取所有配置(JSON 格式)。还有其它初始化播放器的方法,但是这个是最简单的。
'id' 属性 :对于同一个页面中的每个 video 应该是唯一的
'id'
'class' 属性包含两个样式:
'class'
video-js 应用所需的 Video.js 功能,如全屏和字幕样式。
video-js
vjs-default-skin 为 HMTL 控制条应用默认的皮肤,可以被移除或重写,以创建你自己的控制条样式。
vjs-default-skin
除此之外,include/exclude ,settings , sources 和 tracks 属性可以像平时使用 HTML5 video 一样使用。
include/exclude
settings
sources
tracks
<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 属性,然后手动初始化一个视频元素。
auto-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 样式,比如:
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 初始化完成后,就会触发这个回调。
'ready'
你也可以传入一个元素本身的引用来代替元素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 文档 是接下来需要看的。