本文旨在介紹在智能圖文匹配成片-體育賽事集錦情境下的合成參數、SDK調用樣本。
注意:在此介面中,所有媒資的OSS URL中的地區(region)必須與調用OpenAPI服務地址中的地區(region)保持一致。
支援的地區:華東2(上海)。
在實際使用過程中,請將文檔所有參數樣本中的 [your-bucket]、[your-region-id]、[your-file-name]、[your-file-path]、媒資ID(例如:“****9d46c8b4548681030f6e****”)等參數替換為您的實際值。
為了更好地閱讀本文,建議您在閱讀本文之前先通過智能一鍵成片操作指南瞭解【智能圖文匹配成片-體育賽事集錦】相關的概念與使用流程。
使用說明
將完整體育賽事視頻進行智能混剪,一鍵批量合成視頻介面說明,請參見SubmitSportsHighlightsJob - 提交體育集錦任務,API關鍵參數詳見下文InputConfig 參數說明、OutputConfig 參數說明。
擷取批量智能一鍵成片作業的詳細資料,請參見GetBatchMediaProducingJob - 擷取批量智能一鍵成片任務資訊。
InputConfig 參數說明
使用者可通過配置InputConfig,指定視頻素材、口播、背景音樂、貼紙等基礎素材的參數配置。
參數 | 類型 | 說明 | 樣本值 | 是否必填 |
SportsCategory | String | 體育賽事類型 籃球:basketball 乒乓球:pingpong | basketball | 是 |
InputMedia | String | 輸入的體育賽事素材。支援MediaId 或 MediaURL
| ****9d46c8b4548681030f6e**** | 是 |
FaceRegister | List<FaceInfo> | 人物標識,數組長度小於等於5。 | 詳見參數樣本 | 否 |
SlowMotionLogoRegister | 縮時攝影標識。如果成片中需包含縮時攝影,需提供源片中縮時攝影之前出現的logo標識資訊。數組長度小於等於5。 | 詳見參數樣本 | 否 | |
TransferNameRegister | List<TransferNameInfo> | 名稱轉寫標識,將記分牌中的隊名縮寫轉寫為完整隊名。數組長度小於等於10。 | 詳見參數樣本 | 是 |
FaceInfo 參數說明
欄位 | 類型 | 描述 | 樣本值 | 必填 |
FaceUrls | List<String> |
| ["http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png","http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png""] | 是 |
Name | String | 人物名稱,必須與輸入視頻中記分牌顯示的人名一致 | 張三 | 是 |
SlowMotionLogoRegister 參數說明
欄位 | 類型 | 描述 | 樣本值 | 必填 |
SlowMotionLogoUrls | List<String> |
| ["http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png","http://[your-bucket].oss-[your-region-id].aliyuncs.com/test1.png""] | 是 |
TransferNameInfo 參數說明
欄位 | 類型 | 描述 | 樣本值 | 必填 |
OriginalName | String | 賽事記分牌中的隊名縮寫 | Rockets | 是 |
TransferName | String | 完整隊名 | Houston Rockets | 是 |
參數樣本
{
"SportsCategory": "Basketball",
"InputMedia": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4",
"FaceRegister": [
{
"FaceUrls": ["http://testcdn.com/front.jpg", "http://testcdn.com/side.jpg"],
"Name": "James"
}
],
"SlowMotionLogoRegister": {
"SlowMotionLogoUrls": ["http://testcdn.com/logo1.jpg", "http://testcdn.com/logo2.jpg"]
},
"TransferNameRegister": [
{
"OriginalName": "IND",
"TransferName": "印地安納步行者"
}
]
}EditingConfig 參數說明
暫不支援配置EditingConfig相關參數
OutputConfig 參數說明
使用者可通過配置OutputConfig,指定成片輸出地址、名稱規則、成片的寬高、輸出成片數量等合成參數配置。
參數 | 類型 | 說明 | 樣本值 | 必填 |
MediaURL | String | 輸出視頻地址,必須要有預留位置{index}。 | 規則:http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4 樣本:http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4 | 當GeneratePreviewOnly=false時,且成片輸出到OSS時必填 |
StorageLocation | String | 指定輸出到VOD的媒資檔案儲存體地址。 | 規則:[your-vod-bucket].oss-[your-region-id].aliyuncs.com 樣本:outin-****6c886b4549d481030f6e****.oss-cn-shanghai.aliyuncs.com | 當GeneratePreviewOnly=false時,且成片輸出到VOD時必填 |
FileName | String | 輸出檔案名稱,必須要有預留位置{index}。 | 規則:[your-file-name]__{index}.mp4 樣本:example_{index}.mp4 | 當GeneratePreviewOnly=false時,且成片輸出到VOD時必填 |
GeneratePreviewOnly | Boolean |
| false | 否,預設false |
Count | Integer | 輸出視頻數,當前支援Count=1,後續可能支援輸出多個視頻。 | 1 | 否,預設1 |
Width | Integer | 成片寬,px | 1080 | 是 |
Height | Integer | 成片高,px | 1920 | 是 |
JSONObject | 輸出視頻流相關配置,Crf、Codec等 | {"Crf": 27} | 否 |
參數樣本
{
"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/xxx_{index}.mp4",
"Count": 1,
"Width": 1080,
"Height": 1920,
"Video": {"Crf": 27},
"GeneratePreviewOnly":false
}SDK調用樣本
前提條件
您已安裝IMS服務端SDK,詳情請參見準備工作。
程式碼範例
API調用入參詳情
處理邏輯
根據SportsCategory判斷體育賽事類型:籃球-basketball、乒乓球-pingpong。
通過人物標識參數FaceRegister,來設定成片結果中需要出現的運動員鏡頭。
通過縮時攝影標識參數SlowMotionLogoRegister,來設定成片結果中需要包含的縮時攝影回放。
通過名稱轉寫設定參數TransferNameRegister,將記分牌中的隊名縮寫轉寫為完整隊名。