video.js - jQuery 视频插件


Apache
跨平台
JavaScript

软件简介

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 属性。

  1. ‘data-setup’ 属性告诉 Video.js 当他页面加载完成后去自动设置 video,并且从属性(选项)中读取所有配置(JSON 格式)。还有其它初始化播放器的方法,但是这个是最简单的。

  2. 'id' 属性 :对于同一个页面中的每个 video 应该是唯一的

  3. 'class' 属性包含两个样式:

  4. video-js 应用所需的 Video.js 功能,如全屏和字幕样式。

  5. vjs-default-skin 为 HMTL 控制条应用默认的皮肤,可以被移除或重写,以创建你自己的控制条样式。

除此之外,include/excludesettingssourcestracks 属性可以像平时使用 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
文档

是接下来需要看的。