在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
上次更新: 5/23/2022, 8:25:08 PM