Tous les produits
Search
Centre de documentation

ApsaraVideo VOD:Fin du transcodage en définition unique

Dernière mise à jour :Aug 10, 2026

Cette rubrique décrit l'événement StreamTranscodeComplete et fournit des exemples de rappels.

Type d'événement

StreamTranscodeComplete

Description de l'événement

L'événement StreamTranscodeComplete est généré lorsqu'un flux vidéo est transcodé vers une définition et un format spécifiques, par exemple un flux SD au format MP4. Un flux vidéo dans une résolution unique peut être lu immédiatement après le transcodage du flux vidéo dans au moins un format.

Remarque

Si la signature d'URL est activée, vous devez générer une auth_key pour accéder à l'URL de lecture. Sinon, une erreur HTTP 403 est renvoyée. Pour plus d'informations sur la signature d'URL, consultez la rubrique Configurer la signature d'URL.

Contenu de l'événement

Nom du paramètre

Type

Obligatoire

Description

EventTime

String

Oui

Heure de génération de l'événement. L'heure suit la norme ISO 8601 au format yyyy-MM-ddThh:mm:ssZ. L'heure est affichée en UTC.

EventType

String

Oui

Type d'événement. Il s'agit d'un paramètre obligatoire. La valeur est fixée à StreamTranscodeComplete.

VideoId

String

Oui

ID de la vidéo.

Status

String

Oui

Statut de transcodage du flux vidéo.

  • success : Le traitement a réussi.

  • fail : L'opération a échoué.

Bitrate

String

Non

Débit binaire du flux vidéo. Unité : Kbit/s.

Definition

String

Non

Qualité du flux vidéo. Valeurs possibles :

  • FD : Basse définition

  • LD : Définition standard

  • HD : Haute définition.

  • HD : Ultra haute définition

  • OD : Qualité originale

  • 2K : 2K

  • 4K : 4K

  • AUTO : Flux à débit adaptatif

Duration

Double

Non

Durée du flux vidéo. Unité : secondes.

Encrypt

Boolean

Non

Indique si le flux vidéo est chiffré.

ErrorCode

String

Non

Code d'erreur. Ce paramètre est renvoyé si une erreur se produit lors du transcodage du flux vidéo.

ErrorMessage

String

Non

Message d'erreur. Ce paramètre est renvoyé si une erreur se produit lors du transcodage du flux vidéo.

FileUrl

String

Non

URL de lecture du flux vidéo. L'URL n'inclut pas la auth_key. Si vous avez activé la signature d'URL, vous devez générer la auth_key pour lire la vidéo en fonction de l'URL.

Format

String

Non

Format du flux vidéo.

  • mp4

  • m3u8

Fps

String

Non

Fréquence d'images du flux vidéo. Unité : FPS.

Height

Long

Non

Hauteur du flux vidéo. Unité : pixels.

Size

Long

Non

Taille du flux vidéo. Unité : octets.

Width

Long

Non

Largeur du flux vidéo. Unité : pixels.

JobId

String

Non

ID de la tâche de transcodage.

WatermarkId

String

Non

ID des filigranes. Plusieurs ID sont séparés par des virgules (,).

IsAudio

Boolean

Oui

Indique si le flux est un flux audio.

StartTime

String

Oui

Heure de début de la tâche. L'heure est affichée en UTC.

FinishTime

String

Oui

Heure de fin de la tâche. L'heure est affichée en UTC.

Extend

String

Non

Paramètre défini par l'utilisateur qui est renvoyé en mode pass-through. Pour plus d'informations, consultez la section Paramètres de requête.

Exemples de rappels

Voici un exemple de rappel :

  • Pour un rappel HTTP, l'exemple suivant correspond au corps du message de la requête HTTP POST.

  • Pour un rappel MNS, l'exemple suivant correspond au corps du message.

    { 
       "EventTime": "2017-03-20T07:49:17Z",
       "EventType": "StreamTranscodeComplete", 
       "VideoId": "43q9fj74hdf****", 
       "Status": "success",
       "Bitrate": "925",
       "Definition": "LD",
       "Duration": 15.0,
       "Encrypt": false,
       "FileUrl": "http://example.aliyundoc.com/DBEBDEAJS73J79BE4D****/52a53151eba5js73ke2da3b55bc5****.mp4",
       "Format": "mp4",
       "Fps": "30",
       "Height": 960,
       "Size": 1815321,
       "Width": 540,
       "JobId":"ddddddddddd",
       "WatermarkId": "33q9fj74hdf****,93q9fj74hdf****", 
       "IsAudio": false, 
       "StartTime": "2017-03-20T07:49:17Z",
       "FinishTime": "2017-03-20T09:49:17Z",
       "Extend":"test data"
    }