本文为您提供了服务端 Node.js SDK 媒资播放模块相关的 API 调用示例。

前提条件

调用接口前，请先完成安装。

签发临时播放 Token

对于存储在视频点播中的音视频，您可以使用客户端播放器 SDK 通过临时播放 Token 自动获取播放地址进行播放。具体播放流程和临时播放 Token 说明，请见通过临时播放 Token 播放。为方便您的使用，视频点播服务端 SDK 对临时播放 Token 的签发进行了封装。您可调用生成方法通过 AK/SK 在本地签出临时播放 Token，不依赖外网。若希望同时生成多个临时播放 Token，可循环调用生成方法。

const getPlayAuthToken = async () => {
  try {
    const tokenExpireTime = 900; // 单位 s，默认 3600（1h）
    const query = {
      Vid: "your vid",
      FileType: "your file type", // 流文件类型。支持：加密视频流 evideo、加密音频流 eaudio、非加密视频流 video、普通音频音频流 audio。默认： video。
      Quality: "your quality", // 当 FileType 为 audio、eaudio 时起作用，音频音质参数。音频音质支持：medium：普通音质、higher：高音质、highest：音乐音质。默认：返回全部。
      Definition: "your definition", // 当 FileType 是 video、evideo 时起作用，视频流清晰度。视频流清晰度支持：240p、360p、480p、540p、720p、1080p、2k、4k。默认：返回全部。
      Format: "your format", // 封装格式。
      Codec: "your codec", // 编码格式。
      LogoType: "your logo type", // 水印贴片标签。
      Ssl: "your ssl", // 是否返回 https 播放地址。支持：1-是、0-否。默认：0-否。
      NeedThumbs: "your needThumbs", // 是否返回雪碧图。支持：1-是、0-否。默认：0-否。
      NeedBarrageMask: "your needBarrageMask", // 是否需要蒙版弹幕。支持：1-是、0-否。默认：0-否。
      UnionInfo: "your unionInfo", // 加密视频和加密音频时使用，播放端从浏览器/设备中取出能够标识访问/设备唯一性的信息。
      DrmExpireTimestamp: "your drmExpireTimestamp", // 加密视频和加密音频时使用，DRM 过期时间戳，单位：秒级 Unix 时间戳。说明: 需要配合播放器，在客户端使用。
      HDRDefinition: "your HDRDefinition", // 查询 HDR 清晰度。支持：240p、360p、480p、540p、720p、1080p、2k、4k。默认：不查询 HDR 清晰度。
      PlayScene: "your playScene", // 播放场景，指定获取对应场景的音视频流。当前支持：preview-试看。默认：不传参数。
    };
    const res = vodOpenapiService.GetPlayAuthToken(query, tokenExpireTime);
    // do your work
    // ...
  } catch (err) {
    console.log(err);
  }
};

获取播放地址

接口请求参数和返回参数详见 OpenAPI：获取播放地址。

const getPlayInfo = async () => {  
   try {    
      const options = {      
      Vid: "your Vid",
    };
    const res = await vodOpenapiService.GetPlayInfo(options);
    // do your work
    // ...
  } catch (err) {    
     console.log(err);
  }
};

签发私有加密 Token

私有加密 Token 用于 Web 播放器 SDK 播放私有加密视频，详情请见以下文档：

• 火山引擎私有加密方案
• 播放私有加密视频（新版）

私有加密 Token 可由 App/Web Server 持有的 AK/SK 在本地签出，不依赖外网。若希望同时生成多个私有加密 Token，您可以循环调用生成方法。

const getPrivateDrmAuthToken = () => {
  try {
    const tokenExpireTime = 900; // 单位 s，默认 3600（1h）
    // Web 播放器 SDK 内部携带 playAuthId、vid、unionInfo 向应用服务端请求获取私有加密 Token，详细示例代码和参数说明请见 [Web 端播放私有加密视频实现方式部分](https://www.volcengine.com/docs/4/68698#%E5%AE%9E%E7%8E%B0%E6%96%B9%E5%BC%8F-2)
    const query = {
      Vid: "your vid",
      DrmType: "your drm type", // 需指定 DrmType 为 webdevice
      PlayAuthIds: "your playAuthIds", // 播放许可id列表，以逗号分割
      UnionInfo: "your unionInfo", // 加密唯一信息
    };
    const res = vodOpenapiService.GetPrivateDrmAuthToken(
      query,
      tokenExpireTime
    );
    // do your work
    // ...
  } catch (err) {
    console.log(err);
  }
};