Utilisez ces paramètres et exemples de SDK pour générer des temps forts d'événements sportifs.
La région indiquée dans l'URL OSS doit correspondre à la région du point de terminaison du service API. Seule la région Chine (Shanghai) est prise en charge.
Consultez d'abord la rubrique Production vidéo par lot pour obtenir une vue d'ensemble des paramètres et du flux de travail.
Notes d'utilisation
Pour générer un clip de temps forts à partir d'une vidéo de match complète, appelez l'API SubmitSportsHighlightsJob. Les paramètres clés sont décrits dans les sections InputConfig et OutputConfig ci-dessous.
Pour obtenir les détails d'une tâche de génération de vidéo, appelez l'API GetBatchMediaProducingJob.
InputConfig
Spécifie les éléments sources et les options de traitement.
|
Paramètre |
Type |
Description |
Exemple |
Obligatoire |
|
SportsCategory |
String |
Type d'événement sportif. Valeurs valides :
|
basketball |
Oui |
|
InputMedia |
String |
Vidéo source. Spécifiez un ID de ressource multimédia ou une URL multimédia.
|
**9d46c8b4548681030f6e** |
Oui |
|
FaceRegister |
List<FaceInfo> |
Paramètres d'enregistrement des visages. Maximum 5 entrées. |
Non |
|
|
SlowMotionLogoRegister |
Logos précédant les scènes au ralenti dans la vidéo source. Requis pour inclure des plans au ralenti dans les temps forts. Maximum 5 entrées. |
Non |
||
|
TransferNameRegister |
List<TransferNameInfo> |
Associe les noms abrégés du tableau d'affichage aux noms complets des équipes ou des joueurs. Maximum 10 entrées. |
Oui |
FaceInfo
|
Champ |
Type |
Description |
Exemple |
Obligatoire |
|
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"] |
Oui |
|
Name |
String |
Nom de la personne. Doit correspondre au nom affiché sur le tableau d'affichage dans la vidéo d'entrée. |
John Doe |
Oui |
SlowMotionLogoRegister
|
Champ |
Type |
Description |
Exemple |
Obligatoire |
|
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"] |
Oui |
TransferNameInfo
|**Champ**
|
**Type**
|
**Description**
|
**Exemple**
|
**Obligatoire**
| | --- | --- | --- | --- | --- | |
OriginalName
|
String
|
Nom abrégé issu du tableau d'affichage.
|
Rockets
|
Oui
| |
TransferName
|
String
|
Nom complet.
|
Houston Rockets
|
Oui
|
Exemple de paramètre
{
"SportsCategory": "basketball",
"InputMedia": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name].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
Non pris en charge actuellement.
OutputConfig
Spécifie les paramètres de la vidéo de sortie : destination, nommage du fichier, dimensions et nombre de vidéos.
|
Paramètre |
Type |
Description |
Exemple |
Obligatoire |
|
MediaURL |
String |
URL de la vidéo de sortie. Doit inclure l'espace réservé |
Format : http://[your-bucket].oss-[your-region-id].aliyuncs.com/[your-file-path]/[your-file-name]_{index}.mp4 Exemple : http://example.oss-cn-shanghai.aliyuncs.com/example/example_{index}.mp4 |
Obligatoire lorsque GeneratePreviewOnly est défini sur false et que la destination de sortie est OSS. |
|
StorageLocation |
String |
Emplacement de stockage du fichier de sortie dans ApsaraVideo VOD. |
Format : [your-vod-bucket].oss-[your-region-id].aliyuncs.com Exemple : outin-**6c886b4549d481030f6e**.oss-cn-shanghai.aliyuncs.com |
Obligatoire lorsque GeneratePreviewOnly est défini sur false et que la destination de sortie est ApsaraVideo VOD. |
|
FileName |
String |
Nom du fichier de sortie. Doit contenir l'espace réservé {index}. |
Format : [your-file-name]_{index}.mp4 Exemple : example_{index}.mp4 |
Obligatoire lorsque GeneratePreviewOnly est défini sur false et que la destination de sortie est ApsaraVideo VOD. |
|
GeneratePreviewOnly |
Boolean |
|
false |
Non. La valeur par défaut est false. |
|
Count |
Integer |
Nombre de vidéos de sortie. Actuellement, seule la valeur 1 est prise en charge. |
1 |
Non. La valeur par défaut est 1. |
|
Width |
Integer |
Largeur de la vidéo de sortie, en pixels. |
1080 |
Oui |
|
Height |
Integer |
Hauteur de la vidéo de sortie, en pixels. |
1920 |
Oui |
|
JSONObject |
Paramètres du flux vidéo de sortie, tels que CRF et le codec. |
{"Crf": 27} |
Non |
Exemple de paramètre
{
"MediaURL": "http://[your-bucket].oss-[your-region-id].aliyuncs.com/xxx_{index}.mp4",
"Count": 1,
"Width": 1080,
"Height": 1920,
"Video": {"Crf": 27},
"GeneratePreviewOnly": false
}
Exemple de SDK
Prérequis
Le SDK côté serveur d'IMS est installé. Pour plus d'informations, consultez la rubrique Premiers pas.
Exemple de code
Paramètres de la requête API
Logique de traitement
SportsCategorydétermine le type d'événement :basketballoupingpong.FaceRegisteridentifie les plans des athlètes spécifiés pour les temps forts.SlowMotionLogoRegisterfournit les logos permettant de détecter les rediffusions au ralenti dans la vidéo source.TransferNameRegisterassocie les noms abrégés du tableau d'affichage aux noms complets des équipes.
Référence API
Pour soumettre une tâche de temps forts sportifs, consultez la rubrique SubmitSportsHighlightsJob.
Pour récupérer les détails d'une tâche de production vidéo par lot, consultez la rubrique GetBatchMediaProducingJob.
Pour vous préparer à l'utilisation du SDK côté serveur, consultez la rubrique Premiers pas.
Pour soumettre une tâche de montage et de production multimédia, consultez la rubrique SubmitMediaProducingJob.