videojs中⽂⽂档详解
⼊门使⽤
引⼊video.js和video-js.css
<link href="cdnjs.cloudflare/ajax/libs/video.js/7.3.0/video-js.min.css"rel="stylesheet">
<script src="cdnjs.cloudflare/ajax/libs/video.js/7.3.0/video.min.js"></script>
使⽤video标签就像下⾯这样:
<video id="example_video_1"class="video-js vjs-default-skin"controls preload="none"width="640"height="264"
poster="dn/v/oceans.png">
<source src="dn/v/oceans.mp4"type="video/mp4">
</video>
videojs使⽤⽅式就是以类似的⽅式开始的,不过由于我们借助videojs对视频进⾏⼀些控制或制定
var player =videojs('example_video_1',{
muted:true,
controls :true/false,
height:300,
width:300,
loop :true,
// 更多配置.....
});
常⽤事件
1. 播放 this.play()
2. 停⽌ – video没有stop⽅法,可以⽤pause 暂停获得同样的效果
3. 暂停 this.pause()
4. 销毁 this.dispose()
5. 监听 (‘click‘,fn)
6. 触发事件igger(‘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> // 如何使⽤事件监听?
<(‘ended‘,function(){
videojs.log(‘播放结束了!‘);
});
});
常⽤选项
autoplay : true/false 播放器准备好之后,是否⾃动播放 【默认false】
controls : true/false 是否拥有控制条 【默认true】,如果设为false ,那么只能通过api进⾏控制了。也就是说界⾯上不会出现任何控制按钮height: 视频容器的⾼度,字符串或数字 单位像素 ⽐如: height:300 or height:‘300px‘
width: 视频容器的宽度, 字符串或数字 单位像素
loop : true/false 视频播放结束后,是否循环播放
muted : true/false 是否静⾳
poster: 播放前显⽰的视频画⾯,播放开始之后⾃动移除。通常传⼊⼀个URL
preload:预加载
‘auto‘ ⾃动
’metadata‘ 元数据信息 ,⽐如视频长度,尺⼨等
‘none‘ 不预加载任何数据,直到⽤户开始播放才开始下载
children: Array | Object 可选⼦组件 从基础的Component组件继承⽽来的⼦组件,数组中的顺序将影响组件的创建顺序哦。
options选项
标准元素选项
这些选项中的每⼀个也可⽤作标准元素属性 ; 因此,可以使⽤设置指南中列出的所有三种⽅式定义它们。通常,未列出默认值,因为这是留给浏览器供应商的。
autoplay
类型: boolean
如果true/作为属性存在,则在播放器准备就绪时开始播放。
注意:从iOS 10开始,Apple autoplay在Safari中提供⽀持。有关详细信息,请参阅“新增功能。
controls
类型: boolean
确定播放器是否具有⽤户可以与之交互的控件。没有控件,启动视频播放的唯⼀⽅法是使⽤autoplay属性或通过Player API。
height
类型: string|number
设置视频播放器的显⽰⾼度(以像素为单位)。
loop
类型: boolean
使视频⼀结束就重新开始。
muted
类型: boolean
默认情况下会静⾳任何⾳频。
poster
类型: string
在视频开始播放之前显⽰的图像的URL。这通常是视频的框架或⾃定义标题屏幕。⼀旦⽤户点击“播放”,图像就会消失。
preload
类型: string
建议浏览器是否应在加载元素后⽴即开始下载视频数据。⽀持的值是:
‘auto’
⽴即开始加载视频(如果浏览器⽀持)。某些移动设备不会预加载视频,以保护⽤户的带宽/数据使⽤。这就是为什么这个价值被称为’汽车’,⽽不是更具决定性的东西’true’。
这往往是最常见和推荐的值,因为它允许浏览器选择最佳⾏为。
‘metadata’
仅加载视频的元数据,其中包括视频的持续时间和尺⼨等信息。有时,元数据将通过下载⼏帧视频来加载。
‘none’
不要预加载任何数据。浏览器将等待⽤户点击“播放”开始下载。
src
类型: string
要嵌⼊的视频源的源URL。
width
类型: string|number
设置视频播放器的显⽰宽度(以像素为单位)。
Video.js特定的选项
undefined除⾮另有说明,否则默认情况下每个选项
aspectRatio
类型: string
将播放器置于流体模式,并在计算播放器的动态⼤⼩时使⽤该值。该值应表⽰⽐率 - 由冒号(例如"16:9"或"4:3")分隔的两个数字。autoSetup
类型: boolean
阻⽌播放器为具有data-setup属性的媒体元素运⾏autoSetup 。
注意:必须在与videojs.options.autoSetup = false videojs源加载⽣效的同⼀时刻全局设置。
children
类型: Array|Object
此选项继承⾃基Component类。
fluid
类型: boolean
何时true,Video.js播放器将具有流畅的⼤⼩。换句话说,它将扩展以适应其容器。
此外,如果元素具有"vjs-fluid",则此选项⾃动设置为true。
inactivityTimeout
类型: number
javascript全局数组Video.js表⽰⽤户通过"vjs-user-active“和”vjs-user-inactive“类以及”useractive"事件与玩家进⾏交互。
在inactivityTimeout决定了不活动的许多毫秒声明⽤户闲置之前是必需的。值为0表⽰没有inactivityTimeout,⽤户永远不会被视为⾮活动状态。
language
键⼊:string,默认值:浏览器默认值或’en’
与播放器中的⼀种可⽤语⾔匹配的语⾔代码。这为播放器设置了初始语⾔,但始终可以更改。
在Video.js中了解有关语⾔的更多信息。
languages
类型: Object
⾃定义播放器中可⽤的语⾔。此对象的键将是语⾔代码,值将是具有英语键和翻译值的对象。
在Video.js中了解有关语⾔的更多信息
注意:通常,不需要此选项,最好将⾃定义语⾔传递给videojs.addLanguage()所有玩家!nativeControlsForTouch
类型: boolean
明确设置关联技术选项的默认值。
notSupportedMessage
类型: 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]
});
plugins
类型: 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(即vtt.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',
'controlBar'
]
});
该children选项还可以作为传递Object。在这种情况下,它⽤于提供options任何/所有孩⼦,包括禁⽤它们false:
版权声明:本站内容均来自互联网,仅供演示用,请勿用于商业和其他非法用途。如果侵犯了您的权益请与我们联系QQ:729038198,我们将在24小时内删除。
发表评论