全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网
媒体转码

新增媒体

更新时间:2017-08-28 11:55:26

新增媒体

描述

新增媒体

特别提醒:

a).如果已经配置工作流,上传媒体文件到OSS后,OSS会自动通知MTS,MTS会根据OSS的Bucket,Object自动匹配激活状态的工作流自动执行,因此通常情况下不需要手动调用AddMedia 接口处理文件,只有当在OSS上有存量视频时,处理存量视频可以用此接口,从而避免了重新上传视频到OSS。

b)媒体信息获取,只有在指定激活状态的工作流处理时,自动获取,不指定工作流时,不会获取媒体信息

请求参数

名称 类型 必填项 描述
Action String 操作接口名,系统规定参数,取值:AddMedia
FileURL String 媒体文件路径,不超过3200字节。URL遵循 RFC 2396(UTF8编码,并进行URLEncode)。
Title String 媒体标题,长度限制不超过128个字节,utf-8编码
Description String 描述,长度限制不超过1024个字节,utf-8编码
CoverURL String 封面,不超过3200字节。URL遵循 RFC 2396(UTF8编码,并进行URLEncode)。
CateId Long 类目ID,不允许为负数。
Tags String 标签列表,逗号分隔,不超过16个标签,单个标签不能超过32个字节,utf-8编码
MediaWorkflowId String 媒体工作流ID
MediaWorkflowUserData String 媒体工作流用户自定义数据,不超过1024字节,要求UTF8编码。

1.工作流触发匹配规则

规则匹配执行策略如下:以新增文件的路径为基础,检查工作流绑定的位置,如果新增文件的路径中包含规则绑定的字符串则匹配,不包含则不匹配。如 http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flv规则:

  1. 1http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/ 匹配
  2. 2http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/ 匹配
  3. 3http://bucket.oss-cn-hangzhou.aliyuncs.com/A/ 匹配
  4. 4http://bucket.oss-cn-hangzhou.aliyuncs.com/ 匹配
  5. 5http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test.flv 匹配
  6. 6http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/CC/ 不匹配
  7. 7http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B2/ 不匹配
  8. 8http://bucket.oss-cn-hangzhou.aliyuncs.com/A2/B/C/ 不匹配

说明:请不要配置一个工作流的输入路径为另外一个工作流的输入路径的前缀,否则会一个增量文件触发两次工作流执行实例。例如:两个工作流的输入路径分别配置test和test1,则当输入文件上传到test1文件夹下同样满足test前缀,因此会触发两次工作流执行实例。

2.匹配文件扩展名

触发要求必须是多媒体文件,媒体库服务是通过文件扩展名来判断的。文件或者没有扩展名(文件名中不包含扩展名分割符号”.”),或者扩展名符合下面的规则:

特别注意:对于swf,截图及转码服务质量不保障

类型 扩展名
视频 3gp, asf, avi, dat, dv, flv, f4v, gif, m2t, m3u8, m4v, mj2, mjpeg, mkv, mov, mp4, mpe, mpg, mpeg, mts, ogg, qt, rm, rmvb, swf, ts, vob, wmv, webm
音频 aac, ac3, acm, amr, ape, caf, flac, m4a, mp3, ra, wav, wma, aiff

3.媒体工作流消息

媒体工作流采用阿里云消息服务发送消息给视频云服务接入方,媒体工作流会在(Start/Report)活动节点完成时发送消息,若需要接收消息,需要在Start活动上设置队列/通知名称,媒体工作流产生的消息存储在队列/通知中,可以使用消息服务SDK获取消息,消息规格如下:

名称 类型 描述
RunId String 工作流执行Id
Name String 活动名称
Type String 活动类型,范围:Report、Start
State String 活动状态,范围:Fail、Success
Code String 错误码。如果活动状态是Fail时,会给出具体的错误码。
Message String 错误消息。如果活动状态是Fail时,会给出详细的错误描述信息。
MediaWorkflowExecution MediaWorkflowExecution 媒体工作流执行信息

JSON消息体示例:

  1. {
  2. "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
  3. "Name": "Act-7",
  4. "Type": "Report",
  5. "State": "Success",
  6. "MediaWorkflowExecution": {
  7. "Name": "ConcurrentSuccess",
  8. "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
  9. "Input": {
  10. "InputFile": {
  11. "Bucket": "inputfirst",
  12. "Location": "oss-test",
  13. "Object": "mediaWorkflow/ConcurrentSuccess/01.wmv"
  14. },
  15. "UserData":"test"
  16. },
  17. "State": "Success",
  18. "MediaId": "2be491ab4cb6499cd0befe5fcf0cb670",
  19. "ActivityList": [
  20. {
  21. "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
  22. "Name": "Act-1",
  23. "Type": "Start",
  24. "State": "Success",
  25. "StartTime": "2016-03-15T02: 53: 41Z",
  26. "EndTime": "2016-03-15T02: 53: 41Z"
  27. },
  28. {
  29. "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
  30. "Name": "Act-2",
  31. "Type": "Transcode",
  32. "JobId": "f34b6d1429dd491faa7a6c1c8f905285",
  33. "State": "Success",
  34. "StartTime": "2016-03-15T02: 53: 43Z",
  35. "EndTime": "2016-03-15T02: 53: 47Z"
  36. },
  37. {
  38. "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
  39. "Name": "Act-3",
  40. "Type": "Transcode",
  41. "JobId": "888ac3903ecf4898b9d790cf7f1d969e",
  42. "State": "Success",
  43. "StartTime": "2016-03-15T02: 53: 44Z",
  44. "EndTime": "2016-03-15T02: 53: 48Z"
  45. },
  46. {
  47. "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
  48. "Name": "Act-5",
  49. "Type": "Snapshot",
  50. "JobId": "c14150be33304825a5d67cd5364c35cb",
  51. "State": "Success",
  52. "StartTime": "2016-03-15T02: 53: 44Z",
  53. "EndTime": "2016-03-15T02: 53: 45Z"
  54. },
  55. {
  56. "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
  57. "Name": "Act-6",
  58. "Type": "Snapshot",
  59. "JobId": "8c30c30ca7324286afda1a9a1b14d03c",
  60. "State": "Success",
  61. "StartTime": "2016-03-15T02: 53: 48Z",
  62. "EndTime": "2016-03-15T02: 53: 49Z"
  63. },
  64. {
  65. "RunId": "8f8aba5a62ab4127ae2add18da20b0f2",
  66. "Name": "Act-7",
  67. "Type": "Report",
  68. "State": "Success",
  69. "StartTime": "2016-03-15T02: 53: 49Z",
  70. "EndTime": "2016-03-15T02: 53: 49Z"
  71. }
  72. ],
  73. "CreationTime": "2016-03-15T02: 53: 39Z"
  74. }
  75. }

返回参数

名称 类型 描述
Media Media 媒体

示例

请求示例

  1. http://mts.cn-hangzhou.aliyuncs.com?MediaWorkflowUserData=test&MediaWorkflowId=09bc2f74e39c48dd86597849e2b060f6&FileURL=http%3A%2F%2Fzzzinput-test.oss-cn-hangzhou.aliyuncs.com%2Ftail_comm-33.mp4&<公共参数>

返回示例

XML:

  1. <AddMediaResponse>
  2. <Media>
  3. <CoverURL>http://zzyoutputbucket.oss-cn-hangzhou.aliyuncs.com/aa9bb3115da54befa74e0bd81a7a9e46%2F0.jpg</CoverURL>
  4. <Format>mov,mp4,m4a,3gp,3g2,mj2</Format>
  5. <PublishState>Published</PublishState>
  6. <Height>1280</Height>
  7. <MediaId>3e6149d5a8c944c09b1a8d2dc3e4ac65</MediaId>
  8. <Title>tail_comm-33.mp4</Title>
  9. <CreationTime>2016-09-20T03:02:40Z</CreationTime>
  10. <RunIdList>
  11. <RunId>adee42a78b1f407184a792b8777efb3c</RunId>
  12. </RunIdList>
  13. <CateId>0</CateId>
  14. <Duration>2.645333</Duration>
  15. <Width>1280</Width>
  16. <Fps>25.0</Fps>
  17. <Bitrate>1148.77</Bitrate>
  18. <Size>379860</Size>
  19. </Media>
  20. <RequestId>13E58723-4746-46A5-900D-B41D425A2A44</RequestId>
  21. </AddMediaResponse>

Json:

  1. {
  2. "Media": {
  3. "CoverURL": "http://zzyoutputbucket.oss-cn-hangzhou.aliyuncs.com/adee42a78b1f407184a792b8777efb3c%2F0.jpg",
  4. "Format": "mov,mp4,m4a,3gp,3g2,mj2",
  5. "PublishState": "Published",
  6. "Height": "1280",
  7. "MediaId": "3e6149d5a8c944c09b1a8d2dc3e4ac65",
  8. "Title": "tail_comm-33.mp4",
  9. "CreationTime": "2016-09-20T03:02:40Z",
  10. "RunIdList": {
  11. "RunId": [
  12. "cbad98d35629470fa05ff393d347fd73"
  13. ]
  14. },
  15. "CateId": 0,
  16. "Duration": "2.645333",
  17. "Width": "1280",
  18. "Fps": "25.0",
  19. "Bitrate": "1148.77",
  20. "Size": "379860"
  21. },
  22. "RequestId": "A29ED91C-84A2-41FE-8F7F-116531A28544"
  23. }
本文导读目录