閱讀633 返回首頁    go 阿裏雲 go 技術社區[雲棲]

提交截圖作業__截圖接口_API使用手冊_媒體轉碼-阿裏雲

描述

提交截圖作業接口，目前支持生成jpg格式圖片。

  • 同步模式：接口同步返回截圖結果，截圖在接口返回時就已經生成到對應的Bucket。
  • 異步模式：不保證接口返回時截圖已經生成，截圖任務將進入後台排隊，異步執行截圖。隻要設置了Interval和Num中的任何一個參數，就表示異步模式。
  • 消息通知：提交截圖作業時，隻要指定了PipelineId參數，完成後將發送異步消息。

請求參數

名稱 類型 必填項 描述
Action String 是 操作接口名，係統規定參數，取值： SubmitSnapshotJob
Input String 是 作業輸入，JSON對象，Input定義詳見術語表。例如：
{
"Bucket":"example-bucket",
"Location":"oss-cn-hangzhou",
"Object":"example.flv"
}
需在控製台中授予此Bucket權限給媒體轉碼服務。
SnapshotConfig String 是 截圖配置，Json對象，詳細見附錄參數詳情，截圖配置參數詳情。例如，
同步模式：
{
"OutputFile": {
"Bucket": "example-001",
"Location": "oss-cn-hangzhou",
"Object": "example.jpg"
},
"Time": "5"
}
異步模式(5毫秒開始，每間隔20秒截一張，共截10張)：
{
"OutputFile": {
"Bucket": "example-001",
"Location": "oss-cn-hangzhou",
"Object": "{Count}.jpg"
},
"Time": "5",
"Num":"10",
"Interval":"20"
}
PipelineId String 否 管道ID，須保證此管道綁定了可用的消息主題，否則消息無法正確發送。
UserData String 否 用戶自定義數據，最大長度1024個字節。

返回參數

名稱 類型 描述
SnapshotJob AliyunSnapshotJob 截圖作業

示例

請求示例

  1.     https://mts.aliyuncs.com?Time=10&Action=SubmitSnapshotJob&Input=%7b%22Bucket%22%3a%22example-bucket%22%2c%22Location%22%3a%22oss-cn-hangzhou%22%2c%22Object%22%3a%22example.flv%22%7d&SnapshotConfig=%7B%22OutputFile%22%3A%7B%22Bucket%22%3A%22example-001%22%2C%22Location%22%3A%22oss-cn-hangzhou%22%2C%22Object%22%3A%22example.jpg%22%7D%2C%22Time%22%3A%225%22%7D&PipelineId=88c6ca184c0e47098a5b665e2a126797<公共參數>

返回示例

XML格式:

  1.     <SubmitSnapshotJobResponse>
  2.         <RequestId>
  3.             25818875-5F78-4A13-BEF6-D7393642CA58
  4.         </RequestId>
  5.         <SnapshotJob>
  6.             <Id>88c6ca184c0e47098a5b665e2a126797</Id>
  7.             <State>Success</State>
  8.             <Code> </Code>
  9.             <Message> </Message>
  10.             <SnapshotConfig>
  11.                <OutputFile>
  12.                   <Bucket>example-001</Bucket>
  13.                   <Location>oss-cn-hangzhou</Location>
  14.                   <Object>example.png</Object>
  15.                </OutputFile>
  16.                <Time>4</Time>
  17.             </SnapshotConfig>
  18.             <PipelineId>88c6ca184c0e47098a5b665e2a126797</PipelineId>
  19.             <UserData>testid-001</UserData>
  20.             <CreationTime>2014-01-10T12:00:00Z</CreationTime>
  21.         </SnapshotJob>
  22.     </SubmitSnapshotJobResponse>

Json:

  1.     {
  2.         "RequestId": "25818875-5F78-4A13-BEF6-D7393642CA58",
  3.         "SnapshotJob": {
  4.             "Id": "88c6ca184c0e47098a5b665e2a126797",
  5.             "State": "Success",
  6.              "Code": "",
  7.             "Message": "",
  8.             “SnapshotConfig”:{
  9.                "OutputFile": {
  10.                    "Bucket": "example-001",
  11.                    "Location": "oss-cn-hangzhou",
  12.                    "Object": "example.png"
  13.                },
  14.                “Time”:”5”
  15.              },
  16.              "PipelineId": "88c6ca184c0e47098a5b665e2a126797",
  17.              "UserData": "testid-001",
  18.              "CreationTime": "2014-01-10T12:00:00Z"
  19.        }
  20.     }

最後更新：2016-11-23 16:04:03

  上一篇：go 列出轉碼作業__轉碼接口_API使用手冊_媒體轉碼-阿裏雲
  下一篇：go 查詢截圖作業__截圖接口_API使用手冊_媒體轉碼-阿裏雲