video.js

前端 多媒体
Video.js - 开源的 HTMl5 和 Flash 视频播放器

请注意!

master 分支现在是 5.0 的开发分支,在 5.0 第一个版本未发布之前都是不稳定的。如果你正在寻找最新稳定的版本,请查看 稳定分支awesomes-cn



Video.js logo

Video.js - HTML5 视频播放器 Build Status

Video.js 是一个有着 HTML5 背景的 web 视频播放器。它同时支持 HTM5 和 Flash 视频,以及 YouTube 和 Vimeo (通过 插件)。它支持在桌面和移动设备上的视频播放, 该项目于2010年年中启动,现在已经被使用在超过〜50000〜100000 个网站上。

快速入门

第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' 属性包含两个样式:
    • video-js 应用所需的 Video.js 功能,如全屏和字幕样式。
    • 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 文档 是接下来需要看的。

贡献

Video.js 是一个免费开源项目,你愿意做的任何贡献我们都会很感谢,查看 贡献指南

从源码构建你自己的 Video.js

为了定制你自己的 Video.js 版本,阅读 贡献代码 章节和 "构建你自己的副本"

许可

Video.js 是在 Apache License 下许可的, 2.0 版本. 查看许可文件

Copyright 2014-2015 Brightcove, Inc.

video.js 相关推荐
对于该库,你有要推荐的内容么?点此提交推荐
请文明评论,与人为善,比聪明更重要!
评论