SubmitLiveEditingJob - - Centre de documentation Alibaba Cloud

Le montage en direct combine un ou plusieurs segments de flux en direct en un produit final. Après avoir soumis une tâche de montage en direct, la tâche entre dans une file d'attente en arrière-plan et est exécutée de manière asynchrone. Après la soumission, vous pouvez appeler l'opération GetLiveEditingJob pour consulter l'état de la tâche via jobId. Vous pouvez également appeler l'opération GetMediaInfo pour consulter les informations sur la ressource média générée via MediaId.

Description de l'opération

Il s'agit d'une opération asynchrone. Après avoir soumis une tâche, un identifiant de tâche est renvoyé (la tâche n'est pas encore terminée et entre dans une file d'attente en arrière-plan pour une exécution asynchrone). Le résultat final est délivré via une notification de rappel. Vous pouvez également consulter directement l'état de la tâche en appelant GetLiveEditingJob.
Le montage en direct est pris en charge pour les flux en direct enregistrés sur OSS et VOD. Lors du montage de plusieurs flux en direct, tous les flux doivent être enregistrés sur OSS ou tous les flux doivent être enregistrés sur VOD.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

ice:SubmitLiveEditingJob

*All Resource

*

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
Clips	string	Oui	La liste des segments de clip. La sortie est produite en concaténant les segments de la liste dans l'ordre. Tableau JSON. Chaque segment contient une heure de début et une heure de fin. Si aucun paramètre de flux en direct n'est spécifié, la configuration de flux en direct du niveau supérieur est utilisée. Les horodatages de début et de fin sont tous deux au format UTC. Pour plus de détails sur les paramètres, consultez la structure de données Clip ci-dessous.	[{\"StartTime\": \" 2021-06-21T08:01:00Z\", \"EndTime\": \" 2021-06-21T08:03:00Z\" , "AppName": "app", "DomainName": "domain.com", "StreamName": "stream"}, {\"StartTime\": \" 2021-06-21T08:05:00Z\", \"EndTime\": \" 2021-06-21T08:09:00Z\" }]
ProjectId	string	Non	L'identifiant du projet de montage en direct. Si ce paramètre n'est pas vide, la configuration de stockage associée au projet est utilisée. Si ce paramètre est vide, la configuration de stockage spécifiée dans les paramètres de la requête est utilisée.	**fddd7748b58bf1d47e95**
LiveStreamConfig	string	Non	La configuration du flux en direct. Objet JSON. Les éléments de configuration suivants sont requis : AppName : le nom de l'application à laquelle le flux appartient. DomainName : le nom de domaine. StreamName : le nom du flux en direct.	{ "AppName": "app", "DomainName": "domain.com", "StreamName": "stream" }
OutputMediaConfig	string	Non	La configuration de destination pour la sortie. Objet JSON. Vous pouvez spécifier l'URL de la sortie sur OSS ou l'emplacement de stockage dans un compartiment VOD. Pour une sortie vers OSS, le paramètre MediaURL de la destination de sortie est requis. Pour une sortie vers VOD, les paramètres StorageLocation et FileName sont requis.	{ "MediaURL": "https://ice-auto-test.oss-cn-shanghai.aliyuncs.com/testfile.mp4" }, ou { "StorageLocation": "bucket.oss-cn-shanghai.aliyuncs.com", "FileName": "output.mp4" }
MediaProduceConfig	string	Non	La configuration de composition pour la génération de segments, au format JSON. Mode spécifie le mode de montage. Valeurs valides : AccurateFast (par défaut) : montage précis rapide. Ce mode est plus rapide que le mode Accurate. La résolution du fichier de sortie est identique à celle du flux source. La largeur et la hauteur de sortie personnalisées ne sont pas prises en charge. Accurate : montage précis. Vous pouvez spécifier la largeur et la hauteur de sortie. Rough : montage grossier. La précision minimale est d'un segment TS. La sortie contient tous les segments dans les heures de début et de fin spécifiées. Vous pouvez spécifier la largeur et la hauteur de sortie. RoughFast : montage grossier rapide. Ce mode est plus rapide que le mode Accurate. La précision minimale est d'un segment TS. La sortie contient tous les segments dans les heures de début et de fin spécifiées. La résolution du fichier de sortie est identique à celle du flux source. La largeur et la hauteur de sortie personnalisées ne sont pas prises en charge.	{ "Mode": "AccurateFast"}
UserData	string	Non	Les paramètres personnalisés. Objet JSON. Longueur maximale : 512 octets.	{"key": "value"}
OutputMediaTarget	string	Non	Le type de cible de la sortie. Valeurs valides : oss-object : un objet OSS dans un compartiment OSS d'Alibaba Cloud. vod-media : une ressource média dans Alibaba Cloud VOD.	oss-object

Structure de données Clip

Propriété	Type	Exemple	Description	Obligatoire
StartTime	String	2021-06-21T08:01:00Z	L'heure de début du segment de clip, au format d'horodatage UTC.	Oui
EndTime	String	2021-06-21T08:05:00Z	L'heure de fin du segment de clip, au format d'horodatage UTC.	Oui
AppName	String	app	Le nom de l'application à laquelle le flux appartient. Si ce paramètre est vide, la configuration de flux en direct du niveau supérieur est utilisée.	Non
DomainName	String	domain.com	Le nom de domaine. Si ce paramètre est vide, la configuration de flux en direct du niveau supérieur est utilisée.	Non
StreamName	String	stream	Le nom du flux en direct. Si ce paramètre est vide, la configuration de flux en direct du niveau supérieur est utilisée.	Non
CoverTime	String	2021-06-21T08:03:00Z	Spécifie un horodatage dans le segment à utiliser comme image de couverture de la sortie, au format d'horodatage UTC. Lorsque plusieurs clips ont le paramètre CoverTime défini, seul le premier prend effet. CoverTime doit être supérieur ou égal à StartTime et inférieur ou égal à EndTime.	Non
CoverUrl	String	https://test.oss-ap-southeast-1.aliyuncs.com	L'URL de sortie de capture d'écran personnalisée. Le compartiment OSS doit se trouver dans la même région que la région d'accès au service. Seuls les compartiments OSS vous appartenant sont pris en charge. Les compartiments gérés par VOD ne sont pas pris en charge.	Non

Éléments de réponse

Élément	Type	Description	Exemple
	object	Schéma de la réponse.
RequestId	string	L'identifiant de la requête.	**36-3C1E-4417-BDB2-1E034F**
ProjectId	string	L'identifiant du projet de montage en direct.	**fddd7748b58bf1d47e95**
JobId	string	L'identifiant de la tâche de montage en direct.	**d80e4e4044975745c14b**
MediaId	string	L'identifiant de la ressource média de la sortie.	**c469e944b5a856828dc2**
MediaURL	string	L'URL de la sortie.	http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4
VodMediaId	string	L'identifiant de la ressource média VOD. Ce paramètre est renvoyé lorsque la destination de sortie vidéo est VOD.	**d7578s4h75ci945c14b**

Exemples

JSON format

{
  "RequestId": "****36-3C1E-4417-BDB2-1E034F****",
  "ProjectId": "****fddd7748b58bf1d47e95****",
  "JobId": "****d80e4e4044975745c14b****",
  "MediaId": "****c469e944b5a856828dc2****",
  "MediaURL": "http://test-bucket.cn-shanghai.aliyuncs.com/test.mp4",
  "VodMediaId": "****d7578s4h75ci945c14b****"
}

Codes d'erreur

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.