Video.js 视频播放器集成与 API 使用指南

作者:拾光时间:2026-10-23 15:09:48浏览:315

本文详细介绍 Video.js 插件的集成方法与核心 API 使用。涵盖从 CDN 引入、Flash 兼容配置到动态元素初始化的完整流程。重点解析播放器实例化后的常用方法,包括播放控制、进度与音量调节、尺寸调整及全屏功能,并列举关键事件监听与模态窗口集成方案,帮助开发者高效实现 Web 端视频播放功能。

Video.js 集成与初始化

Video.js 快速入门指南

开发者可选择下载 Video.js 源码部署至自有服务器,或直接调用免费的 CDN 托管资源。

在网页中引入 video-js.css 样式表及 video.js 脚本文件。


<link href="video-js.css" rel="external nofollow" rel="stylesheet" type="text/css">
<script src="video.js"></script>

若选择使用免费 CDN 托管版本,需正确引用相关资源。


<link href="http://vjs.zencdn.net/4.12/video-js.css" rel="external nofollow" rel="stylesheet">
<script src="http://vjs.zencdn.net/4.12/video.js"></script>

配置 Flash 路径,以便在不支持 HTML5 的浏览器中通过 Flash 插件播放视频文件。


<script>
  videojs.options.flash.swf = "video-js.swf";
</script>

引入 video 标签以实现视频播放功能。


<video id="example_video_1" class="video-js vjs-default-skin" controls preload="none" width="640" height="264"
   poster="http://video-js.zencoder.com/oceans-clip.png"
   data-setup="{}">
  <source src="https://www.jb51.net/视频地址格式1.mp4" type='video/mp4' />
  <source src="https://www.jb51.net/视频地址格式2.webm" type='video/webm' />
  <source src="https://www.jb51.net/视频地址格式3.ogv" type='video/ogg' />
  <track kind="captions" src="demo.captions.vtt" srclang="en" label="English"></track><!-- Tracks need an ending tag thanks to IE9 -->
  <track kind="subtitles" src="demo.captions.vtt" srclang="en" label="English"></track><!-- Tracks need an ending tag thanks to IE9 -->
</video>

如需启用自动播放,请将相关代码添加至 video 标签之后。

实现播放按钮居中显示。

默认情况下,大型播放按钮位于左上角以避免遮挡视频内容。若需将其居中,可为 video 标签添加 vjs-big-play-centered 样式类。若对播放按钮外观不满意,可通过重写 .video-js .vjs-big-play-button 的 CSS 样式进行调整。


<video id="xttblog" class="video-js vjs-default-skin vjs-big-play-centered"
 controls preload="auto" width="640" height="264"
 poster="http://www.xttblog.com/test/oceans-clip.png"
 data-setup='{"example_option":true}'>
</video>

为动态加载的 HTML 元素配置 Video.js。

当 Web 页面或应用通过 AJAX 或 appendChild 动态加载 video 标签时,该元素在页面初始加载阶段并不存在。此时,应手动初始化播放器,而非依赖 data-setup 属性。操作时,首先从 video 标签中移除 data-setup 属性,以避免播放器初始化时的冲突。


videojs("xttblog", {}, function(){
 // Player (this) is initialized and ready.
});

videojs 方法的第一个参数为 video 标签的 ID,请替换为您实际的 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 类型。

播放器 API 常用方法

Video.js 的详细使用方法如下


var videoObj = videojs(“videoId”);

ready:


myPlayer.ready(function(){
  //在回调函数中,this代表当前播放器,
  //可以调用方法,也可以绑定事件。
})

播放:


myPlayer.play();

暂停:


myPlayer.pause();

获取播放进度:


var whereYouAt = myPlayer.currentTime();

设置播放进度:


myPlayer.currentTime(120);

视频持续时间:仅在视频加载完成后才能获取,且在 Flash 模式下无效。


var howLongIsThis = myPlayer.duration();

缓冲状态:返回已下载的数据量。


var whatHasBeenBuffered = myPlayer.buffered();

缓冲百分比。


var howMuchIsDownloaded = myPlayer.bufferedPercent();

音量大小(取值范围 0-1)。


var howLoudIsIt = myPlayer.volume();

设置音量大小。


myPlayer.volume(0.5);

获取视频宽度。


var howWideIsIt = myPlayer.width();

设置宽度:


myPlayer.width(640);

获取高度。


var howTallIsIt = myPlayer.height();

设置高度:


myPlayer.height(480);

一步到位设置大小:


myPlayer.size(640,480);

进入全屏。


myPlayer.enterFullScreen();

退出全屏。


myPlayer.enterFullScreen();

事件监听与高级应用

添加事件监听。


durationchange
ended //播放结束
firstplay
fullscreenchange
loadedalldata
loadeddata
loadedmetadata
loadstart
pause //暂停
play //播放
progress
seeked
seeking
timeupdate
volumechange
waiting
resize inherited

var myFunc = function(){
  // Do something when the event is fired
};

事件绑定。


myPlayer.on("ended", function(){
  console.log("end", this.currentTime());
});

myPlayer.on("pause", function(){
  console.log("pause")
});

删除事件监听。


myPlayer.removeEvent(“eventName”, myFunc);

页面包含多个视频时,点击后可触发 Bootstrap 模态窗口并弹出视频。

html:


<a videohref="//www.jb51.net/xxx.mp4" class="video_link"><img src="../images/xxx.jpg"/></a>

JS:


$(".video_link").click(function() {
  var myPlayer = videojs('my-video');
  var videoUrl = $(this).attr("videohref");
  videojs("my-video", {}, function() {
    window.myPlayer = this;
    $("#mymoda .video-con #my-video source").attr("src", videoUrl);
    myPlayer.src(videoUrl);
    myPlayer.load(videoUrl);
    myPlayer.play();
  });
  $(".click-modal").click();
});
// 模态窗消失时,关闭视频  
$('#mymoda').on('hidden.bs.modal', function() {
  myPlayer.pause();

更多关于 Js 视频播放器插件的文章请点击下面的相关链接

作者最新文章