edit-icon download-icon

AddMedia

最終更新日: Oct 31, 2018

説明

AddMedia API はメディアを追加します。

注意:

  • ワークフローが設定され、OSS にメディアファイルがアップロードされると、OSS は自動的に MPS に通知します。MPS は OSS バケットおよび OSS オブジェクトに適合する、有効なワークフローを特定します。適合したワークフローは自動的に開始されます。したがって、通常は人手を介さずに AddMedia API よりファイルは自動的に処理されますが、OSS 内のビデオファイルをアップロードせずに AddMedia API を手動で実行することもできます。

  • **有効なワークフローを指定して実行すると、メディア情報は自動的に取得されます。ワークフローが指定されていない場合、メディア情報は取得されません。

リクエスト パラメーター

パラメーター データ型 必須 説明
Action String はい 操作 API、システム必須パラメーター。パラメーターの値は AddMedia にします。
FileURL String はい メディアファイルへのパス(最大 3200 バイト、URL 形式は RFC 2396 標準に従い、UTF-8 および URL エンコードで符号化)
Title String いいえ メディアタイトル(最大 128 バイト、UTF-8 で符号化)
Description String いいえ 説明(最大 1024 バイト、UTF-8 で符号化)
CoverURL String いいえ カバー(最大 3200 バイト、URL 形式は RFC 2396 標準に従い、UTF-8 および URL エンコードで符号化)
CateId Long いいえ カテゴリ ID(負の数値は不可)
Tags String いいえ カンマ (,) で区切られたタグのリスト(各タグは最大 32 バイト、最大 16 個、UTF-8 で符号化)
MediaWorkflowId String いいえ メディアワークフローの ID
MediaWorkflowUserData String いいえ メディアワークフローのカスタム データ(最大 1024 バイト、UTF-8 で符号化)
OverrideParams JSON いいえ パラメーターを上書きします。例:{“WebVTTSubtitleOverrides”,[{“RefActivityName”:”subtitleNode”,”WebVTTSubtitleURL”:”http://test.oss-cn-hangzhou.aliyuncs.com/subtitle1.vtt"}]}
  • ワークフロー起動のマッチングルール

    マッチングルールの処理:新規ファイルのパスに基づき、マッチングルールはワークフローがバインドされているパスをチェックします。ファイルのパスにマッチングルールにバインドされた文字列を含む場合、マッチングルールに適合します。ファイルのパスにマッチングルールにバインドされた文字列を含まない場合、マッチングルールに適合しません。たとえば、http://bucket.oss-cn-hangzhou.aliyuncs.com/A/B/C/test1.flvの場合、次のようになります。

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

    注意:ワークフローの入力パスは、他のワークフローの入力パスと接頭辞が重ならないようにします。接頭辞が同じのものがあると、インクリメントされたファイルは、2 つのワークフローを実行してしまいます。たとえば、2 つのワークフローがあり、入力パスが test および test1 であるとします。入力ファイルが 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
  • メディア ワークフロー メッセージ

    Start アクティビティおよび Report アクティビティが完了すると、メディアワークフローは、Alibaba Cloud Message Service を使用して、ビデオ クラウド サービスにアクセスするユーザーにメッセージを送信します。メッセージを受信するには、Start ノードに MNS キュー名および通知名を指定します。MNS キューまたは通知に格納されたメッセージは Message Service 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. }

応答パラメーター

パラメーター データ型 説明
メディア メディア メディア

リクエスト例

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

応答例

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. }