在superplayer中,我们将一切与基本播放无关的应用功能归类到插件,例如实现一个播控的ui界面,可以使用一个“控制栏插件”,或者实现播放器字幕功能,则为“字幕插件”。
superplayer内置了一些常用插件。如果有需求,您也可以在superplayer上引入更多插件,下面我们以引入水印插件作为例子来说明如何给superplayer增加插件:
# 安装
导入水印插件的npm包:
npm i @tencent/thumbplayer-plugin-watermark
# 初始化
将水印插件名称添加到播放器配置的plugins
列表中:
import SuperPlayer from "@tencent/super-player";
import { WatermarkPlugin } from "@tencent/thumbplayer-plugin-watermark";
const player = new SuperPlayer({
container: '.container',
plugins: [WatermarkPlugin.pluginName],
});
// 从播放器实例上获取水印插件实例
const watermarkPlugin = player.plugins[WatermarkPlugin.pluginName];
// 调用水印插件方法
watermarkPlugin.watermarkThis('我的小水印');
# 配置
如果插件有提供自定义配置,您可以传入插件对应的配置,用于覆盖插件的默认配置。以水印插件为例,你可以从节点watermarkConfig
传入配置信息覆盖默认配置:
import SuperPlayer from '@tencent/super-player'
import { WatermarkPlugin } from '@tencent/thumbplayer-plugin-watermark';
const player = new SuperPlayer({
container: '#container',
// plugins中增加水印插件名
plugins: [ WatermarkPlugin.pluginName ],
// 添加水印的配置信息
watermarkConfig: {
// 指定水印默认文案
defaultText: 'super-player-demo',
}
});
# 内置插件
superplayer内置了一些常用插件,以下为内置插件列表(您可以通过播放器配置参数关掉内置插件):
插件名称 | 关闭参数 |
---|---|
控制栏 | disableCtrlbar |
错误页 | disableErrorPage |
加载动画 | disableLoading |
左下角的提示文案 | disableTips |
右键菜单 | disableCtxMenu |
视频信息面板 | |
封面图 | disablePoster |