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

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

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

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

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. 添加硬字幕：默认关闭。开启后，系统会将文件内嵌入视频画面中。支持语言请见语言。开启此选项，以便在转码过程中将指定语言的字幕嵌入到视频帧中。

   • 字幕语言：选择您想要嵌入到视频中的字幕文件的语言。
   • 字幕样式：选择一个预先配置的硬字幕样式模板，来定义字幕的字体、大小、颜色和位置。如需创建或管理模板，请参见字幕模板。

   说明

   使用此功能前，您必须确保所选语言的字幕文件已经存在，并已与源视频关联。该字幕文件可以通过智能字幕任务生成，或手动上传。详情请参见智能生成字幕文件 和上传字幕文件并绑定 Vid 。

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

   说明

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

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

   注意

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

配置极智超清任务 #

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

配置自适应码流任务 #

1. 媒体处理模板：在下拉列表中选择音频转码模板。您需要根据业务需求创建自适应码流模板。
2. 添加水印贴片：默认关闭。开启后，您需在下拉列表中选择水印贴片模板。如果无任何可选模板，需创建水印贴片模板。具体操作请见水印贴片模板。
3. 添加硬字幕：默认关闭。开启后，系统会将文件内嵌入视频画面中。支持语言请见语言。开启此选项，以便在转码过程中将指定语言的字幕嵌入到视频帧中。
   • 字幕语言：选择您想要嵌入到视频中的字幕文件的语言。
   • 字幕样式：选择一个预先配置的硬字幕样式模板，来定义字幕的字体、大小、颜色和位置。如需创建或管理模板，请参见字幕模板。

   说明

   使用此功能前，您必须确保所选语言的字幕文件已经存在，并已与源视频关联。该字幕文件可以通过智能字幕任务生成，或手动上传。详情请参见智能生成字幕文件 和上传字幕文件并绑定 Vid 。

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

   说明

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

配置音频转码任务 #

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 接口获取工作流执行结果。
• 事件通知：配置工作流执行完成事件通知。如何配置详见回调配置方式。

媒体处理输出文件的路径由系统默认生成。但是如果您需要根据自身业务需求管理片源和媒体处理后文件的存储路径，则可自定义媒体处理输出文件路径。

配置方式 #

在工作流中添加视频转码、极智超清、音频转码、自定义转码组或截图任务时，开启并配置自定义文件路径。如下图所示：

此外，在视频点播控制台上传存储设置页面开启自动生成封面时，可配置自动生成的封面图路径。如下图所示：

文件路径组成说明 #

文件路径由固定字符串和变量组成。

固定字符串 #

固定字符串可用来表示具体的业务信息。例如 watermark 表示有水印、encrypt 表示加密。你指定固定字符串时，需遵循文件命名通用字符规则。

变量 #

变量是指系统会在生成具体文件路径时获取该变量的实际取值进行动态替换的部分。变量引用格式为 {{变量名称}}。视频点播支持的变量如下表所示。

文件输出格式 #