本文介绍了媒体工作流的活动类型以及活动支持的参数。

Start活动

支持设定媒体工作流的触发条件和全局配置。本活动会执行媒体信息获取。如果媒体信息获取失败，则后续活动会跳过，直到执行Report活动。
名称类型必须描述
InputFileString是输入文件，包含输入文件所在OSS Bucket、输入文件所在地域及输入文件前缀。
  • 示例：{"Bucket":"example-001","Location":"oss-cn-hangzhou", "ObjectPrefix":"test"}。
  • 具体触发匹配规则，请参见 工作流触发匹配规则。
PipelineIdString是管道ID，全局配置。工作流场景，管道上的消息配置无效，QueueName/TopicName的消息配置有效。
MessageTypeString否消息类别。
  • 范围：Queue（队列）、Topic（主题）。
  • 默认值：Queue（队列）。
QueueNameString否队列名称，全局配置。
TopicNameString否主题名称，全局配置。
RoleNameString否授权角色名称，全局配置。默认值：AliyunMTSDefaultRole。

Transcode活动

名称类型必须描述
OutputsString否字幕提取时非必填。
  • 更多信息，请参见Output详情。
  • 示例：[{"OutputObject":"transcode%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D","TemplateId": "S00000001-000070"}]。
OutputBucketString否输出Bucket。HLS及DASH打包时，PackageConfig中的Bucket会覆盖此项。
OutputLocationString否输出区域。HLS及DASH打包时，PackageConfig中的Location会覆盖此项。
MultiBitrateVideoStreamString否HLS打包，提取视频流时必填。
ExtXMediaString否HLS打包，提取音频流或者字幕流时必填。
  • 更多信息，请参见ExtXMedia详情。
  • 示例：{"Name": "english","Language": "en-US","URI":"c/d/audio-1.m3u8"}。
WebVTTSubtitleURLString否HLS打包专属参数，字幕地址。
  • 目前只支持WebVTT字幕文件，必须符合URL规范，可以在调用AddMedia时覆盖字幕地址。
  • 示例：http://example-bucket-****.oss-cn-hangzhou.aliyuncs.com/subtitles****-en.vtt。
RepresentationString否DASH打包时，提取音频流、视频流或者字幕流时必填。
  • 更多信息，请参见Representation详情。
  • 示例：{\"Id\":\"480p\", \"URI\":\"videoSD/xx.mpd\"}。
InputConfigString否DASH打包专属，提取字幕流活动必填。
  • 更多信息，请参见InputConfig详情。
  • 示例："{\"Format\":\"vtt\",\"InputFile\":{\"URL\":\"http://example-Bucket-****.oss-cn-hangzhou.aliyuncs.com/subtitle/subtitle****-en.vtt\"}}"。

Screenshot活动

名称类型必须描述
SnapshotConfigString是
  • 详情参见：截图参数配置详情。
  • 示例：{"OutputFile": {"Bucket": "example-001", "Location": "oss-cn-hangzhou", "Object":"snapshot%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D%2F1.jpg"},"Time": "5"}。
MediaCoverString否是否设置成媒体封面。
  • 只针对单张截图。
  • 范围：true（是），false（否）。
  • 默认值：false（否）。

Analysis活动支持的参数

名称类型必须描述
KeepOnlyHighestDefinitionString否是否只保留最高清晰度的分析结果。
  • 范围：True（是），False（否）。
  • 默认值：False（否）。

Report活动

名称类型必须描述
PublishTypeString否媒体发布类型。
范围：Auto、Manual、TranscodeCompletedAuto。
  • Auto表示工作流执行完成后自动发布。
  • Manual表示不发布。
  • TranscodeCompletedAuto表示任一转码活动完成后自动发布（使用Start节点的消息配置通知用户转码完成，而且可以使用播放服务播放该活动输出）。

默认值：Manual。

说明
  • 媒体处理在执行工作流进行文件处理时，针对不同的发布类型，会使用STS临时用户对输出文件进行调整。
  • 类型为TranscodeCompletedAuto时，若转码活动的状态是跳过的话，不会发送消息。

PackageConfig活动

名称类型必须描述
OutputString是JSON字符串。示例：{"Bucket":"output","Location":"oss-cn-hangzhou","MasterPlayListName":"a/b/c.m3u8"}。
说明 MasterPlayListName中可以使用的占位符：
  • {ObjectPrefix}：不含Bucket信息的原文件路径。
  • {FileName}：含扩展名的原文件名，根据转码模板的format补齐后缀。
  • {ExtName}：原文件扩展名。
  • {RunId}：媒体工作流执行ID。
  • {MediaId}：代表工作流所处理媒体ID。
所有的占位符可以动态替换。
ProtocolString是取值：hls、dash。

SubtitleGroup活动

名称类型必须描述
GroupIdString否分组ID。
  • HLS打包专属参数，必填。
  • 长度不能超过32个字节。
AdaptationSetString否
  • DASH打包专属参数，必填，更多信息，请参见AdaptationSet详情。
  • 示例："{\"Lang\":\"english\", \"Group\":\"SubtitleENGroup\"}"

AudioGroup活动

名称类型必须描述
GroupIdString否分组ID。
  • HLS打包专属参数，必填。
  • 长度不能超过32个字节。
AdaptationSetString否
  • DASH打包专属参数，必填，更多信息，请参见AdaptationSet详情。
  • 示例："{\"Lang\":\"english\", \"Group\":\"AudioGroupEnglish\"}"，一种语言一个字幕组。

VideoGroup活动

名称类型必须描述
AdaptationSetString否
  • DASH打包专属参数，必填，更多信息，请参见AdaptationSet详情。
  • 示例："AdaptationSet":"{\"Group\":\"VideoGroup\"}"

GenerateMasterPlayList活动

名称类型必须描述
MasterPlayListString否
  • HLS专属参数，必填，视频多码流列表。更多信息，请参见MasterPlayList详情。
  • 示例：{"MultiBitrateVideoStreams": [{"RefActivityName": "video-1","ExtXStreamInf": {"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}}]}。