Video analysis complete event, notification content, and callback examples - ApsaraVideo VOD

Cette rubrique décrit l'événement VideoAnalysisComplete, son contenu de notification et des exemples de rappel.

Type d'événement

VideoAnalysisComplete

Description de l'événement

ApsaraVideo VOD analyse les fichiers source audio et vidéo après leur chargement. Cet événement est généré une fois l'analyse terminée.

Remarque

Par défaut, ApsaraVideo VOD analyse tous les fichiers audio et vidéo chargés. L'analyse est gratuite.
L'analyse extrait les métadonnées de base des fichiers source, telles que la durée, la résolution (largeur et hauteur), le débit binaire et la fréquence d'images.
Une fois l'analyse terminée, les métadonnées sont ajoutées à la bibliothèque de ressources multimédias. Appelez l'opération GetMezzanineInfo pour récupérer davantage de métadonnées sur le fichier source.

Contenu de la notification d'événement

Nom du paramètre	Type	Obligatoire	Description
EventTime	String	Oui	Heure de génération de l'événement. L'heure est au format UTC et suit le format yyyy-MM-ddTHH:mm:ssZ.
EventType	String	Oui	Type d'événement. Paramètre obligatoire. La valeur est fixée à VideoAnalysisComplete.
VideoId	String	Oui	ID du fichier audio ou vidéo.
Status	String	Oui	État de l'analyse du fichier source. success : l'opération a réussi. fail : l'opération a échoué.
Width	Long	Non	Largeur du fichier source. Ce champ n'est pas renvoyé pour les fichiers audio seuls.
Height	Long	Non	Hauteur du fichier source. Ce champ n'est pas renvoyé pour les fichiers audio seuls.
Duration	Float	Non	Durée du fichier source, en secondes.
Bitrate	String	Non	Débit binaire du fichier source, en Kbps.
Fps	String	Non	Fréquence d'images du fichier source, en images par seconde. Ce champ n'est pas renvoyé pour les fichiers audio seuls.
Size	Long	Non	Taille du fichier source, en octets.
ErrorCode	String	Non	Code d'erreur de la tâche. Ce champ est renvoyé lorsqu'une erreur se produit lors de l'analyse du fichier source.
ErrorMessage	String	Non	Message d'erreur de la tâche. Ce champ est renvoyé lorsqu'une erreur se produit lors de l'analyse du fichier source.

Remarque

Si Status est défini sur fail, l'analyse a échoué et les informations de base du fichier source ne sont pas renvoyées. Un échec est généralement dû à un encapsulation anormale du fichier source.

Exemples de rappel

Tenez compte des points suivants concernant les exemples de rappel :

Pour un rappel HTTP, le contenu suivant correspond au corps de la requête HTTP POST.
Pour un rappel MNS, le contenu suivant correspond au corps du message.

Exemple de rappel en cas de réussite de l'analyse :

{
    "VideoId":"84bd5b0566ddj39549986befd0e80****",
    "Duration":"12",
    "Height":"360",
    "Width":"630",
    "Fps":"30",
    "Bitrate":"499",
    "Size":"1234568",
    "EventTime":"2018-11-28T10:12:48Z",
    "EventType":"VideoAnalysisComplete",
    "Status":"success"
  }

Exemple de rappel en cas d'échec de l'analyse :

 {
    "VideoId":"84bd5b0566ddj39549986befd0e80****",
    "EventTime":"2018-11-28T10:12:48Z",
    "EventType":"VideoAnalysisComplete",
    "Status":"fail",
    "ErrorCode":"InvalidParameter.ResourceContentBad",
    "ErrorMessage":"The resource operated InputFile is bad"
  }