当控制台创建的转码任务和工作流均无法满足您的使用场景时,可以按需调用SubmitJobs接口进行转码。根据您的业务逻辑配置所需的转码参数即可。

使用限制

  • API转码支持HLS-AES128标准加密,暂不支持阿里云私有加密。
  • API转码支持URL播放,不支持媒体ID播放。
  • 如您需要适应不同终端和网络环境播放,需自己关联多个格式的多个清晰度输出,实现多清晰度自动切换、多格式支持等逻辑。

转码准备

在进行转码任务之前,需要进行一些设置确保功能能够正常使用,如已设置请忽略。
  • 参考前置条件完成所需设置。
  • 媒体处理操作的媒体资源均存放在OSS的Bucket中,需要添加媒体Bucket才可以在任务、工作流中选择对应的Bucket作为输入和输出路径。详细操作请参见添加媒体Bucket
  • 开启管道。如果管道列表中没有您需要的管道类型,请先提交工单开通所需类型的管道。
  • 将需要处理的视频上传至OSS。详细操作请参见上传视频
  • (可选)如预置转码模板不能满足您的实际转码需要,您可以自定义转码模板。详细操作请参见新增自定义转码模板
  • (可选)如您有添加水印的需求,请先创建水印模板。详细操作请参见创建水印模板
  • (可选)如您需要在作业完成后接收消息通知,请先配置消息通知服务。详细操作请参见设置转码消息通知

操作步骤

  1. 将需要转码的媒资文件上传至OSS。您可以选择控制台上传、使用OSS相关上传工具上传等方法进行上传文件。
  2. 调用SubmitJobs接口提交转码作业。

    详细操作请参见提交转码作业,创建过程中必须按照以下步骤设置转码相关信息:

    说明 一个转码作业生成一个输出文件,允许批量提交作业。
    1. 选择所需管道。
      说明 倍速转码依赖管道,如需进行倍速转码请先开启专用管道。开启管道请参见开启管道
      场景 参数设置
      倍速转码 PipelineId参数设置为倍速转码管道ID。您可以通过媒体处理控制台或调用搜索管道接口获取倍速转码管道ID。
    2. 根据您的实际转码需要选择转码模板,如系统预置模板不能满足您的转码需求,您可以自定义转码模板。自定义转码模板请参见新增自定义转码模板。模板参数设置请参见下表:
      场景 参数设置
      窄带高清1.0转码 Output参数中的TemplateId根据您的实际转码需要设置为自定义窄带高清TM1.0模板ID或预置窄带高清TM模板ID。自定义窄带高清TM1.0模板ID在转码模板页面获取,预置窄带高清模板ID信息请参见窄带高清TM预置模板
      窄带高清2.0转码 Output参数中的TemplateId根据您的实际转码需要设置为自定义窄带高清TM2.0模板ID或预置窄带高清TM2.0模板ID。自定义窄带高清TM2.0模板ID在转码模板页面获取,预置窄带高清TM2.0模板ID信息请参见窄带高清TM预置模板
      说明 触发窄带高清TM2.0转码任务之前需要先开启窄带高清TM2.0管道,详细步骤请参见开启管道
      分辨率倍增转码 Output参数中的TemplateId设置为:
      • S00000003-400040(标清转高清)。
      • S00000003-400070(2K转4K)。
    3. (可选)选择所需水印模板。
    4. (可选)如有加密需求,可按需配置Output中的Encryption参数。
      说明 数据加密完成后只支持m3u8格式的输出。API加密支持base64和KMS加密方式。详情参见Encryption参数详情
  3. 接收到消息通知,调用查询转码作业接口查询作业执行情况,获取输出文件URL。
  4. (可选)如您需要查看管道中的所有转码作业,可以调用列出转码作业接口,通过作业状态,创建时间区间,列出转码作业。