媒资管理

本文为您提供了服务端 Node.js SDK 的媒资管理模块相关的 API 调用示例。主要包含：查询媒资信息、修改媒资信息、修改媒资发布状态、获取音视频列表、获取字幕文件等。

初始化

设置 AK/SK 和地域，具体可参考初始化。

查询媒资信息

接口请求参数和返回参数详见 OpenAPI：查询媒资信息。

const getMediaInfos = asyn () => {
  try {
    const options = { Vids: "your vids"};
    const res = await vodOpenapiService.GetMediaInfos(options);
    //do your work
    // ...
  } catch (err) {
    console.log(err);
  }
};

修改媒资信息

接口请求参数和返回参数详见 OpenAPI：修改媒资信息。

const updateMediaInfo = async () => {
  try {
    const options = {
      Vid: "your vid",
      Tags: "your new tags",
      Title: "your new title",
      PosterUri: "your new posterUri",
      Description: "your new description",
    };
    const res = await vodOpenapiService.UpdateMediaInfo(options);
    // do your work
    // ...
  } catch (err) {
    console.log(err);
  }
};

修改媒资发布状态

接口请求参数和返回参数详见 OpenAPI：修改媒资发布状态。

const updateMediaPublishStatus = asyn () => {
  try {
   const options = {
     Vid: "your vid",
     Status: "your status", // 视频状态 发布：Published 未发布：Unpublished
   };
   const res = await vodOpenapiService.UpdateMediaPublishStatus(options);
   // do your work
   // ...
  } catch (err) {
    console.log(err);
  }
};

获取封面候选结果

接口请求参数和返回参数详见 OpenAPI：获取封面候选结果。

const getRecommendedPoster = async () => {
  try {
    const options = { Vids: "your vids" };
    const res = await vodOpenapiService.GetRecommendedPoster(options);
    // do your work
    // ...
  } catch (err) {
    console.log(err);
  }
};

批量删除完整媒资

接口请求参数和返回参数详见 OpenAPI：批量删除完整媒资。

const deleteMedia = async () => {
  try {
    const options = { 
      Vids: "your vids", // Vid 列表，多个 Vid 以","隔开，单次最多支持 20个。
      CallbackArgs: "your callbackArgs", // 回调参数，不超过 512字节
    };
    const res = await vodOpenapiService.DeleteMedia(options);
    // do your work
    // ...
  } catch (err) {
    console.log(err);
  }
};

删除媒体文件

接口请求参数和返回参数详见 OpenAPI：删除媒体文件。

const deleteTranscodes = async () => {
  try {
    const options = { 
     Vid: "your vid", // Vid，只支持单个 Vid
     FileIds: "your fileIds", // 媒体文件 ID 列表，点播中定义字段为 FileId。多个 FileId 以","隔开，最多 20个。若未传入或传入长度为 0，则认为删除 Vid 下所有媒体文件。注意：FileId 里不能包含源视频对应的 FileId，如果要删除包含源视频在内的所有视频，请调用批量删除媒资接口。
     CallbackArgs: "your callbackArgs", // 回调参数，不超过 512字节
    };
    const res = await vodOpenapiService.DeleteTranscodes(options);
    // do your work
    // ...
  } catch (err) {
    console.log(err);
  }
};

获取音视频列表

接口请求参数和返回参数详见 OpenAPI：获取音视频列表。

const getMediaList = async () => {
  try {
   const options = {
      SpaceName: "your space name", // 空间名称
      Vid: "your vid", // 视频 ID
      Status: "your status", // 视频状态。不传默认全部。Published：发布，Unpublished：未发布，多个状态用","隔开，例如：“Published,Unpublished”。
      Order: "your order", // 按照创建时间排序方式。默认为 Desc。取值：Asc：升序，Desc：降序。
      StartTime: "2021-01-01T00:00:00Z", // 创建时间的开始时间。查询结果大于等于 StartTime。格式按照 ISO 8601 标准表示，使用 UTC+0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。例如：2021-03-18T00:00:00Z，默认 1999-01-01T00:00:00Z。
      EndTime: "2021-04-01T00:00:00Z", // 创建时间的结束时间。需要大于 StartTime。默认 now。格式按照 ISO 8601 标准表示，使用 UTC+0 时间，格式为 yyyy-MM-ddTHH:mm:ssZ。
      Offset: "5", // 数据偏移量。默认为 0。最大为 10000。
      Pagesize: "100", // 列表页大小。每页返回记录条数。默认为 10，最大值为 100。
    };
    const res = await vodOpenapiService.GetMediaList(options);
    // do your work
    // ...
  } catch (err) {
    console.log(err);
  }
};

获取字幕文件

接口请求参数和返回参数详见 OpenAPI：获取字幕文件。

const getSubtitleInfoList = async () => {
  try {
    const options = {
      Vid: "your search vid", // 视频ID
      FileIds: "your search fileIds", // 转码视频 ID 列表，不传默认返回Vid下所有字幕。多个 FileId以","隔开，最多 20个。说明：传参中的重复值或空值会默认过滤。
      Languages: "your search languages", // 字幕语言列表。cmn-Hans-CN（简体中文）、eng-US（英语）。
      LanguageIds: "your search languageIds", // 语言标识码 ID 列表。1（简体中文）、2（英语）。
      SubtitleIds: "your search subtitleIds", // 字幕 ID 列表。多个以","分隔，最多 10个。
      Formats: "your search format", // 字幕格式列表。多个 Formats 以","分隔，最多 10个。说明：目前仅支持 WebVtt。
      Status: "your search status", // 字幕状态列表。Published（发布）、Unpublished（未发布）。
      Title: "your search title", // 标题。说明：目前仅支持精确匹配标题内容。
      Tag: "your search tag", // 标签。说明：目前仅支持精确匹配标签内容。
      Offset: "your search offset", // 偏移量，默认 0。说明：此参数在指定 FileIds 获取字幕文件时生效。
      PageSize: "your search page size", // 分页大小，默认 10，最大可指定 20。说明：此参数在指定 FileIds 获取字幕文件时生效。
      Ssl: "your search ssl type", // 字幕 Url 是否为 HTTPS 地址。默认否, 1（是，返回 HTTPS）；0（HTTP） 。
    };
    const res = await vodOpenapiService.GetSubtitleInfoList(options);
    // do your work
    // ...
  } catch (err) {
    console.log(err);
  }
};

修改字幕发布状态

接口请求参数和返回参数详见 OpenAPI：修改字幕发布状态。

const updateSubtitleStatus = async () => {
  try {
    const options = {
      Vid: "your update vid", // 视频 ID
      FileIds: "your update fileIds", // 转码视频 ID 列表，不传默认返回 Vid 下所有字幕。多个 FileId 以","隔开，最多 20个。说明：传参中的重复值或空值会默认过滤。
      Languages: "your update languages", // 字幕语言列表，多个以","隔开。cmn-Hans-CN（简体中文）、eng-US（英语）。
      Formats: "your update format", // 字幕格式列表，说明：当前只支持 WebVTT。
      Status: "your update status", // 字幕状态。Published（发布）、Unpublished（未发布）。
    };
    const res = await vodOpenapiService.UpdateSubtitleStatus(options);
    // do your work
    // ...
  } catch (err) {
    console.log(err);
  }
};

修改字幕信息

接口请求参数和返回参数详见 OpenAPI：获取字幕信息。

const updateSubtitleInfo = async () => {
  try {
    const options = {
      Vid: "your update vid", // 视频ID
      FileId: "your update fileId", // 转码视频id列表
      Language: "your update language", // 字幕语言列表，多个以","隔开。cmn-Hans-CN（简体中文）、eng-US（英语）。
      Format: "your update format", // 字幕格式列表, 说明：当前只支持 WebVTT。
      Title: "your update title", // 字幕标题，最长 128字符。不传为不修改，传空为置空。
      Tag: "your update tag", // 字幕标签，最长 128字符。不传为不修改，传空为置空。
    };
    const res = await vodOpenapiService.UpdateSubtitleInfo(options);
    // do your work
    // ...
  } catch (err) {
    console.log(err);
  }
};