为提高媒体处理的易用性，视频点播提供工作流机制。本文为您介绍如何使用工作流。

什么是工作流

工作流本质上是一个包含多个媒体处理子任务的“父任务”。触发一个工作流等同于触发工作流中包含的所有子任务。您可提前构建自定义处理流程，并将指定音视频文件按照特定流程进行处理，避免重复、繁琐地调用接口。

系统内置工作流

视频点播控制台中内置的四个工作流如下表所示。

注意事项

• 画质增强任务与自定义转码组同时只能存在一个。
• 当视频转码任务、音频转码任务和自定义转码组的模板类型为 DASH 时，暂不支持自定义文件路径。

创建工作流

当前仅支持通过视频点播控制台创建工作流，步骤如下：

1. 登录视频点播控制台，进入指定空间。

2. 单击左侧导航栏媒体处理设置 > 工作流。

3. 单击创建工作流。

4. 在创建工作流页面，根据页面提示完成参数配置。

   1. 填写工作流名称。长度不超过 64 个字符。建议使用可以标识模板内容的工作流名称。

   2. （可选）填写工作流描述。长度不超过 64 个字符。

   3. 根据您的自身业务需求，勾选工作流任务。下图示例中勾选了视频转码、画质增强、截图、添加字幕和自动发布任务。勾选后，任务的具体配置项会自动出现在页面下方。
      

   4. 依次配置任务。对于部分任务，您可通过单击添加任务按钮，添加多条任务。各任务的配置项介绍如下表所示。

      任务名称	是否支持添加多条任务	说明
      视频转码任务	是	支持关联视频转码模板、设置转码条件、添加水印贴片、添加硬字幕和自定文件路径。详见配置视频转码任务。
      极智超清任务	是	支持关联极智超清模板、设置转码条件、添加水印贴片、添加硬字幕和自定文件路径。详见配置极智超清任务。
      音频转码任务	是	支持关联音频转码模板和自定义文件路径。详见配置音频转码任务。
      自定义转码组	否	支持关联转码组模板和自定义文件路径。详见配置自定义转码组。
      截图任务	是	支持关联截图模板、设置片源视频时长的执行条件和自定义文件路径。详见配置截图任务。
      画质增强任务	否	支持关联画质增强模板、设置片源分辨率和画质检测-VQScore 的执行条件。详见配置画质增强任务。
      检测修复任务	否	支持关联检测修复模板。详见配置检测修复任务。
      多媒体 AI 任务	否	支持关联多媒体 AI 模板。如果模板有精彩剪辑的配置，支持选择剪辑源视频。详见配置多媒体 AI 任务。
      智能字幕任务	否	支持关联智能字幕模板和设置自动发布字幕。开启后，字幕生成后自动发布。详见配置智能字幕任务。
      自动发布	否	支持设置以下自动发布的触发条件： 默认发布（不依赖转码结果）：经过本工作流处理的视频将被自动发布。 全部流转码成功：音视频文件全部处理完成后将自动发布。 任一流转码成功：音视频文件部分处理完成后将自动发布。
      暗水印提取	否	支持关联暗水印提取模板。

5. 单击保存。您可在工作流列表中查看您刚创建的工作流。

配置视频转码任务

1. 媒体处理模板：在下拉列表中选择视频转码模板。您可选择系统内置的视频转码模板，或根据业务需求创建视频转码模板。

2. 设置转码条件：默认关闭，任务会强制执行。设置转码条件后，片源满足指定条件时，任务才会执行。您可设置以下两类转码条件：

   • 片源分辨率：您需设置片源的短边范围。

   • 片源码率：您需设置片源的码率范围。分辨率不同，自定义码率的取值范围也不同，详见下表。

     片源分辨率	片源码率的自定义范围
     240p、360p	[500,-1)
     480p	[800,-1)
     540p	[1200,-1)
     720p	[1500,-1)
     1080p	[2500,-1)
     2k	[3000,-1)
     4k	[5000,-1)

3. 添加水印贴片：默认关闭。开启后，您需在下拉列表中选择水印贴片模板。如果无任何可选模板，需创建水印贴片模板。具体操作请见水印贴片模板。

4. 添加硬字幕：默认关闭。开启后，系统会将指定语言的字幕文件内嵌入视频画面中。支持中文、英语、日语、韩语、泰语、马来语、印尼语、印地语、越南语、西班牙语、德语、繁体中文。

5. 自定义文件路径：默认关闭，系统会随机生成媒体处理输出文件路径。开启后，您需填写自定义文件路径。支持输入变量、自定义字符串。变量引用格式为 {{变量名}}，如 {{fileName}}。详情请见自定义媒体处理输出文件路径。

   说明

   • 转码输出文件路径的后缀建议与所选模板中设置的格式保持一致。
   • 封装格式为 HLS 的文件后缀需设置为 .m3u8，否则会播放失败。

6. 倍速转码：默认关闭。开启后，针对中长视频场景，系统会通过分片转码提升视频转码速度。

   注意

   • 倍速转码为白名单功能，如有需要，请提交工单联系技术支持开通。
   • 倍速转码能力单独收费，详见收费标准。
   • 倍速功能与字幕功能不可同时开启。

配置极智超清任务

1. 在下拉列表中选择极智超清模板。如果无可选模板，您需创建极智超清模板。
2. 其他配置与视频转码任务相同，请参见配置视频转码任务。

配置音频转码任务

1. 媒体处理模板：在下拉列表中选择音频转码模板。您可选择系统内置的音频转码模板，或根据业务需求创建音频转码模板。
2. 自定义文件路径：默认关闭，系统会随机生成转码输出的文件路径。开启后，您需填写自定义文件路径。支持输入变量、自定义字符串。变量引用格式为 {{变量名}}，如 {{fileName}}。详情请见自定义媒体处理输出文件路径。

   说明

   • 转码输出文件路径的后缀建议与所选模板中设置的格式保持一致。
   • 封装格式为 HLS 的文件后缀需设置为 .m3u8，否则会播放失败。

配置自定义转码组

1. 媒体处理模板：在下拉列表中选择自定义转码组。如果无可选模板，您需创建自定义转码组。
2. 自定义文件路径：默认关闭，系统会随机生成转码输出的文件路径。开启后，您需填写自定义文件路径。支持输入变量、自定义字符串。变量引用格式为 {{变量名}}，如 {{fileName}}。详情请见自定义媒体处理输出文件路径。

   说明

   • 转码输出文件路径的后缀建议与所选模板中设置的格式保持一致。
   • 封装格式为 HLS 的文件后缀需设置为 .m3u8，否则会播放失败。

配置截图任务

1. 媒体处理模板：在下拉列表中选择截图模板。您可选择系统内置的截图模板，或根据业务需求创建截图模板。
2. 设置执行条件：默认关闭。设置执行条件后，片源满足指定条件时，任务才会执行。支持设置片源视频时长，设置的规则如下所示。
   • 条件：小于、介于、大于等于。
   • 分钟：大于等于 0 分钟。
   • 秒：大于等于 0 秒。
3. 自定义文件路径：默认关闭，系统会随机生成截图文件路径。开启后，您需填写自定义文件路径。支持输入变量、自定义字符串。变量引用格式为 {{变量名}}，如 {{fileName}}。详情请见自定义媒体处理输出文件路径。

   说明

   • 如果您选择了采样截图、雪碧图，请使用 {{count}} 变量来区分多张截图。
   • 不支持以 / 和 \ 开头，不支持连续 /、空格、+ 等特殊字符。

配置画质增强任务

1. 媒体处理模板：在下拉列表中选择画质增强模板。如果无可选模板，您需创建画质增强模板。
2. 执行条件：默认关闭。开启后，支持配置以下两种执行条件：
   • 片源分辨率：必选，画质增强支持原视频分辨率不超过 1080P，设置片源短边范围，最大支持 1081 px。
   • 画质检测-VQScore：设置片源 VQScore 范围。VQScore 的范围：[0,100]。

     注意

     执行条件如设为 VQScore 画质检测，您需要同时添加检测修复任务，关联的检查修复模板中需包含画质检测-VQScore。

3. 结果独立存储：默认关闭。开启后，当工作流中包含转码任务时，会先进行画质增强，然后对画质增强结果进行转码。

   说明

   • 结果独立存储关闭时，请至少选择一个视频转码、音频转码或极智超清任务。
   • 如果您不需要单独存储画质增强后文件，可以选择关闭。
4. 自定义文件路径：默认关闭，系统会随机生成转码输出的文件路径。开启后，您需填写自定义文件路径。支持输入变量、自定义字符串。变量引用格式为 {{变量名}}，如 {{fileName}}。详情请见自定义媒体处理输出文件路径。

   说明

   • 转码输出文件路径的后缀建议与所选模板中设置的格式保持一致。
   • 封装格式为 HLS 的文件后缀需设置为 .m3u8，否则会播放失败。

配置检测修复任务

在下拉列表中选择检测修复模板。您可选择系统内置的检测修复模板，或根据业务需求创建检测修复模板。

配置多媒体 AI 任务

1. 媒体处理模板：在下拉列表中选择多媒体 AI 模板。您可选择系统内置的多媒体 AI 模板，或根据业务需求创建多媒体 AI 模板。
2. 如果选择的模板中有精彩剪辑配置，支持配置剪辑顺序，即剪辑源视频。

配置智能字幕任务

1. 媒体处理模板：在下拉列表中选择智能字幕模板。您可选择系统内置的智能字幕模板，或根据业务需求创建智能字幕模板。
2. 自动发布字幕：默认关闭。开启后，本工作流智能字幕任务生成的字幕都将被自动发布。用户只能看到已发布的字幕。
3. 自定义文件路径：默认关闭，系统会随机生成字幕文件路径。开启后，您需填写自定义文件路径。支持输入变量、自定义字符串。变量引用格式为 {{变量名}}，如 {{fileName}}。详情请见自定义媒体处理输出文件路径。

触发工作流

视频点播支持通过以下方式触发工作流。

设置空间的默认工作流

参考以下步骤设置空间的默认工作流。所有上传至该空间的音视频都会由默认工作流处理。

1. 登录视频点播控制台，进入指定空间。
2. 单击左侧导航栏系统设置 > 上传存储设置。
3. 单击上传自动触发设置区域的修改配置按钮，开启自动触发默认工作流。
4. 单击默认配置区域的修改配置按钮，在默认工作流下拉列表中选择您想要触发的工作流。

上传时指定工作流 ID

视频点播支持通过控制台、OpenAPI/服务端 SDK 方式在上传音视频时指定工作流，具体说明如下：

• 控制台方式：在视频上传页面选择您想要触发的工作流，如下图所示：
  
• OpenAPI/服务端 SDK 方式：
  • 调用 CommitUploadInfo 接口时通过上传功能函数 WorkflowInput 传入工作流 ID 指定您想要触发的工作流。
  • 调用 UploadMediaByUrl 接口时通过 Templates 参数传入工作流 ID 指定您想要触发的工作流。

上传后手动触发工作流

视频点播支持通过控制台、OpenAPI 和服务端 SDK 方式针对已上传的音视频手动触发工作流，具体说明如下：

• 控制台方式：在视频管理页面，勾选您想要处理的视频后，点击操作栏的处理按钮。如下图所示：
  
• OpenAPI/服务端 SDK 方式：调用 StartWorkflow 接口传入工作流 ID 触发工作流。

获取工作流执行状态和结果

触发工作流后，您可以通过控制台、OpenAPI/服务端 SDK 和事件通知方式获取工作流执行结果，具体说明如下：

• 控制台方式：在任务管理 > 工作流任务页面，查看某一工作流任务的状态。可单击查看详情按钮，查看该工作流包含的各个子任务的状态和产物。更多信息，请见查看媒体处理任务。
  
• OpenAPI/服务端 SDK 方式：
  • 调用 GetWorkflowExecution 接口获取工作流执行状态。
  • 调用 GetWorkflowExecutionResult 接口获取工作流执行结果。
• 事件通知：配置工作流执行完成事件通知。配置方法详见回调设置。