全部产品
Search

搜索本产品

    媒体处理：工作流活动介绍

    文档中心

    媒体处理：工作流活动介绍

    更新时间：Sep 20, 2024

    本文介绍了媒体工作流拓扑结构中的活动类型及支持参数。当您调用AddMediaWorkflow - 新增媒体工作流、UpdateMediaWorkflow - 更新媒体工作流的拓扑结构接口填写Topology拓扑结构时可参考此文档进行设置。

    活动类型

    活动名称

    拓扑结构中的Activitiy类型

    说明

    输入（必选）

    Start

    设置媒体工作流的OSS输入路径和全局配置，包括管道、消息。

    发布（必选）

    Report

    设置手动发布、自动发布。

    分析

    Analysis

    对输入文件进行智能分析，推荐出适合输入文件的预置模板。

    转码

    Transcode

    可以将视频文件转码成适合在全平台播放的格式。

    截图

    Screenshot

    截取指定时间点的画面，用做视频封面或生成雪碧图。

    打包配置

    PackageConfig

    将多分辨率视频、多音轨、多字幕文件打包生成M3U8的过程。

    视频组

    VideoGroup

    音频组

    AudioGroup

    字幕组

    SubtitleGroup

    提取视频

    提取音频

    提取字幕

    Transcode

    打包生成

    GenerateMasterPlayList

    审核

    Censor

    智能识别视频内语音、文字、画面的色情、暴恐涉政、不良画面等内容，大幅节省人工审核人力成本，降低违规风险。

    视频DNA

    FpShot

    用来唯一标记一个视频，实现对视频中的图像、音频等指纹特征的提取和比对，解决重复视频查找、视频片段查源、原创识别等问题。

    智能封面

    Cover

    通过对视频内容的理解，结合画面和海量用户行为数据，基于算法选出最优的关键帧或关键片段作为视频封面，提升视频点击转化及用户体验。

    输入

    必选。设置媒体工作流的OSS输入路径和全局配置，包括管道、消息。

    本活动会执行媒体信息获取。如果媒体信息获取失败，则后续活动会跳过，直到执行发布（Report）活动。

    名称

    类型

    是否必选

    描述

    InputFile

    String

    是

    输入文件，使用OSS的Bucket、Location、Object描述文件位置。

    • 具体触发匹配规则，请参见工作流的文件匹配规则。

    • 文件只支持存储于OSS上，参数规范请参见参数详情。

    • 在媒体处理API中，Object必须经过URL Encoding说明（基于UTF-8编码）后使用。

    • 示例：{"Bucket":"example-bucket","Location":"oss-cn-hangzhou","ObjectPrefix":"example.mp4"}。

    PipelineId

    String

    是

    全局配置。管道ID。

    • 仅分析/转码/截图/打包使用该管道ID，AI类任务在节点中单独配置。

    • 工作流场景，管道上的单独配置的消息无效，请使用工作流QueueName/TopicName中配置的消息。

    MessageType

    String

    否

    全局配置。消息类别。

    • Queue：使用MNS队列。请设置为QueueName。

    • Topic：使用MNS主题。请设置为TopicName。

    • 默认值：Queue。

    QueueName

    String

    否

    全局配置。媒体处理管道上绑定的MNS队列。绑定后，当该管道上的作业执行结束时，会将执行结果发送到该队列。消息请参见接收消息通知。

    TopicName

    String

    否

    全局配置。媒体处理管道上绑定的MNS主题。绑定后，当该管道上的作业执行结束时，会将执行结果发送到该主题。主题会以消息形式推送到订阅的地址上，消息请参见接收消息通知。

    RoleName

    String

    否

    全局配置。授权角色名称。

    • 默认值：AliyunMTSDefaultRole。

    发布

    必选。设置工作流任务完成后的媒体发布方式。

    名称

    类型

    必须

    描述

    PublishType

    String

    否

    全局配置。媒体发布类型。

    • Manual：手动发布。工作流执行成功后，将媒体设置为未发布状态，之后您可以手动发布该媒体。请参见管理媒体。

    • Auto：所有活动完成后自动发布。工作流执行成功后，将媒体设置为发布状态。

    • TranscodeCompletedAuto：任一转码活动完成后自动发布。将使用Start节点的消息配置通知用户转码完成。若转码活动的状态是跳过的话，不会发送消息。

    • 默认值：Manual。

      说明

      • 媒体处理在执行工作流进行文件处理时，针对不同的发布类型，会使用STS临时用户对输出文件进行调整。

      • 发布状态会影响输出文件的访问权限。

        • 不发布：视频、音频、截图文件的访问权限为私有。

        • 已发布：视频、音频、截图文件的访问权限继承所在Bucket的访问权限。

    分析（Analysis）

    对输入文件进行智能分析，推荐出适合输入文件的预置模板。

    名称

    类型

    必须

    描述

    KeepOnlyHighestDefinition

    String

    否

    是否只保留最高清晰度的分析结果。

    • True：仅输出可选范围内的最高清晰度。

    • False：输出可选范围内全部清晰度。

    • 默认值：False。

    转码（Transcode）

    名称

    类型

    必须

    描述

    Outputs

    String

    否

    转码作业输出。

    • Outputs由Output列表构成，JSON数组，大小上限为30。

    • Output的参数说明，请参见参数详情。

    • 示例：[{"OutputObject":"transcode%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D","TemplateId": "S00000001-000070"}]。

    OutputBucket

    String

    否

    输出Bucket。

    • HLS及DASH打包时，PackageConfig中的Bucket会覆盖此项。

    OutputLocation

    String

    否

    输出区域。

    • HLS及DASH打包时，PackageConfig中的Location会覆盖此项。

    MultiBitrateVideoStream

    String

    否

    HLS打包，提取视频流时必填。

    • 更多信息，请参见参数详情。

    • 示例：{"URI": "c/d/video1.m3u8"}。

    ExtXMedia

    String

    否

    HLS打包，提取音频流或者字幕流时必填。

    • 更多信息，请参见参数详情。

    • 示例：{"Name": "english","Language": "en-US","URI":"c/d/audio-1.m3u8"}。

    WebVTTSubtitleURL

    String

    否

    HLS打包，提取字幕流活动必填，字幕输出地址。

    • 目前只支持WebVTT字幕文件，必须符合URL规范，可以在调用AddMedia时覆盖字幕地址。

    • 示例：http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/subtitles****-en.vtt。

    Representation

    String

    否

    DASH打包，提取视频流、音频流或者字幕流活动时必填。

    • 更多信息，请参见参数详情。

    • 示例：{\"Id\":\"480p\", \"URI\":\"videoSD/xx.mpd\"}。

    InputConfig

    String

    否

    DASH打包，提取字幕流活动必填，字幕输出地址。

    • 更多信息，请参见参数详情。

    • 示例："{\"Format\":\"vtt\",\"InputFile\":{\"URL\":\"http://example-Bucket-****.oss-cn-hangzhou.aliyuncs.com/subtitle/subtitle****-en.vtt\"}}"。

    截图（Screenshot）

    名称

    类型

    必须

    描述

    SnapshotConfig

    String

    是

    截图配置。

    • 更多信息，请参见参数详情。

    • 示例：{"OutputFile": {"Bucket": "example-001", "Location": "oss-cn-hangzhou", "Object":"snapshot%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D%2F1.jpg"},"Time": "5"}。

    MediaCover

    String

    否

    是否设置成媒体封面。仅支持单张图时生效。

    • true：是。

    • false：否。

    • 默认值：false。

    打包

    打包配置（PackageConfig）

    名称

    类型

    必须

    描述

    Output

    String

    是

    JSON字符串。示例：{"Bucket":"output","Location":"oss-cn-hangzhou","MasterPlayListName":"a/b/c.m3u8"}。

    说明

    MasterPlayListName中可以使用的占位符：

    • {ObjectPrefix}：不含Bucket信息的原文件路径。

    • {FileName}：含扩展名的原文件名，根据转码模板的format补齐后缀。

    • {ExtName}：原文件扩展名。

    • {RunId}：媒体工作流执行ID。

    • {MediaId}：代表工作流所处理媒体ID。

    Protocol

    String

    是

    值范围：hls、dash。

    视频组（VideoGroup）

    名称

    类型

    必须

    描述

    AdaptationSet

    String

    否

    视频组信息。DASH打包，必填。

    • 更多信息，请参见参数详情。

    • 示例："AdaptationSet":"{\"Group\":\"VideoGroup\"}"。

    音频组（AudioGroup）

    名称

    类型

    必须

    描述

    GroupId

    String

    否

    音频分组ID。HLS打包，必填。

    • 长度不能超过32个字节。

    AdaptationSet

    String

    否

    音频组信息。DASH打包，必填。

    • 更多信息，请参见参数详情。

    • 示例："{\"Lang\":\"english\", \"Group\":\"AudioGroupEnglish\"}"。

    字幕组（SubtitleGroup）

    名称

    类型

    必须

    描述

    GroupId

    String

    否

    字幕分组ID。HLS打包，必填。

    • 长度不能超过32个字节。

    AdaptationSet

    String

    否

    字幕组信息。DASH打包，必填。

    • 更多信息，请参见参数详情。

    • 示例："{\"Lang\":\"english\", \"Group\":\"SubtitleENGroup\"}"。

    打包生成（GenerateMasterPlayList）

    名称

    类型

    必须

    描述

    MasterPlayList

    String

    否

    • HLS专属参数，必填，视频多码流列表。更多信息，请参见参数详情。

    • 示例：{"MultiBitrateVideoStreams": [{"RefActivityName": "video-1","ExtXStreamInf": {"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}}]}。

    相关文档