Video.js随笔记

下载与介绍

　　Video.js是一款web视频播放器，支持html5和flash两种播放方式。更有自定义皮肤，插件，组件，语言还有丰富的选项配置。

　　官网下载地址：https://videojs.com/getting-started/

　　GitHub下载地址：https://github.com/videojs/video.js

入门使用

1. 引入video.js和video-js.css

   <link href="https://cdnjs.cloudflare.com/ajax/libs/video.js/7.3.0/video-js.min.css" rel="stylesheet">
   <script src="https://cdnjs.cloudflare.com/ajax/libs/video.js/7.3.0/video.min.js"></script>

2. 使用下面的video标签，如下代码

     <video id="example_video_1" class="video-js vjs-default-skin" controls preload="none" width="640" height="264" poster="http://vjs.zencdn.net/v/oceans.png">
       <source src="test1.mp4"  type="video/mp4">
     </video>

3. .video.js的使用方式是以类似的方式开始的，不过我们能借助videojs对视频进行一些控制或定制

   //创建一个简单的实例
   var player = videojs('',{
      muted: true,
      controls: true/false,
      height: 300,
      width: 300,
      loop: true,
   });

常用事件

1. 播放 this.play()
2. 停止，video.js没有此方法，可以借助pause来达到同样的效果
3. 暂停 this.pause()
4. 销毁 this.dispose()
5. 监听 this.on('click',function(){})
6. 触发事件this.trigger('dispose')

实例讲解　　

var options = {};
var player = videojs(‘example_video_1‘, options, function onPlayerReady() {
videojs.log(‘播放器已经准备好了!‘);
// In this context, `this` is the player that was created by Video.js.<br>  // 注意，这个地方的上下文， `this` 指向的是Video.js的实例对像player
this.play();
// How about an event listener?<br>  // 如何使用事件监听？
this.on(‘ended‘, function() {
    videojs.log(‘播放结束了!‘);
  });
}); 

常用选项

选项名	设置值	选项说明
autoplay	true/false	播放器准备好之后是否自动播放 默认为false
controls	true/false	是否拥有控制条 【默认true】,如果设为false ,那么只能通过api进行控制了。也就是说界面上不会出现任何控制按钮
height	单位为px	视频容器的高度，字符串或数字 单位像素
width	单位为px	视频容器的宽度, 字符串或数字 单位像素
loop	trule/false	视频结束之后是否循环播放
muted	true/false	是否静音
poster	url地址	播放前显示的画面类似封面图
preload	auto/metadata/none	预加载:自动，元数据信息比如视频大小，视频尺寸等，不预加载任何数据，直到用户开始播放才开始下载
children	array/object	可选子组件 从基础的Component组件继承而来的子组件，数组中的顺序将影响组件的创建顺序

options选项

标准元素选项

这些选项中的每一个也可用作标准元素属性 ; 因此，可以使用设置指南中列出的所有三种方式定义它们。通常，未列出默认值，因为这是留给浏览器供应商的。

　　autoplay

　　　　类型：autoplay

　　　　如果true/作为存在，则播放器准备就绪时就开始播放

　　　　注意从IOS10 开始，Apple autoplay在Safari中提供支持。有关详细信息，请参阅“新增功能。

　　controls

　　　　类型： boolean

　　　　确定播放器是否具有用户可以与之交互的控件。没有控件，启动视频播放的唯一方法是使用autoplay属性或通过Player API。

　　width

　　　　类型： string|number

　　　　设置视频播放器的显示宽度(以像素为单位)

　　height

　　　　类型：string|number

　　　　设置视频播放器的显示高度(以像素为单位)

　　loop

　　　　类型：boolean

　　　　使得视频一播放完就重新开始

　　muted

　　　　类型：boolean

　　　　默认情况下会静音任何音频

　　poster

　　　　类型：string

　　　　在视频开始播放之前显示的图像的URL。这通常是视频的框架或自定义标题屏幕。一旦用户点击“播放”，图像就会消失。

　　preload

　　　　类型：string

　　　　1. 建议浏览器是否应在加载元素后立即开始下载视频数据。支持的值是：‘auto’

　　　　2. 立即开始加载视频（如果浏览器支持）。某些移动设备不会预加载视频，以保护用户的带宽/数据使用。这就是为什么这个价值被称为’汽车’，而不是更具决定性的东西’true’。

　　　　3. 这往往是最常见和推荐的值，因为它允许浏览器选择最佳行为。‘metadata’

　　　　4. 仅加载视频的元数据，其中包括视频的持续时间和尺寸等信息。有时，元数据将通过下载几帧视频来加载。'none’

　　　　5. 不要预加载任何数据。浏览器将等待用户点击“播放”开始下载。

　　src

　　　　类型：string

　　　　要载入的视频源URL地址

　　video.js特定选项

　　　　undefined除非另有说明，否则默认情况下每个选项

　　aspectRatio

　　　　类型：string

　　　　将播放器置于流体模式，并在计算播放器的动态大小时使用该值。该值应表示比率 - 由冒号（例如"16:9"或"4:3"）分隔的两个数字。

　　autoSetup

　　　　类型：boolean

　　　　阻止播放器为具有data-setup属性的媒体元素运行autoSetup ，注意：必须在与videojs.options.autoSetup = falsevideojs源加载生效的同一时刻全局设置。

　　children

　　　　类型：array|object

　　　　此选项继承自基于Component类。

　　fluid

　　　　类型：boolean

　　　　何时true，Video.js播放器将具有流畅的大小。换句话说，它将扩展以适应其容器。此外，如果元素具有"vjs-fluid"，则此选项自动设置为true。

　　inactivityTimeout

　　　　类型：number

　　　　Video.js表示用户通过"vjs-user-active"和"vjs-user-inactive"类以及"useractive"事件与玩家进行交互。

　　　　在inactivityTimeout决定了不活动的许多毫秒声明用户闲置之前是必需的。值为0表示没有inactivityTimeout，用户永远不会被视为非活动状态。

　　language

　　　　类型：string

　　　　浏览器默认值或者为‘en’，与播放器中的一种可用语言匹配的语言代码。这为播放器设置了初始语言，但始终可以更改。在Video.js中了解有关语言的更多信息。

　　languages

　　　　类型：Object

　　　　自定义播放器中可用的语言。此对象的键将是语言代码，值将是具有英语键和翻译值的对象。在Video.js中了解有关语言的更多信息

　　　　注意：通常，不需要此选项，最好将自定义语言传递给videojs.addLanguage()所有用户！

　　navtiveControlsForTouch

　　　　类型：boolean

　　　　明确设置关联技术选项的默认值

　　noSupportedMessage

　　　　类型：string

　　　　允许覆盖video.js无法播放媒体源时显示的默认消息

　　playbackRates

　　　　类型：array

　　　　严格大于0的数字数组，其中1表示常速（100％），0.5表示半速（50％），2表示双速（200％）等。如果指定，Video.js显示控件（类vjs-playback-rate）允许用户从选择数组中选择播放速度。选项以从下到上的指定顺序显示

videojs('my-player',{
    playbackRates: [0.5,1,1.5,2]
});

　　　plugin

　　　　类型：object

　　　　这支持在初始化播放器时使用自定义选项自动化插件，而不是要求您手动初始化他们

videojs('my-player', {
  plugins: {
    foo: {bar: true},
    boo: {baz: false}
  }
});
//以下相当于
var player = videojs('my-player');
 
player.foo({bar: true});
player.boo({baz: false});
//虽然，由于plugins选项是对象，因此无法保证初始化顺序！
//有关Video.js插件的更多信息，请参阅插件指南。

　　　sources

　　　　类型：array

　　　　一组对象，它们反映了本机元素具有一系列子元素的能力。这应该是带有src和type属性的对象数组。例如：

videojs('my-player', {
  sources: [{
    src: '//path/to/video.mp4',
    type: 'video/mp4'
  }, {
    src: '//path/to/video.webm',
    type: 'video/webm'
  }]
});

　　　　使用以下元素有相同的效果

<video ...>
  <source src="//path/to/video.mp4" type="video/mp4">
  <source src="//path/to/video.webm" type="video/webm">
</video>

　　techCanOverridePoster

　　　　类型：boolean

　　　　使技术人员有可能覆盖用户的海报并融入玩家的海报生命周期。当使用多个技术时，这可能很有用，每个技术都必须在播放新源时设置自己的海报。

　　techOrder

　　　　类型：array

　　　　默认值为‘HTML5’，定义Video.js技术首选的顺序。默认情况下，这意味着Html5首选技术。其他注册的技术将在此技术之后按其注册顺序添加。

　　vtt.js

　　　　类型：string

　　　　允许覆盖vtt.js的默认URL，改URL可以异步加载到polyfill支持WebVTT，此选项将用于Video.js（即video.novtt.js）的“novtt”版本中。否则，vtt.js与Video.js捆绑在一起。

组件选项

Video.js播放器是一个组件。与所有组件一样，您可以定义它包含的子项，它们出现的顺序以及传递给它们的选项。

这是一个快速参考; 因此，有关Video.js中组件的更多详细信息，请查看组件指南。

　　children

　　　　类型：array|object

　　　　如果是array，这是默认值，用于确定哪些子节点（按组件名称）以及在播放器或其他组件上创建上的顺序

// The following code creates a player with ONLY bigPlayButton and
// controlBar child components.
videojs('my-player', {
  children: [
    'bigPlayButton',
});

　　　　该children选项还可以作为传递Object，在这情况下，它用于options任何、所有children,包括禁用他们为false

// This player's ONLY child will be the controlBar. Clearly, this is not the
// ideal method for disabling a grandchild!
videojs('my-player', {
  children: {
    controlBar: {
      fullscreenToggle: false
    }
  }
});

　　${componentName}

　　　　类型：boolean

　　　　可以通过组件名称的低驼峰案例变体（例如controlBarfor　　controlBar）为组件提供自定义选项，这些可以嵌套在孙子关系的表示中，例如要禁用全屏控件

videojs('my-player', {
  controlBar: {
    fullscreenToggle: false
  }
});
//依靠技术来选择

　　${techName}

　　　　类型：Object

　　　　Video.js回放技术（即“技术”）可以作为传递给该videojs功能的选项的一部分给予自定义选项。它们应该在技​​术名称的小写变体下传递（例如"flash"或"html5"）。

　　flash

　　　　类型：string

　　　　swf，指定video.js SWF在flash文件中的位置

videojs('my-player', {
  flash: {
    swf: '//path/to/videojs.swf'
  }
});
//但是，修改全局默认值通常更加合适
videojs.options.flash.swf =   '//path/to/videojs.swf'

　　navtiveControlsForTouch

　　　　类型：boolean

　　　　只有支持HTML5，此选项可以设置为true为强制触摸设备的本机控件

　　nativeAudioTracks

　　　　类型：boolean

　　　　可以设置为false禁用本机音轨的支持，最常用于videojs-contrib-his

　　navtiveTextTracks

　　　　类型：boolean

　　　　可以设置为false强制模拟文本轨道而不是本机支持。该navtiveCaptions选项也存在，但只是一个别名navtiveTextTracks

　　navtiveVideoTracks

　　　　类型：boolean

　　　　可以设置为false禁用本机视频轨道支持，最常用于videojs-contrib-his。