使用广泛,技术成熟,自定义程度高的H5播放器VideoJS

admin

文章最后更新时间:2024年05月30日

VideoJS

Videojs简介

Videojs是一款为 HTML5 量身打造的开源网络Web视频播放器。它支持 HTML5 视频和媒体源扩展,以及 YouTube 和 Vimeo 等其他播放技术(通过plugins)。它支持在台式机和移动设备上播放视频。该项目于 2010 年年中启动,目前是应用最广泛的开源Web视频播放器之一。VideoJS支持用户多种需求的自定义,如自定义皮肤与插件,让VideoJS与使用者的页面契合度更高,体验更好!

VideoJS项目仓库

VideoJS官方文档(中文)


VideoJS Demo

Demo HTML

<link rel="stylesheet" href="video-js.min.CSS">
<script type="text/JavaScript" src="video-js.min.js"></script>
...
<video id="player" webkit-playsinline="true" playsinline="true" class="video-js vjs-default-skin vjs-big-play-centered" poster="" width="100%" height="100%"></video>
...

Demo JS

var options = {
    controls: true,//控制栏
    autoplay: true,//自动播放
    language: 'en',//语言
    preload: 'auto',//预加载
    sources: [{src: '<?PHP echo $data['url']?>'}],//视频地址
    controlBar:{//控制栏组件
        children: [
            {name: 'playToggle'}, // 播放按钮
            {name: 'currentTimeDisplay'}, // 当前已播放时间
            {name: 'timeDivider'}, // 分隔符
            {name: 'durationDisplay'}, // 总时间
            {name: 'progressControl'}, // 播放进度条
            {name: 'volumePanel',inline: true,},// 音量控制 // 不使用水平方式
            {name: 'playbackRateMenuButton','playbackRates': [0.5, 1, 1.5, 2]},// 倍数播放
            {name: 'FullscreenToggle'} // 全屏
        ],
    },
};
var player = videojs('player', options, function oNPlayerReady() {});


VideoJS 参数

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 = 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()所有玩家!

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(即video.novtt.js)的“novtt”版本中。否则,vtt.js与Video.js捆绑在一起。


VideoJS API

addTextTrack()//向音频/视频添加新的文本轨道。
play//video.play();    播放视频
pause//video.pause();  暂停播放视频
load//video.load();   将全部属性回复默认值,视频恢复重新开始状态
canPlayType//var support = videoid.canPlayType('video/mp4');   判断浏览器是否支持当前类型的视频格式 返回值: 空字符串:不支持 Maybe:可能支持 Probably:完全支持
durationchange
ended
firstplay
fullscreenchange
loadedalldata
loadeddata
loadedmetadata
loadstart
pause 
play
progress
seeked
seeking
timeupdate
volumechange
waiting
resize inherited


VideoJS 监听

dispose
ended //结束
error //错误
exitFullscreen //退出全屏
pause //暂停
paused //检测是否暂停的状态
poster //静态图片
remainingTime //余下时间

duration//返回媒体的播放总时长,单位秒
loop//是否循环播放
muted//是否静音
paused//是否暂停
currentTime//当前播放时间(单位:秒)
volume//音量值(0~1)
networkState//返回当前网络状态
playbackRate//播放的倍速(加速、减速播放)(-2~2)
src//当前视频源的URL
ended//返回当前播放是否结束标志
error//返回当前播放的错误状态
initialTime//返回初始播放的位置
mediaGroup//当前音视频所属媒体组 (用来链接多个音视频标签)
played//当前播放部件已经播放的时间范围(TimeRanges对象)
preload//页面加载时是否同时加载音视频
readyState//返回当前的准备状态    
seekable//返回当前可跳转部件的时间范围(TimeRanges对象)
audioTracks//返回可用的音轨列表(MultipleTrackList对象)
autoplay//媒体加载后自动播放
buffered//返回缓冲部件的时间范围(TimeRanges对象)
controller//返回当前的媒体控制器(MediaController对象)
controls//显示播控控件
crossOrigin//CORS设置
currentSrc//返回当前媒体的URL
defaultMuted//缺省是否静音
defaultPlaybackRate//播控的缺省倍速
seeking//返回用户是否做了跳转操作
startOffsetTime//返回当前的时间偏移(Date对象)
textTracks//返回可用的文本轨迹(TextTrackList对象)
videoTracks//返回可用的视频轨迹(VideoTrackList对象)




文章版权声明:除非注明,否则均为十八码原创文章,转载或复制请以超链接形式并注明出处。

发表评论

快捷回复: 表情:
AddoilApplauseBadlaughBombCoffeeFabulousFacepalmFecesFrownHeyhaInsidiousKeepFightingNoProbPigHeadShockedSinistersmileSlapSocialSweatTolaughWatermelonWittyWowYeahYellowdog
评论列表 (暂无评论,476人围观)

还没有评论,来说两句吧...

目录[+]