媒体工作流活动的类型包括: Start、 Transcode、Snapshot、 Analysis、 Cover、Summary、Censor、Report、UploadVerify、 GenerateMasterPlayList、AudioGroup、SubtitleGroup、PackageConfig、VideoGrou 本文将会介绍以下活动支持的参数:

Start活动

支持设定媒体工作流的触发条件和全局配置。本活动会执行媒体信息获取。如果媒体信息获取失败,则后续活动会跳过,直到执行Report活动。
名称 类型 必须 描述
InputFile String 输入位置,参见 工作流触发匹配规则

示例:{“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://test.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://subtitlebucket.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

说明 类型为TranscodeCompletedAuto时,若转码活动的状态是跳过的话,不会发送消息。

PackageConfig活动

名称 类型 必须 描述
Output String JSON字符串。
示例:{“Bucket”:”output”,”Location”:”oss-cn-hangzhou”,”MasterPlayListName”:”a/b/c.m3u8”}。
说明 MasterPlayListName中可以使用的占位符:
  • {ObjectPrefix}:不含Bucket信息的原文件路径。
  • {FileName}:不含扩展名的原文件名。
  • {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” }}]}。