このドキュメントでは、スポーツイベントのハイライトシナリオにおけるインテリジェントな画像テキストマッチングビデオ制作のための合成パラメーターと SDK 呼び出しの例を紹介します。
注:このインターフェイスでは、すべてのメディアアセット OSS URL のリージョンは、OpenAPI サービスエンドポイントのリージョンと一致している必要があります。
サポートされているリージョン:中国 (上海)。
実際の使用では、ドキュメント内の [your-bucket]、[your-region-id]、[your-file-name]、[your-file-path]、メディアアセット ID (例: "****9d46c8b4548681030f6e****") などのすべてのパラメーター例を実際の値に置き換える必要があります。
このドキュメントをよりよく理解するために、まずインテリジェントワンクリックビデオ制作操作ガイドを通じて、「インテリジェント画像テキストマッチングビデオ制作 - スポーツイベントハイライト」の概念と使用フローについて学習することをお勧めします。
使用方法
完全なスポーツイベントビデオからのインテリジェント編集およびワンクリックバッチビデオ制作の API の説明については、「SubmitSportsHighlightsJob - スポーツハイライトタスクの送信」をご参照ください。主要な API パラメーターについては、以下の InputConfig パラメーターと OutputConfig パラメーターをご参照ください。
バッチインテリジェントワンクリックビデオ制作ジョブの詳細情報を取得するには、「GetBatchMediaProducingJob - バッチインテリジェントワンクリックビデオ制作タスク情報の取得」をご参照ください。
InputConfig パラメーター
InputConfig を構成して、ビデオ素材、ナレーション、BGM、ステッカーなどの基本素材のパラメーター構成を指定できます。
パラメーター | タイプ | 説明 | 値の例 | 必須 |
SportsCategory | String | スポーツイベントのタイプ バスケットボール: basketball 卓球: pingpong | basketball | はい |
InputMedia | String | 入力スポーツイベント素材。MediaId または MediaURL をサポートします
| ****9d46c8b4548681030f6e**** | はい |
FaceRegister | List<FaceInfo> | 人物 ID、配列の長さは 5 以下です。 | 「パラメーターの例」をご参照ください | いいえ |
SlowMotionLogoRegister | スローモーション識別子。最終的なビデオでスローモーションが必要な場合は、ソースビデオのスローモーションの前に表示されるロゴ識別情報を提供する必要があります。配列の長さは 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 | 人物の名前。入力ビデオのスコアボードに表示される名前と一致する必要があります | James | はい |
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": "Indiana Pacers"
}
]
}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 | ブール値 |
| false | いいえ、デフォルトは false です |
Count | 整数 | 出力ビデオの数。現在、Count=1 をサポートしています。将来的には複数の出力ビデオのサポートが追加される可能性があります。 | 1 | いいえ、デフォルトは 1 です |
Width | 整数 | ビデオの幅 (px) | 1080 | はい |
Height | 整数 | ビデオの高さ (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。
人物 ID パラメーター FaceRegister を使用して、最終的なビデオに表示するアスリートのショットを設定します。
スローモーション識別子パラメーター SlowMotionLogoRegister を使用して、最終的なビデオに含めるスローモーションリプレイを設定します。
名前転写パラメーター TransferNameRegister を使用して、スコアボードのチーム名の略称を完全なチーム名に変換します。