播放 HLS 标准加密视频（旧版）--视频点播-火山引擎

文档中心

导航

视频点播

播放 HLS 标准加密视频（旧版）

最近更新时间：2025.09.10 21:24:40首次发布时间：2025.09.08 16:04:03

VePlayer 可播放由视频点播媒体处理服务生成的 HLS 标准加密视频，以满足用户对版权视频安全播放的需求。

兼容性说明

系统/浏览器	说明
PC Chrome	支持 34 以上版本。
PC Edge	部分支持 Windows 10 及以上。
移动端 iOS	部分支持 iOS 10 及以上系统。注意不支持 iOS 11.2 - 11.4 的系统。
移动端 Android	部分支持 Android 5 及以上系统。注意不支持播放器被劫持环境，如 UC 浏览器、QQ 浏览器以及部分手机厂家自带的浏览器（例如，VIVO）。

已知限制

VePlayer 播放 HLS 标准加密视频存在以下已知限制：

对于移动端 Android 系统，不支持在 UC 浏览器、QQ 浏览器以及部分手机厂商（如 VIVO）自带浏览器等播放器被劫持环境中使用。
对于移动端 iOS 系统，不支持 11.2 - 11.4 的版本（国内影响范围 0.65% 以内）。

对于不支持的浏览器环境，建议您进行风险评估，减少在这类环境下加密视频内容的投放或引导用户跳转至 App 端播放。

前提条件

通过视频点播媒体处理服务转码输出 HLS 标准加密视频。详见 HLS 标准加密。
应用服务端生成并下发 HLS 标准加密 Token 给应用客户端用于解密。视频点播服务端 SDK 提供接口用于签发 HLS 标准加密 Token，详见以下文档：

实现方式

VePlayer 支持通过 Vid 和 DirectUrl 两种模式播放 HLS 标准加密视频，具体说明如下：

Vid 模式

DirectUrl 模式

通过 Vid 模式播放时，您需要设置 getVideoByToken 参数传入 playAuthToken 和 keyToken。详细参数介绍请见 IPlayAuthTokenConfig。示例代码如下：

const playerSdk = new VePlayer({
  id: 'mse',
  width: 800,
  height: 500,
  getVideoByToken: {
    playAuthToken: 'playAuthToken', // 从应用服务端获取的临时播放 Token
    keyToken: 'keyToken' // 从应用服务端获取的 HLS 标准加密 Token
  }
});

通过 DirectUrl 模式播放时，除了视频地址 url，还需设置 EncryptHlsPlugin 参数传入 keyToken。详细参数介绍请见 IEncryptHlsPluginConfig。示例代码如下：

const playerSdk = new VePlayer({
  id: 'mse',
  width: 800,
  height: 500,
  url: 'hls的加密视频地址',
  EncryptHlsPlugin: {
    keyToken: '解密用的keyToken', // 从应用服务端获取的 HLS 标准加密 Token
  }
})

切换视频

如想在不销毁播放器的情况下更换视频源，可调用播放器实例的 playNext 方法。Vid 和 DirectUrl 两种模式均支持通过这种方式切换视频。

Vid 模式

DirectUrl 模式

Vid 模式下切换视频的示例代码如下：

playerSdk.playNext({
  getVideoByToken: {
    playAuthToken: 'new playAuthToken', // 新的 playAuthToken
    keyToken: 'new keyToken' // 新的 keyToken
  }
});

DirectUrl 模式下切换视频的示例代码如下：

playerSdk.playNext({
   url: 'new url', // 新的 HLS 加密视频播放地址
  EncryptHlsPlugin: {
    keyToken: 'new keyToken' // 新的 keyToken
  }
});