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

Start活动

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

Transcode活动

名称 类型 必须 描述
Outputs String 字幕提取时非必填。
  • 更多信息,请参见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打包,提取视频流时必填。
ExtXMedia String HLS打包,提取音频流或者字幕流时必填。
  • 更多信息,请参见ExtXMedia详情
  • 示例:{"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打包时,提取音频流、视频流或者字幕流时必填。
  • 更多信息,请参见Representation详情
  • 示例:{\"Id\":\"480p\", \"URI\":\"videoSD/xx.mpd\"}。
InputConfig String DASH打包专属,提取字幕流活动必填。
  • 更多信息,请参见InputConfig详情
  • 示例:"{\"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(否)。

Analysis活动支持的参数

名称 类型 必须 描述
KeepOnlyHighestDefinition String 是否只保留最高清晰度的分析结果。
  • 范围:True(是),False(否)。
  • 默认值:False(否)。

Report活动

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

默认值:Manual。

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

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。

SubtitleGroup活动

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

AudioGroup活动

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

VideoGroup活动

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

GenerateMasterPlayList活动

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