video.js是一个优秀的视频播放器库,不过官网的示例中,是作为全局变量videojs
引入的。如果我们的项目使用ES6风格的模块,用webpack来做打包的话,就需要做一些额外的工作。本文介绍我在使用的时候遇到的一些“坑”。
基本使用方法
直接从npm安装video.js,然后就可以在代码中使用video.js了。
npm install video.js --save
import videojs from 'video.js';
videojs(document.getElementById('foo'));
引入默认皮肤样式
但是这样使用并没有引入video.js的皮肤样式文件,播放器是没有界面的。
所以还需要引入CSS文件:
import 'video.js/dist/video-js.css';
另外需要注意的是,因为CSS中使用了图标字体,还需要用webpack的file-loader
处理字体文件。在webpack配置文件中添加这样的loader配置:
{
test: /\.(ttf|eot|svg|woff(2))(\?[a-z0-9]+)?$/,
loader: 'file',
}
引入Flash播放器的SWF文件
对于一些HTML5播放器播放不了的格式,video.js回调用Flash播放器去播放器,这样就需要引入一个SWF文件。方法还是用file-loader
。在之前的配置中加上swf
扩展名:
{
test: /\.(swf|ttf|eot|svg|woff(2))(\?[a-z0-9]+)?$/,
loader: 'file',
}
然后在代码中配置SWF文件的路径:
import SWF_PATH from 'video.js/dist/video-js.swf';
videojs.options.flash.swf = SWF_PATH;
引入vtt.js
如果使用Flash播放器,video.js还会异步请求一个vtt.js
文件。这个是用来处理WebVTT文件的。
这个JS文件的路径的配置方法跟上面的SWF文件的配置方法是类似的。但是,webpack默认会对JS文件打包,而我们需要的是通过file-loader
来引入这个JS文件,从而获得其形对路径,所以要在import语句中指定具体的loader:
import VTTJS_PATH from 'file!videojs-vtt.js/dist/vtt.min.js';
videojs.options['vtt.js'] = VTTJS_PATH;
引入其他语言翻译
video.js包含了很多种语言的本地化,但是没有包含在库中,需要我们自己加载:
import 'video.js/dist/lang/zh-CN';
这样加载的问题是,本地化JS代码中使用了videojs
这个全局变量,但是webpack并没有将其暴露,所以运行会报错。
解决这个问题有两种方法,在webpack的文档有所提及。
第一种方法是使用imports-loader
,在import一个JS的时候,注入一个全局变量:
import 'imports?videojs=video.js!video.js/dist/lang/zh-CN'
这样的语句,就是告诉webpack,将videojs
这个全局变量指向video.js
这个模块。这样就不会报错。
第二种方法是使用ProvidePlugin
,直接把全局变量暴露出来。
在webpack的配置文件中,增加这样的plugin配置:
new webpack.ProvidePlugin({
videojs: 'video.js',
}),
这样就表示把video.js
模块暴露为全局变量videojs
。
使用插件
video.js有很多插件,他们一般也会使用videojs
这个全局变量。因此如果直接引入也会报错。解决方法跟上一部分“引入其他语言翻译”的方法一样,在此不赘述。