ApsaraVideo VOD:Types de données de base

Nom

Type

Description

JobId

String

L'ID de la tâche de téléchargement.

UploadURL

String

L'URL du fichier à télécharger.

MediaId

String

L'ID du fichier à télécharger.

FileSize

String

La taille du fichier à télécharger. Unité : octets.

Status

String

Le statut de la tâche de téléchargement basée sur une URL. Pour plus d'informations sur ce paramètre, consultez la section Status : le statut d'une tâche de téléchargement basée sur une URL.

CreationTime

String

L'heure de création de la tâche.

CompleteTime

Long

L'heure de fin de la tâche.

UserData

String

Un champ défini par l'utilisateur.

ErrorCode

String

Code d'erreur

ErrorMessage

String

Message d'erreur.

Valeur

Description

PENDING

La tâche de téléchargement est soumise et en attente de traitement.

PROCESSING

Vous pouvez commencer à traiter la tâche.

DOWNLOADING

Le fichier est en cours de téléchargement.

DOWNLOAD_SUCCESS

Le fichier est téléchargé.

DOWNLOAD_FAIL

Le téléchargement du fichier a échoué.

UPLOADING

Le fichier est en cours de téléchargement.

UPLOAD_SUCCESS

Le fichier est téléchargé.

UPLOAD_FAIL

Le téléchargement du fichier a échoué.

SUCCESS

La tâche de téléchargement est réussie et le rappel est terminé.

Nom

Type

Description

VideoId

String

L'ID de la vidéo.

FileName

String

Le nom du fichier.

Duration

String

La durée du fichier en secondes.

Status

String

L'état du fichier source. Pour plus d'informations, consultez Status : état d'un fichier source audio ou vidéo.

CreationTime

String

L'heure de création du fichier. L'heure est exprimée en UTC.

Height

Long

La hauteur du fichier en pixels (px).

Width

Long

La largeur du fichier en pixels (px).

Fps

String

La fréquence d'images du fichier en images par seconde (fps).

FileURL

String

L'URL du fichier.

Bitrate

String

Le débit binaire du fichier en Kbps.

Size

Long

La taille du fichier en octets.

OutputType

String

Le type du fichier de sortie. Valeurs valides :

• oss : l'URL du serveur d'origine.

• cdn : l'URL accélérée.

VideoStreamList

VideoStream[]

Une liste d'informations sur les flux vidéo.

AudioStreamList

AudioStream[]

Une liste d'informations sur les flux audio.

Nom

Type

Description

Index

String

Le numéro ordinal du flux vidéo. Cela identifie la position du flux vidéo dans le flux multimédia.

CodecName

String

Le nom court du format d'encodage.

CodecLongName

String

Le nom long du format d'encodage.

Profile

String

Le profil du codec.

CodecTimeBase

String

La base de temps du codec.

CodecTagString

String

Le texte du tag du format d'encodage.

CodecTag

String

Le tag du format d'encodage.

Width

Long

La largeur de la résolution vidéo.

Height

Long

La hauteur de la résolution vidéo.

HasBFrames

String

Indique si le flux contient des images B.

Sar

String

Le rapport d'aspect de l'échantillonnage du signal encodé.

Dar

String

Le rapport d'aspect à l'affichage (DAR).

PixFmt

String

Le format de pixel.

Level

String

Le niveau d'encodage.

Fps

String

La fréquence d'images cible.

AvgFPS

String

La fréquence d'images moyenne.

Timebase

String

La base de temps.

StartTime

String

L'heure de début.

Duration

String

La durée.

NumFrames

String

Le nombre total d'images.

Lang

String

La langue.

Rotate

String

L'angle de rotation de la vidéo. La valeur doit être comprise dans l'intervalle [0, 360).

Nom

Type

Description

Index

String

Le numéro ordinal du flux audio. Cela identifie la position du flux audio dans le flux multimédia.

CodecName

String

Le nom court du format d'encodage.

CodecLongName

String

Le nom long du format d'encodage.

CodecTimeBase

String

La base de temps du codec.

CodecTagString

String

Le texte du tag du format d'encodage.

CodecTag

String

Le tag du format d'encodage.

SampleFmt

String

Le format d'échantillonnage.

SampleRate

String

La fréquence d'échantillonnage.

Channels

String

Le nombre de canaux audio.

ChannelLayout

String

La disposition des canaux audio.

Timebase

String

La base de temps.

StartTime

String

L'heure de début.

Duration

String

La durée.

Bitrate

String

Le débit binaire.

NumFrames

String

Le nombre total d'images.

Lang

String

La langue.

Valeur

Description

Remarques

Uploading

Téléchargement en cours

L'état initial du fichier. Cela indique que le fichier est en cours de téléchargement.

Normal

Normal

Le fichier a été téléchargé avec succès.

UploadFail

Échec

Le téléchargement du fichier a échoué.

Deleted

Supprimé

Le fichier a été supprimé.

Nom

Type

Description

FileURL

String

L'URL OSS de l'image.

OriginalFileName

String

Le nom du fichier téléchargé.

FileSize

Long

La taille du fichier en octets.

Width

Integer

La largeur de l'image en pixels (px).

Height

Integer

La hauteur de l'image en pixels (px).

Nom

Type

Description

MediaId

String

L'ID de l'actif multimédia.

CreationTime

String

L'heure de création de l'actif multimédia. L'heure doit être exprimée en UTC.

MediaType

String

Le type de l'actif multimédia. Valeurs valides :

• video : vidéo

• audio : audio

• Image : une image.

• attached : actif multimédia auxiliaire

Video

Video

Les informations sur la vidéo.

Audio

Audio

Les informations sur l'audio.

Image

Image

Les informations sur l'image.

AttachedMedia

AttachedMedia

Les informations sur l'actif multimédia auxiliaire.

Name

Type

Description

VideoId

String

ID de la vidéo.

Title

String

Titre de la vidéo.

Duration

String

Durée de la vidéo, en secondes.

CoverURL

String

Miniature de la vidéo.

Status

String

État du fichier vidéo ou audio.

CreationTime

String

Date de création du fichier vidéo ou audio, au format UTC.

MediaType

MediaType

Type de fichier multimédia. Valeurs possibles :

• Vidéo.

• audio : fichier audio uniquement.

Name

Type

Description

Bitrate

String

Débit binaire du flux multimédia, en Kbps.

Definition

String

Définition du flux multimédia. Valeurs possibles :

• FD : basse définition

• LD : définition standard

• SD : haute définition

• HD (High Definition).

• OD : qualité originale

• 2K : 2K

• 4K : 4K

Specification

String

Spécifications de sortie pour le transcodage vidéo et audio. Pour plus d'informations, consultez la rubrique Spécifications de sortie.

Duration

String

Durée du flux multimédia, en secondes.

Encrypt

Long

Indique si le flux multimédia est chiffré. Valeurs possibles :

• 0 : Non.

• 1 : Oui.

EncryptType

String

Type de chiffrement du flux multimédia. Valeurs possibles :

• AliyunVoDEncryption : chiffrement vidéo Alibaba Cloud (chiffrement privé).

• HLSEncryption : chiffrement HLS.

PlayURL

String

URL de lecture du flux multimédia.

Format

String

Format du flux multimédia.

Si le fichier multimédia est une vidéo, les valeurs possibles sont :

• mp4

• m3u8

Si le fichier multimédia est un fichier audio uniquement, la valeur possible est mp3.

Fps

String

Fréquence d'images du flux multimédia, en images par seconde (fps).

Size

Long

Taille du flux multimédia, en octets.

Width

Long

Largeur du flux multimédia, en pixels (px).

Height

Long

Hauteur du flux multimédia, en pixels (px).

StreamType

String

Type de flux multimédia.

• Si le flux multimédia est une vidéo, la valeur est video.

• Si le flux multimédia est un fichier audio uniquement, la valeur est audio.

JobId

String

ID de la tâche de transcodage du flux multimédia. Cet ID sert d'identifiant unique pour le flux.

WatermarkId

String

ID du filigrane associé au flux multimédia.

Status

String

État du flux multimédia. Valeurs possibles :

• Normal : état du dernier flux transcodé terminé pour chaque définition et format.

• Invisible : état des flux redondants. Lorsque plusieurs flux sont transcodés pour la même définition et le même format, le flux le plus récent est marqué comme Normal et les autres comme Invisible.

NarrowBandType

String

Type de Narrowband HD. Valeurs possibles :

• 0 : standard

• 1.0 : Narrowband HD 1.0

• 2.0 : Narrowband HD 2.0

Ce paramètre prend effet uniquement lorsqu'une définition issue du modèle de transcodage Narrowband HD 1.0 intégré est configurée. Pour plus d'informations, consultez la rubrique TranscodeTemplate : Configurations du modèle de transcodage.

CreationTime

String

Date de création du flux, au format UTC.

ModificationTime

String

Date de dernière mise à jour du flux, au format UTC.

Name

Type

Description

VideoId

String

ID de la vidéo.

Title

String

Titre de la vidéo.

Duration

Float

Durée de la vidéo, en secondes.

CoverURL

String

Miniature de la vidéo.

Status

String

État de la vidéo.

Name

Type

Description

CateId

Long

ID de la catégorie.

CateName

String

Nom de la catégorie. La valeur peut comporter jusqu'à 64 octets et doit être encodée au format UTF-8.

ParentId

Long

ID de la catégorie parente. L'ID de la catégorie parente d'une catégorie de niveau 1 est -1.

Level

Long

Niveau de la catégorie. Une valeur de 0 indique une catégorie de niveau 1.

Name

Type

Description

StreamName

String

Nom du flux en direct.

DomainName

String

Nom de domaine.

AppName

String

Nom de l'application.

PlaylistId

String

ID de la liste de lecture.

RecordStartTime

String

Heure de début de l'enregistrement.

RecordEndTime

String

Heure de fin de l'enregistrement.

Video

Video

Informations sur la vidéo.

Nom

Type

Description

ProjectId

String

ID du projet d'édition en ligne.

Title

String

Titre du projet d'édition en ligne.

CreationTime

String

Date de création du projet d'édition en ligne. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et est affichée en UTC.

Par exemple, la valeur 2017-01-11T12:00:00Z correspond au 11 janvier 2017 à 20:00:00 (heure de Pékin, UTC+8).

ModifiedTime

String

Dernière date de modification du projet d'édition en ligne. L'heure est exprimée en UTC, au format yyyy-MM-ddTHH:mm:ssZ.

Par exemple, 2017-01-11T12:00:00Z (correspondant au 11 janvier 2017 à 20:00:00, UTC+8).

Status

String

Statut du projet d'édition en ligne.

Description

String

Description du projet d'édition en ligne.

Timeline

String

Chronologie du projet d'édition en ligne. La valeur est une chaîne JSON.

Duration

String

Durée totale du projet d'édition en ligne. Elle doit correspondre à la durée totale de la chronologie.

CoverURL

String

URL de la vignette du projet d'édition en ligne.

Valeur

Description

Remarques

Normal

Brouillon

Il s'agit du statut initial d'un projet d'édition en ligne.

Producing

Rendu en cours

Aucune.

Produced

La production vidéo a réussi.

Aucune.

ProduceFailed

Échec de la synthèse.

Aucune.

Nom

Type

Description

MaterialId

String

ID de la ressource.

Title

String

Titre de la ressource.

Description

String

Description de la ressource.

Duration

Float

Durée de la ressource en secondes. La valeur est précise à quatre décimales.

CoverURL

String

URL de la vignette de la ressource.

Status

String

Statut de la ressource.

CreationTime

String

Date de création de la ressource. L'heure est affichée en UTC.

Size

Long

Taille du fichier source en octets.

CateId

Long

ID de la catégorie de la ressource.

CateName

String

Nom de la catégorie de la ressource.

Tags

String

Tags associés à la ressource. Séparez plusieurs tags par une virgule (,).

Snapshots

String[]

Tableau des URL des instantanés de la ressource.

Sprites

String[]

Tableau des URL des sprites de la ressource.

Nom

Type

Description

TemplateGroupId

String

ID du groupe de modèles de transcodage utilisé pour transcoder les fichiers vidéo produits. Les vidéos produites servent de fichiers sources pour le transcodage. Ce processus est similaire au transcodage qui s'exécute après le téléchargement d'un fichier.

Ce champ est facultatif. S'il est vide, le groupe de modèles par défaut des paramètres de transcodage est utilisé. S'il est spécifié, le groupe de modèles indiqué est utilisé. Pour afficher l'ID du groupe de modèles, accédez à Paramètres de transcodage dans la console ApsaraVideo VOD.

TemplateId

String

ID du modèle de composition utilisé pour la composition vidéo afin de générer des fichiers sources pour les ressources multimédias. Ce champ est facultatif. Si la valeur est vide, le modèle d'édition en ligne intégré est utilisé pour la composition.

Si la cible de composition est un fichier vidéo, le format d'encodage du modèle intégré est H.264 et le format de conteneur est MP4.

Si vous avez d'autres exigences pour spécifier les paramètres de composition (tels que la composition d'images animées, le sous-titrage intelligent, l'édition rapide M3U8 ou la prise en charge de paramètres de composition personnalisés), soumettez un ticket pour faire une demande.

Width

Integer

Largeur de la vidéo de sortie, en pixels.

Ce paramètre est facultatif. Par défaut, la résolution de la vidéo de sortie est définie à l'aide de la largeur maximale et de la hauteur maximale de tous les fichiers sources de la chronologie.

Par exemple, si une chronologie contient trois fichiers sources avec des résolutions de 1280 × 720 pixels, 1920 × 1080 pixels et 720 × 1280 pixels, la résolution de la vidéo de sortie est de 1920 × 1280 pixels.

Height

Integer

Hauteur de la vidéo de sortie, en pixels.

Ce paramètre est facultatif. Par défaut, la résolution de sortie est définie à l'aide de la largeur maximale et de la hauteur maximale de tous les fichiers sources de la chronologie.

Par exemple, si une chronologie utilise trois fichiers sources avec des résolutions de 1280×720, 1920×1080 et 720×1280, la résolution de la vidéo de sortie est de 1920×1280.

Bitrate

Integer

Débit binaire de la vidéo produite. Unité : Kbit/s.

Ce paramètre est facultatif. La valeur par défaut est le débit binaire maximal des fichiers sources que vous avez spécifiés dans la chronologie.

Par exemple, vous spécifiez trois ressources pour la chronologie et les débits binaires des fichiers sources sont de 400, 600 et 800 Kbit/s. Dans ce cas, le débit binaire par défaut de la vidéo produite est de 800 Kbit/s.

StorageLocation

String

Adresse de stockage du fichier. Ce paramètre est requis pour les régions autres que Chine (Shanghai).

Nom

Type

Description

Title

String

Titre de la vidéo produite. La valeur peut atteindre 128 octets et doit être encodée en UTF-8.

Description

String

Description de la vidéo produite. La valeur peut atteindre 1 024 octets et doit être encodée en UTF-8.

CoverURL

String

URL de la vignette personnalisée pour la vidéo produite.

CateId

String

ID de catégorie de la vidéo produite. Connectez-vous à la console ApsaraVideo VOD. Dans le volet de navigation de gauche, choisissez Configuration Management > Media Management > Categories.

Tags

String

Tags de la vidéo produite. Chaque nom de tag peut atteindre 32 octets. Vous pouvez spécifier un maximum de 16 tags. Séparez plusieurs tags par des virgules (,). La chaîne doit être encodée au format UTF-8.

Nom

Type

Description

JobId

String

ID de la tâche.

Nom

Type

Description

Name

String

Nom du modèle.

VodTemplateId

String

ID du modèle.

TemplateType

String

Type de modèle. Valeurs valides :

• Snapshot : un instantané.

• DynamicImage : une image dynamique.

IsDefault

String

Indique s'il s'agit du filigrane par défaut. Valeurs valides :

• Default : le filigrane est celui par défaut.

• NotDefault : le filigrane n'est pas celui par défaut.

TemplateConfig

JSON

Configuration détaillée du modèle. La valeur est une chaîne JSON.

• Pour plus d'informations sur la configuration des instantanés, consultez SnapshotTemplateConfig.

• Pour la configuration DynamicImage, consultez DynamicImageTemplateConfig.

CreationTime

String

Date de création du modèle. L'heure est au format UTC.

ModifyTime

String

Dernière date de modification du modèle. L'heure est au format UTC.

Nom

Type

Description

JobId

String

ID de la tâche d'instantané.

CreationTime

String

Date de création de la tâche d'instantané. L'heure est en UTC.

Total

Long

Nombre total d'instantanés.

Regular

String

Règle de génération des URL d'instantanés.

Snapshots

Snapshot[]

Données de l'instantané.

Nom

Type

Description

Index

String

Valeur d'index de l'instantané.

Url

String

URL de l'instantané.

Nom

Type

Description

VideoId

String

ID de la vidéo.

DynamicImageId

String

ID de l'image dynamique.

FileURL

String

URL du fichier d'image dynamique.

Width

String

Largeur de l'image dynamique.

Height

String

Hauteur de l'image dynamique.

Duration

String

Durée de l'image dynamique.

Format

String

Format de l'image dynamique. Les valeurs valides sont gif ou webp.

FileSize

String

Taille du fichier d'image dynamique.

Fps

String

Fréquence d'images de l'image dynamique.

Nom

Type

Obligatoire

Description

CreationTime

String

Oui

Date d'ajout du filigrane.

Name

String

Oui

Nom du filigrane.

IsDefault

String

Oui

Indique si le filigrane est celui par défaut. Valeurs valides :

• Default : filigrane par défaut.

• NotDefault : filigrane non par défaut.

Type

String

Oui

Type de filigrane. Valeurs valides :

• Image : une image.

• Text : texte.

WatermarkId

String

Oui

ID du filigrane.

FileUrl

String

Non

URL OSS ou CDN du fichier de filigrane. Ce paramètre ne s'applique pas aux filigranes textuels.

WatermarkConfig

WatermarkConfig

Oui

Configurations de la position et de l'effet du filigrane textuel ou image. La valeur doit être une chaîne JSON.

Nom

Type

Obligatoire

Description

VideoTracks

VideoTrack[]

Non. Si VideoTracks est vide, AudioTracks ne doit pas être vide.

Liste des pistes vidéo. L'ordre d'empilement de plusieurs pistes suit l'ordre des éléments du tableau. Par exemple, le calque du premier élément du tableau apparaît en bas, celui du deuxième élément au-dessus, et ainsi de suite.

AudioTracks

AudioTrack[]

Non. Si AudioTracks est vide, VideoTracks ne doit pas être vide.

Liste des pistes audio.

SubtitleTracks

SubtitleTrack[]

Non

Liste des pistes de sous-titres.

EffectTracks

EffectTrack[]

Non

Liste des pistes d'effets.

Nom

Type

Obligatoire

Description

Type

String

Non

Valeur par défaut : piste vidéo standard.

Lorsque Type=Effect, la piste actuelle fonctionne comme une piste d'effet. Dans ce cas, VideoTrackClips peut contenir EffectTrackItem.

MainTrack

Boolean

Non

Indique si la piste actuelle est la piste principale. La valeur par défaut est False.

VideoTrackClips

VideoTrackClip[]

Oui

Liste des clips multimédias de la piste vidéo.

Nom

Type

Obligatoire

Description

MainTrack

Boolean

Non

Indique si la piste actuelle est la piste principale. La valeur par défaut est False.

AudioTrackClips

AudioTrackClip[]

Oui

Liste des clips multimédias de la piste audio.

Nom

Type

Obligatoire

Description

SubtitleTrackClips

SubtitleTrackClip[]

Oui

Liste des clips multimédias de la piste de sous-titres.

Nom

Type

Obligatoire

Description

EffectTrackItems

EffectTrackItem[]

Oui

Liste des éléments de la piste d'effets.

Nom

Type

Obligatoire

Description

MediaId

String

Non

ID du média du clip de la piste vidéo. Dans certains contextes, cela s'appelle également VideoId (pour la vidéo/audio) ou ImageId (pour les images).

Type

String

Non

Type de clip multimédia. La valeur par défaut est Video.

Valeurs valides :

• Video

• Image

• GlobalImage (image globale ; la durée correspond par défaut à la durée de la piste vidéo la plus longue.)

Exemple : Utiliser GlobalImage dans une piste vidéo

X

Float

Non

Distance horizontale entre le coin supérieur gauche de l'image ou de la vidéo et le coin supérieur gauche de la vidéo de sortie. Prend en charge les valeurs en pourcentage ou en pixels. Une valeur comprise entre [0–0,9999] représente un pourcentage de la largeur de la vidéo de sortie. Un entier ≥2 représente des pixels absolus.

Y

Float

Non

Distance verticale entre le coin supérieur gauche de l'image ou de la vidéo et le coin supérieur gauche de la vidéo de sortie. Prend en charge les valeurs en pourcentage ou en pixels. Une valeur comprise entre [0–0,9999] représente un pourcentage de la hauteur de la vidéo de sortie. Un entier ≥2 représente des pixels absolus.

Width

Float

Non

Largeur de l'image dans la vidéo de sortie. Prend en charge les valeurs en pourcentage ou en pixels. Une valeur comprise entre [0–0,9999] représente un pourcentage de la largeur de la vidéo de sortie. Un entier ≥2 représente des pixels absolus.

Height

Float

Non

Hauteur de l'image dans la vidéo de sortie. Prend en charge les valeurs en pourcentage ou en pixels. Une valeur comprise entre [0–0,9999] représente un pourcentage de la hauteur de la vidéo de sortie. Un entier ≥2 représente des pixels absolus.

AdaptMode

String

Non

Mode de mise à l'échelle de la vidéo. La valeur par défaut est Fill. Ce mode ne prend effet que lorsque Width et Height sont tous deux définis pour la piste vidéo. Dans ce cas, Width et Height définissent les dimensions de la zone cible, et la vidéo s'adapte de manière adaptative dans cette zone.

• Contain : met à l'échelle le contenu pour qu'il tienne dans la zone cible tout en conservant son rapport d'aspect.

• Cover : remplit toute la zone cible tout en conservant le rapport d'aspect. Le contenu peut être recadré si les rapports d'aspect ne correspondent pas.

• Fill : étire le contenu pour remplir exactement la zone cible. Le rapport d'aspect n'est pas conservé.

In

Float

Non

Heure de début du clip par rapport au média source. S'applique uniquement aux sources audio/vidéo. Unité : secondes, avec une précision de quatre décimales. La valeur par défaut est 0 si non spécifié.

Out

Float

Non

Heure de fin du clip par rapport au média source. S'applique uniquement aux sources audio/vidéo. Unité : secondes, avec une précision de quatre décimales. La valeur par défaut est la durée totale de la source si non spécifié.

MaxOut

Float

Non

Heure de fin maximale du clip par rapport au média source. Si défini, le point Out réel devient la plus petite valeur entre la durée de la source et MaxOut. S'applique uniquement aux sources audio/vidéo. Unité : secondes, avec une précision de quatre décimales. Si Out est spécifié, MaxOut est ignoré.

Exemple : Définir MaxOut dans une piste vidéo

Duration

Float

Non

Durée du clip. Généralement utilisé pour les sources d'images. Unité : secondes, avec une précision de quatre décimales.

DyncFrames

Int

Non

Fréquence d'images pour les images animées. S'applique uniquement lorsque la source est une image animée.

Exemple : Utiliser des autocollants GIF

TimelineIn

Float

Non

Heure de début du clip sur la timeline. Unité : secondes, avec une précision de quatre décimales. Si non spécifié, TimelineIn est calculé automatiquement en fonction du placement séquentiel.

TimelineOut

Float

Non

Heure de fin du clip sur la timeline. Unité : secondes, avec une précision de quatre décimales. Si non spécifié, TimelineOut est calculé automatiquement en fonction du placement séquentiel.

Speed

Float

Non

Vitesse de lecture du clip vidéo. Plage valide : 0,1–100. Par exemple, Speed=2 lit le clip à double vitesse, ce qui réduit de moitié sa Duration dans la sortie finale.

Exemple : Ajuster la vitesse audio/vidéo

MaskVideoUrl

String

Non

URL de la vidéo de masque. Il s'agit généralement d'une vidéo avec un canal alpha, utilisée pour ajouter des effets de transparence à la vidéo originale.

Seules les URL OSS publiques sont prises en charge.

Effects

Effect[]

Non

Liste des effets appliqués au clip.

Nom

Type

Obligatoire

Description

MediaId

String

Non

ID du média du clip de la piste audio.

In

Float

Non

Heure de début du clip par rapport au média source. Unité : secondes, avec une précision de quatre décimales. La valeur par défaut est 0 si non spécifié.

Out

Float

Non

Heure de fin du clip par rapport au média source. Unité : secondes, avec une précision de quatre décimales. La valeur par défaut est la durée totale de la source si non spécifié.

TimelineIn

Float

Non

Heure de début du clip sur la timeline. Unité : secondes, avec une précision de quatre décimales. Si non spécifié, TimelineIn est calculé automatiquement en fonction du placement séquentiel.

TimelineOut

Float

Non

Heure de fin du clip sur la timeline. Unité : secondes, avec une précision de quatre décimales. Si non spécifié, TimelineOut est calculé automatiquement en fonction du placement séquentiel.

Speed

Float

Non

Vitesse de lecture du clip audio. Plage valide : 0,1–100. Par exemple, Speed=2 lit le clip à double vitesse, ce qui réduit de moitié sa Duration dans la sortie finale.

Exemple : Ajuster la vitesse audio/vidéo

Effects

Effect[]

Non

Liste des effets appliqués au clip.

LoopMode

Boolean

Non

Comportement de lecture en boucle pour le clip sur la timeline. True active la lecture en boucle. False (valeur par défaut) désactive la boucle.

Exemple : Lecture en boucle audio

Name

Type

Required

Description

Type

String

Yes

Type de média du sous-titre. Valeurs valides :

• Subtitle : fichier de sous-titres externe

• Text : texte de bannière

SubType

String

No

Sous-type de média du sous-titre. Valeurs valides :

• srt : sous-titre SRT externe

• ass : sous-titre ASS externe

Ignorez ce champ lorsque Type est défini sur Text.

FileURL

String

No

URL OSS du fichier de sous-titres. Obligatoire lorsque Type est défini sur Subtitle. Format :

https://your-bucket.oss-cn-shanghai.aliyuncs.com/your-object.srt

Exemple : Modifier directement à l'aide d'un fichier de sous-titres

X

Float

No

Lorsque Type est défini sur Text, distance horizontale entre le coin supérieur gauche du texte et le coin supérieur gauche de la vidéo de sortie. Prend en charge les valeurs en pourcentage ou en pixels. Une valeur comprise entre [0–0,9999] représente un pourcentage de la largeur de la vidéo de sortie. Un entier ≥2 représente des pixels absolus.

Y

Float

No

Lorsque Type est défini sur Text, distance verticale entre le coin supérieur gauche du texte et le coin supérieur gauche de la vidéo de sortie. Prend en charge les valeurs en pourcentage ou en pixels. Une valeur comprise entre [0–0,9999] représente un pourcentage de la hauteur de la vidéo de sortie. Un entier ≥2 représente des pixels absolus.

TimelineIn

Float

No

Lorsque Type est défini sur Text, heure de début du texte sur la timeline. Unité : secondes, avec une précision de quatre décimales. Si non spécifié, TimelineIn est calculé automatiquement en fonction du placement séquentiel.

TimelineOut

Float

No

Lorsque Type est défini sur Text, heure de fin du texte sur la timeline. Unité : secondes, avec une précision de quatre décimales. Si non spécifié, TimelineOut est calculé automatiquement en fonction du placement séquentiel.

Content

String

No

Lorsque Type est défini sur Text, obligatoire. Spécifie le contenu du texte.

Font

String

No

Lorsque Type est défini sur Text, spécifie la police. La valeur par défaut est SimSun. Pour la liste complète des polices prises en charge, consultez Liste des polices.

FontSize

Int

No

Lorsque le type de légende est un texte de bannière, spécifie la taille de la police.

FontColor

String

No

Lorsque Type est défini sur Text, spécifie la couleur de la police au format hexadécimal (# suivi de chiffres hexadécimaux). Exemple : #ffffff.

FontColorOpacity

String

No

Lorsque Type est défini sur Text, spécifie la transparence de la police. Plage valide : 0–1. La valeur par défaut est 1 (opaque). 0 signifie entièrement transparent.

FontFace

FontFace

No

Lorsque Type est défini sur Text, spécifie le style de police.

Spacing

Int

No

Lorsque Type est défini sur Text, spécifie l'espacement des caractères. Unité : pixels. La valeur par défaut est 0.

Angle

Float

No

Lorsque Type est défini sur Text, spécifie l'angle de rotation dans le sens inverse des aiguilles d'une montre. Unité : degrés. La valeur par défaut est 0.

BorderStyle

Int

No

Spécifie le style de bordure et d'ombre pour le texte de bannière. Valeurs valides : 1 ou 3. 1 = bordure + ombre. 3 = boîte d'arrière-plan opaque. La valeur par défaut est 1.

Outline

Int

No

Lorsque Type est défini sur Text, spécifie l'épaisseur du trait. Unité : pixels. La valeur par défaut est 0.

OutlineColour

String

No

Lorsque Type est défini sur Text, spécifie la couleur du trait au format hexadécimal (# suivi de chiffres hexadécimaux). Exemple : #ffffff.

Shadow

Int

No

Lorsque Type est défini sur Text, spécifie la profondeur de l'ombre. Unité : pixels. La valeur par défaut est 0.

BackColour

String

No

Lorsque Type est défini sur Text, spécifie la couleur de l'ombre au format hexadécimal (# suivi de chiffres hexadécimaux). Exemple : #ffffff.

Alignment

String

No

Lorsque Type est défini sur Text, spécifie l'alignement du texte. La valeur par défaut est TopLeft. Valeurs valides :

• TopLeft : coin supérieur gauche de la vidéo

• TopCenter : centre supérieur le long de l'axe vertical

• TopRight : coin supérieur droit de la vidéo

• CenterLeft : côté gauche de l'axe horizontal central de la vidéo

• CenterCenter : centre de la vidéo

• CenterRight : centre droit le long de l'axe horizontal

• BottomLeft : coin inférieur gauche de la vidéo

• BottomCenter : centre inférieur le long de l'axe vertical

• BottomRight : coin inférieur droit de la vidéo

AdaptMode

String

No

Spécifie comment le texte de bannière s'adapte lorsqu'il dépasse la largeur de la vidéo ou la valeur TextWidth spécifiée. Valeurs valides :

• AutoWrap : retour à la ligne automatique

• AutoScale : Auto Scaling

• AutoWrapAtSpaces : retour à la ligne uniquement aux espaces (idéal pour les sous-titres en anglais uniquement)

TextWidth

Integer

No

Largeur de la zone de texte du sous-titre. Prend effet uniquement lorsque AdaptMode est défini. Le retour à la ligne automatique ou la mise à l'échelle utilise cette largeur. Si non spécifié, la largeur de la vidéo est utilisée. Unité : pixels.

FontUrl

String

No

Lorsque Type est défini sur Text, prend en charge les fichiers de polices personnalisés depuis votre bucket OSS. Formats pris en charge : ttf, otf, woff. Exemple : https://your-bucket.oss-cn-shanghai.aliyuncs.com/example-font.ttf

EffectColorStyle

String

No

Lorsque Type est défini sur Text, spécifie le style de lettrage artistique.

Pour les styles et effets de lettrage artistique, consultez Exemples d'effets de lettrage artistique.

AaiMotionInEffect

String

No

Lorsque Type est défini sur Text, spécifie l'effet d'animation d'entrée.

Pour les types et exemples d'effets d'entrée, consultez Effets d'entrée.

AaiMotionIn

Float

No

Lorsque Type est défini sur Text, spécifie la durée de l'effet d'entrée. Unité : secondes, avec une précision de quatre décimales. La valeur par défaut est de 0,5 seconde si non spécifié. Si la durée totale du texte est inférieure à 0,5 seconde, la durée d'entrée est égale à la durée totale moins la durée de sortie.

AaiMotionOutEffect

String

No

Lorsque le type de sous-titre est une bannière, spécifie l'effet d'entrée pour le texte de bannière.

Pour les types et effets d'entrée des légendes, consultez Effets d'entrée.

AaiMotionOut

Float

No

Lorsque Type est défini sur Text, spécifie la durée de l'effet de sortie. Unité : secondes, avec une précision de quatre décimales. La valeur par défaut est de 0,5 seconde si non spécifié. Si la durée totale du texte est inférieure à 0,5 seconde, la durée de sortie est égale à la durée totale du texte.

AaiMotionLoopEffect

String

No

Lorsque Type est défini sur Text, spécifie l'effet d'animation en boucle. Ne peut pas être utilisé conjointement avec les effets d'entrée ou de sortie.

Pour les types et exemples d'effets en boucle, consultez Effets en boucle.

Ratio

Float

No

Lorsque Type est défini sur Text, spécifie la vitesse de lecture de l'effet en boucle. Précision de quatre décimales. La valeur par défaut est 1 si non spécifié. Les valeurs supérieures à 1 accélèrent la boucle. Les valeurs inférieures à 1 la ralentissent.

Name

Type

Required

Description

Type

String

Yes

Type d'élément de piste d'effet. Valeurs valides : VFX, Filter.

SubType

String

Yes

Sous-type d'élément de piste d'effet. Pour les types d'effets pris en charge et les exemples, consultez Exemples d'effets spéciaux et Exemples d'effets de filtre.

TimelineIn

Float

No

Heure de début de l'effet sur la timeline. Unité : secondes, avec une précision de quatre décimales. La valeur par défaut est 0 si non spécifié.

TimelineOut

Float

No

Heure de fin de l'effet sur la timeline. Unité : secondes, avec une précision de quatre décimales. La valeur par défaut est l'heure de fin de la vidéo si non spécifié.

Duration

Float

No

Durée de l'effet sur la timeline. Unité : secondes, avec une précision de quatre décimales. La valeur par défaut est la durée de la vidéo si non spécifié.

X

Float

No

S'applique uniquement lorsque SubType est mosaic_rect ou blur. Distance horizontale entre le coin supérieur gauche de la zone d'effet et le coin supérieur gauche de la vidéo de sortie.

Prend en charge les valeurs en pourcentage ou en pixels. Une valeur comprise entre [0–0,9999] représente un pourcentage de la largeur de la vidéo de sortie. Un entier ≥2 représente des pixels absolus.

Y

Float

No

S'applique uniquement lorsque SubType est mosaic_rect ou blur.

Distance verticale entre le coin supérieur gauche de la zone d'effet et le coin supérieur gauche de la vidéo de sortie. Prend en charge les valeurs en pourcentage ou en pixels. Une valeur comprise entre [0–0,9999] représente un pourcentage de la hauteur de la vidéo de sortie. Un entier ≥2 représente des pixels absolus.

Width

Float

No

S'applique uniquement lorsque SubType est mosaic_rect ou blur. Largeur de la zone d'effet dans la vidéo de sortie. Prend en charge les valeurs en pourcentage ou en pixels. Une valeur comprise entre [0–0,9999] représente un pourcentage de la largeur de la vidéo de sortie. Un entier ≥2 représente des pixels absolus.

Height

Float

No

S'applique uniquement lorsque SubType est mosaic_rect ou blur. Hauteur de la zone d'effet dans la vidéo de sortie. Prend en charge les valeurs en pourcentage ou en pixels. Une valeur comprise entre [0–0,9999] représente un pourcentage de la hauteur de la vidéo de sortie. Un entier ≥2 représente des pixels absolus.

Name

Type

Required

Description

Bold

Boolean

No

Gras.

Italic

Boolean

No

Italique.

Underline

Boolean

No

Souligné.

Name

Type

Required

Description

Type

String

Yes

Type d'effet. Valeurs valides :

• Text : texte de bannière pour les clips de piste vidéo.

• DeWatermark : suppression de filigrane pour les clips de piste vidéo.

• Crop : recadrage pour les clips de piste vidéo.

• Scale : mise à l'échelle pour les clips de piste vidéo.

• Pad : ajustement des clips de piste vidéo

• Background : paramètres d'arrière-plan pour les clips de piste vidéo.

• Transition : effets de transition pour les clips de piste vidéo.

• VFX : effets visuels pour les clips de piste vidéo.

• Filter : filtres pour les clips de piste vidéo.

• Volume : ajustement du volume pour les clips de piste audio.

• AFade : fondu entrant et sortant audio pour les clips de piste audio.

• Rotate : rotation pour les clips de piste vidéo.

• Clip : découpage aléatoire.

• Flip : retournement.

• KenBurns : effet Ken Burns (panoramique et zoom).

• Zoom : zoom.

SubType

String

No

Sous-type d'effet.

• Lorsque Type est Transition, spécifie le sous-type de transition. Pour les valeurs valides, consultez Exemples d'effets de transition.

• Lorsque Type est VFX, spécifie le sous-type d'effet visuel. Pour les valeurs valides, consultez Exemples d'effets spéciaux.

• Lorsque Type est Filter, spécifie le sous-type de filtre. Pour les valeurs valides, consultez Exemples d'effets de filtre.

Name

Type

Description

VideoId

String

L'ID de la vidéo.

PlayDuration

String

La durée de lecture en millisecondes.

Title

String

Le titre de la vidéo.

VV

String

Le nombre de vues vidéo.

UV

String

Nombre d'utilisateurs ayant lu le contenu.

Name

Type

Description

Date

String

La date au format yyyyMMdd.

Exemple : 20170120.

PlayDuration

String

La durée de lecture en millisecondes.

Title

String

Le titre de la vidéo.

VV

String

Le nombre de vues vidéo.

UV

String

Nombre d'utilisateurs ayant effectué une lecture.

PlayRange

String

La distribution de la durée de lecture.

Name

Type

Description

Date

String

La date au format yyyyMMdd.

Exemple : 20170120.

PlayDuration

String

La durée totale de lecture en millisecondes.

PlayRange

String

La distribution de la durée de lecture.

VV

VV

Le nombre total de vues vidéo.

UV

UV

Le nombre total d'utilisateurs ayant lu du contenu.

Name

Type

Description

Date

String

La date au format yyyyMMdd.

Exemple : 20170120.

AvgPlayDuration

String

La durée moyenne de lecture en millisecondes.

AvgPlayCount

String

Le nombre moyen de vues vidéo.

Name

Type

Description

Android

String

Le nombre total de vues vidéo depuis le lecteur pour Android.

iOS

String

Le nombre total de vues vidéo depuis le lecteur pour iOS.

Flash

String

Nombre total de sessions de lecture par le lecteur Flash.

HTML5

String

Le nombre total de vues vidéo depuis le lecteur pour HTML5.

Name

Type

Description

Android

String

Le nombre total de visiteurs uniques depuis le lecteur pour Android.

iOS

String

Nombre total d'utilisateurs ayant effectué une lecture sur le lecteur iOS.

Flash

String

Total des utilisateurs de lecture sur Flash Player

HTML5

String

Nombre total d'utilisateurs pour la lecture HTML5.

Name

Type

Description

JobId

String

ID de la tâche de transcodage.

Name

Type

Required

Description

Name

String

Yes

Nom du groupe de modèles.

TranscodeTemplateGroupId

String

Yes

ID du groupe de modèles de transcodage.

IsDefault

String

Yes

Indique s'il s'agit du groupe de modèles par défaut. Valeurs valides :

• Default : le groupe de modèles par défaut.

• NotDefault : un groupe de modèles non par défaut.

CreationTime

String

Yes

Date de création du groupe de modèles.

ModifyTime

String

Yes

Date de la dernière modification du groupe de modèles.

TranscodeTemplateList

TranscodeTemplate[]

Yes

Liste des configurations de modèles de transcodage.

Name

Type

Required

Description

Type

String

No

Type de modèle. Valeurs valides :

• Normal : modèle de transcodage standard.

  Vous ne pouvez pas définir le paramètre PackageSetting pour ce type de modèle.

• VideoPackage : modèle d'empaquetage de flux vidéo.

  Ce modèle transcode d'abord la vidéo, puis génère un flux à débit adaptatif. Vous devez configurer le paramètre PackageSetting.

• SubtitlePackage : modèle d'empaquetage de sous-titres.

  Ce type de modèle n'effectue pas de transcodage. Il intègre les informations de sous-titrage correspondantes dans les fichiers de sortie à débit adaptatif. Vous devez configurer le paramètre PackageSetting. Toutefois, ce type de modèle ne peut pas exister indépendamment dans un groupe de modèles. Vous devez le configurer conjointement avec un modèle VideoPackage, et un seul modèle de ce type est autorisé par groupe de modèles.

Valeur par défaut : Normal.

Video

Video

Yes

Configuration de transcodage pour le flux vidéo. La valeur doit être une chaîne JSON.

Audio

Audio

Yes

Configuration de transcodage pour le flux audio. La valeur doit être une chaîne JSON.

Definition

String

Yes

Définition d'un modèle de transcodage standard. Valeurs valides :

• LD : basse définition.

• SD : définition standard.

• HD : haute définition.

• FHD : ultra haute définition.

• OD : qualité originale. Cette valeur est utilisée pour la conversion de format de conteneur.

• 2K

• 4K

• SQ : qualité sonore standard.

• HQ : haute qualité sonore.

Définition d'un modèle de transcodage Narrowband HD 1.0. Valeurs valides :

• LD-NBV1 : basse définition.

• SD-NBV1 : définition standard.

• HD-NBV1 : haute définition.

• FHD-NBV1 : ultra haute définition.

• 2K-NBV1

• 4K-NBV

Container

Container

Yes

Format de conteneur utilisé pour encapsuler les flux audio et vidéo. La valeur doit être une chaîne JSON.

MuxConfig

MuxConfig

No

Configuration des segments pour le transcodage. Ce paramètre est obligatoire si le format de conteneur est HLS. La valeur doit être une chaîne JSON.

TransConfig

TransConfig

No

Configuration de transcodage conditionnel. Utilisez ce paramètre pour appliquer une logique de base basée sur le débit binaire et la résolution de la vidéo source avant de générer la vidéo transcoded. La valeur doit être une chaîne JSON.

TranscodeFileRegular

String

No

Chemin personnalisé pour le stockage des fichiers de sortie.

Exemple de configuration

{MediaId}/watermark-{PlayDefinition} : Lors du transcodage, ApsaraVideo VOD remplace {MediaId} par l'ID de la vidéo (par exemple, 8ff5cc93f6da4079a47a77bf71d) et {PlayDefinition} par la définition (par exemple, fd).

Exemple de sortie

8ff5cc93f6da4079a47a77bf71d/watermark-fd.mp4 (ApsaraVideo VOD ajoute automatiquement l'extension de fichier, telle que .mp4, .m3u8 ou .flv).

Clip

Clip

No

Configuration du recadrage vidéo. La valeur doit être une chaîne JSON.

Par exemple, définissez ce paramètre pour extraire 5 secondes de contenu d'une vidéo afin de générer une nouvelle vidéo.

Rotate

String

No

Angle de rotation de la vidéo. Valeurs valides : [0,360].

Par exemple, la définition de ce paramètre sur 180 inverse l'image vidéo.

EncryptSetting

EncryptSetting

No

Configuration de chiffrement pour le transcodage.

PackageSetting

PackageSetting

No

Configuration d'empaquetage. Seuls l'empaquetage HLS à débit adaptatif et l'empaquetage DASH sont pris en charge. La valeur doit être une chaîne JSON.

SubtitleList

SubtitleConfig

No

Configuration des sous-titres. La valeur doit être une chaîne JSON.

WatermarkIds

String[]

No

ID des filigranes associés. Vous pouvez associer jusqu'à quatre ID de filigrane. USER_DEFAULT_WATERMARK représente l'ID du filigrane par défaut.

TranscodeTemplateId

String

No

ID du modèle de transcodage. Vous devez spécifier ce paramètre lors de la modification d'un modèle.

TemplateName

String

No

Nom du modèle de transcodage. Vous devez spécifier ce paramètre lors de la création d'un modèle.

Name

Type

Required

Description

Codec

String

Yes

Format d'encodage vidéo : H.264 ou H.265.

Remove

String

Yes

Indique s'il faut supprimer le flux vidéo. Valeurs valides :

• true : supprime le flux vidéo du fichier de sortie.

• false : conserve le flux vidéo dans le fichier de sortie.

Valeur par défaut : false.

Bitrate

String

No

Débit binaire cible pour la vidéo de sortie. Si vous ne spécifiez pas ce paramètre, le débit binaire est calculé à l'aide du paramètre Crf. Unité : Kbps.

Valeurs valides : [10,50000].

Height

String

No

Hauteur de la vidéo de sortie. La valeur doit être un multiple de 2. Si vous ne spécifiez pas ce paramètre, la hauteur du fichier source est utilisée. Unité : pixels. Valeurs valides : [128,4096].

Width

String

No

Largeur de la vidéo de sortie. La valeur doit être un multiple de 2. Si vous ne spécifiez pas ce paramètre, la largeur du fichier source est utilisée. Unité : pixels. Valeurs valides : [128,4096].

Fps

String

No

Fréquence d'images de la vidéo de sortie. Si vous ne spécifiez pas ce paramètre, la fréquence d'images du fichier source est utilisée. Unité : FPS. Valeurs valides : (0,60].

Gop

String

No

Distance entre les images clés adjacentes. Unité : images. Valeurs valides : [1,100000].

LongShortMode

String

No

Active la rotation automatique de l'écran. La largeur de la vidéo de sortie correspond au côté long de la source (hauteur en mode portrait). La hauteur de la vidéo de sortie correspond au côté court de la source (largeur en mode portrait). Valeurs valides :

• true : activé.

• false : désactivé.

Valeur par défaut : true. Cette fonctionnalité fonctionne mieux pour les vidéos en mode portrait. Nous vous recommandons de l'activer.

Crf

String

No

Facteur de contrôle de la qualité du débit binaire. Si vous spécifiez ce paramètre, le paramètre Bitrate est ignoré. Une valeur plus élevée entraîne une qualité vidéo inférieure et une taille de fichier plus petite. Une valeur plus faible entraîne une qualité vidéo supérieure, une taille de fichier plus grande et un temps de transcodage plus long. Valeurs valides : [0,51].

Valeur par défaut : 26. Nous vous déconseillons de modifier cette valeur.

Profile

String

No

Profil d'encodage. Valeurs valides :

• baseline : adapté aux appareils mobiles.

• main : adapté aux appareils de définition standard.

• high : adapté aux appareils haute définition.

Valeur par défaut : high. Ce paramètre s'applique uniquement à l'encodage H.264.

Meilleures pratiques

Si vous prenez en charge plusieurs définitions, définissez la définition la plus basse sur baseline pour garantir la lecture sur les appareils bas de gamme. Définissez les autres définitions sur main ou high.

Preset

String

No

Algorithme vidéo prédéfini. Valeurs valides : veryfast, fast, medium, slow, slower.

Valeur par défaut : medium. Ce paramètre s'applique uniquement à l'encodage H.264. Nous vous déconseillons de modifier cette valeur.

ScanMode

String

No

Mode de balayage. Valeurs valides :

• interlaced : balayage entrelacé.

• progressive : balayage progressif.

Bufsize

String

No

Taille du tampon. Unité : Ko. Valeurs valides : [1000,128000].

Valeur par défaut : 6000.

Maxrate

String

No

Débit binaire vidéo maximal. Unité : Kbps. Valeurs valides : [1000,50000].

PixFmt

String

No

Format de pixel de la vidéo. Les formats standard tels que yuv420p et yuvj420p sont pris en charge.

Valeur par défaut : yuv420p ou le format de pixel d'origine.

Name

Type

Required

Description

Codec

String

Yes

Format d'encodage audio : AAC ou MP3.

Bitrate

String

Yes

Débit binaire cible pour l'audio de sortie. Unité : Kbps. Valeurs valides : [8,1000].

Remove

String

Yes

Indique s'il faut supprimer le flux audio. Valeurs valides :

• true : supprime le flux audio du fichier de sortie.

• false : conserve le flux audio dans le fichier de sortie.

Valeur par défaut : false.

Samplerate

String

Yes

Fréquence d'échantillonnage. Unité : Hz. Valeurs valides : 22050, 32000, 44100, 48000, 96000.

Valeur par défaut : 44100.

Si le format de conteneur est FLV et que le codec audio est MP3, la fréquence d'échantillonnage ne peut pas être 32000, 48000 ou 96000.

Si le codec audio est MP3, la fréquence d'échantillonnage ne peut pas être 96000.

Channels

String

No

Nombre de canaux audio. Valeur par défaut : 2.

• Si Codec est défini sur MP3, les valeurs valides sont 1 ou 2.

• Si Codec est défini sur AAC, les valeurs valides sont 1, 2, 4, 5, 6 ou 8.

Profile

String

No

Profil du codec audio. Si Codec est défini sur AAC, les valeurs valides incluent aac_low, aac_he, aac_he_v2, aac_ld et aac_eld.

Volume

Volume

No

Configuration du volume.

Name

Type

Required

Description

Format

String

Yes

Format de conteneur.

• Le transcodage vidéo prend en charge FLV, MP4 et HLS (M3U8+TS).

• Le transcodage audio prend en charge MP3 et MP4.

• Si le format de conteneur est FLV, le codec vidéo ne peut pas être défini sur H.265.

Name

Type

Required

Description

Segment

Segment

Yes

Objet JSON contenant les champs de configuration des segments.

Name

Type

Required

Description

Duration

String

Yes

Durée de chaque segment TS. La valeur doit être un entier. Valeurs valides : [1,60]. Unité : secondes.

Exemple : {"Duration":"10"}.

Name

Type

Required

Description

TransMode

String

No

Le mode de transcodage. Valeurs valides :

• onepass : mode débit moyen (ABR). L'encodage est plus rapide qu'en twopass. Alibaba Cloud utilise onepass par défaut.

• twopass : mode débit variable (VBR). L'encodeur effectue deux passes pour allouer le débit avec précision, ce qui génère des fichiers plus petits avec une qualité supérieure. Le mode twopass prend plus de temps que le mode onepass et ne convient pas aux scénarios sensibles à la latence, tels que la diffusion en direct ou la communication en temps réel. Si la vidéo d'entrée est fortement compressée, le mode twopass peut provoquer des artefacts de blocage.

• CBR : mode débit constant. Le fichier utilise le même débit tout au long de sa durée. Les fichiers CBR sont plus volumineux que les fichiers VBR ou ABR et n'offrent aucune amélioration significative de la qualité.

Valeur par défaut : onepass.

IsCheckReso

String

No

Vérifie la résolution de la vidéo source pour déterminer s'il faut utiliser la résolution source pour le transcodage. Valeurs valides :

• true : vérifie la résolution. Si la résolution de sortie dépasse la résolution source (en fonction de la largeur ou de la hauteur), la résolution de sortie est définie sur la résolution source.

• false : ignore la vérification.

Valeur par défaut : false.

IsCheckResoFail

String

No

Vérifie la résolution de la vidéo source pour déterminer si le transcodage échoue. Valeurs valides :

• true : vérifie la résolution. Si la résolution de sortie dépasse la résolution source (en fonction de la largeur ou de la hauteur), le transcodage échoue.

• false : ignore la vérification.

Valeur par défaut : false.

IsCheckVideoBitrate

String

No

Vérifie le débit binaire vidéo de la source pour déterminer s'il faut utiliser le débit source pour le transcodage. Valeurs valides :

• true : vérifie le débit. Si le débit de sortie dépasse le débit source, le débit de sortie est défini sur le débit source.

• false : ignore la vérification.

Valeur par défaut : false.

IsCheckVideoBitrateFail

String

No

Vérifie le débit binaire vidéo de la source pour déterminer si le transcodage échoue. Valeurs valides :

• true : vérifie le débit. Si le débit de sortie dépasse le débit source, le transcodage n'a pas lieu.

• false : ignore la vérification.

Valeur par défaut : false. Cette valeur est prioritaire sur IsCheckVideoBitrate.

IsCheckAudioBitrate

String

No

Vérifie le débit binaire audio de la source pour déterminer s'il faut utiliser le débit source pour le transcodage. Valeurs valides :

• true : vérifie le débit. Si le débit de sortie dépasse le débit source, le débit de sortie est défini sur le débit source.

• false : ignore la vérification.

Valeur par défaut : false.

IsCheckAudioBitrateFail

String

No

Vérifie le débit binaire audio de la source pour déterminer si le transcodage échoue. Valeurs valides :

• true : vérifie le débit. Si le débit de sortie dépasse le débit source, le transcodage n'a pas lieu.

• false : ignore la vérification.

Valeur par défaut : false. Cette valeur est prioritaire sur IsCheckAudioBitrate.

Name

Type

Required

Description

TimeSpan

TimeSpan

Yes

La configuration liée au temps pour le recadrage vidéo.

Name

Type

Required

Description

Seek

String

Yes

L'heure de début du clip vidéo.

• Format 1 : sssss[.SSS]. Valeurs valides : [0.000,86399.999].

  Exemple : 12000.55.

• Format 2 : hh:mm:ss[.SSS]. Valeurs valides : [00:00:00.000,23:59:59.999]. Exemple : 00:00:05.003.

Nous vous recommandons d'utiliser le format 1.

Duration

String

No

Durée du découpage vidéo.

• Format 1 : sssss[.SSS]. Valeurs valides : [0.000,86399.999].

  Exemple : 12000.55.

• Format 2 : hh:mm:ss[.SSS]. Valeurs valides : [00:00:00.000,23:59:59.999]. Exemple : 00:00:05.003.

Nous vous recommandons d'utiliser le format 1.

End

String

No

La durée du segment final à supprimer lors du découpage vidéo.

• Format 1 : sssss[.SSS]. Valeurs valides : [0.000,86399.999].

  Exemple : 12000.55.

• Format 2 : hh:mm:ss[.SSS]. Valeurs valides : [00:00:00.000,23:59:59.999]. Exemple : 00:00:05.003.

Nous vous recommandons d'utiliser le format 1.

Name

Type

Required

Description

EncryptType

String

Yes

Le type de chiffrement. Valeurs valides :

• AliyunVoDEncryption : chiffrement privé ou chiffrement standard HLS pour les vidéos M3U8 (HLS).

• AliyunVoDLicenseEncryption : chiffrement privé pour les vidéos MP4.

Name

Type

Required

Description

PackageType

String

Yes

Le type d'emballage. Valeur valide : HLSPackage (emballage adaptatif HLS).

PackageConfig

PackageConfig

No

La configuration de l'emballage. Vous devez spécifier ce paramètre pour un modèle VideoPackage.

SubtitleExtractConfigList

SubtitleExtractConfig[]

No

La configuration de l'emballage des sous-titres. Vous devez spécifier ce paramètre pour un modèle SubtitlePackage. Ne le spécifiez pas pour les autres types de modèles.

Name

Type

Required

Description

BandWidth

String

Yes

La bande passante maximale. Vous devez spécifier ce paramètre pour l'emballage HLS. Unité : bps.

Vous devez spécifier ce paramètre uniquement pour les modèles VideoPackage.

Name

Type

Required

Description

SubtitleUrlList

String[]

Yes

L'URL du fichier de sous-titres. Seules les URL HTTP OSS sont prises en charge. Les URL HTTP CDN et les URL HTTPS ne sont pas prises en charge.

Language

String

Yes

La langue du sous-titre. Par exemple, en-US. Consultez la RFC 5646 pour plus d'informations.

Format

String

Yes

Le format du fichier de sous-titres. Seuls les fichiers .vtt sont pris en charge. Par exemple : subtitle.vtt.

Name

String

Yes

Le nom d'affichage de la piste de sous-titres dans le lecteur. Par exemple : Chinese ou English.

Name

Type

Required

Description

SubtitleUrl

String

Yes

L'URL OSS du fichier de sous-titres. Les URL HTTPS et les noms de domaine CDN purs ne sont pas pris en charge. Formats de sous-titres pris en charge : srt et ass.

CharEncode

String

Yes

Le format d'encodage des caractères. Valeurs valides :

• auto : détection automatique.

• UTF-8

• GBK

• BIG5

Valeur par défaut : UTF-8.

Name

Type

Required

Description

Method

String

No

La méthode d'ajustement du volume. Valeurs valides : auto, dynamic, linear.

IntegratedLoudnessTarget

String

No

Le niveau de loudness cible. Valeurs valides : [-70,-5]. Requis si Method est défini sur dynamic.

Valeur par défaut : -6.

TruePeak

String

No

Le niveau de crête maximal. Valeurs valides : [-9,0]. Requis si Method est défini sur dynamic.

Valeur par défaut : -1.

LoudnessRangeTarget

String

No

La plage de loudness. Valeurs valides : [1,20]. Requis si Method est défini sur dynamic.

Valeur par défaut : 8.

Container

Audio Codecs

mp3

MP3

mp4

AAC

ogg

VORBIS, FLAC

flac

FLAC

Container

Video Codecs

Audio Codecs

flv

H.264

AAC, MP3

mp4

H.264, H.265

AAC, MP3

ts

H.264, H.265

AAC, MP3

m3u8

H.264, H.265

AAC, MP3

gif

GIF

Not supported

Video Codecs

H.264

H.265

GIF

Profile

Supported

×

×

Bitrate

Supported

Supported

×

Crf

Supported

Supported

×

Width

Supported

Supported

Supported

Height

Supported

Supported

√

Fps

Supported

Supported

Supported

Gop

Supported

Supported

×

Preset

√

×

×

ScanMode

Supported

Supported

Supported

Bufsize

Supported

Supported

×

Maxrate

√

✓

×

PixFmt

Supported

√

bgr8

Name

Type

Description

VideoId

String

L'ID de la vidéo.

TranscodeTemplateGroupId

String

L'ID du groupe de modèles de transcodage utilisé pour le transcodage.

TranscodeStatus

String

Le statut du transcodage. Valeurs valides :

• Processing : en cours.

• Partial : certains travaux de transcodage sont terminés.

• CompleteAllSucc : tous les travaux de transcodage ont réussi.

• CompleteAllFail : tous les travaux de transcodage ont échoué. Si la vidéo source présente des problèmes, aucun travail de transcodage ne démarre et la tâche entière échoue.

• CompletePartialSucc : tous les travaux de transcodage sont terminés, mais seuls certains ont réussi.

TranscodeJobInfoSummaryList

TranscodeJobInfoSummary[]

La liste des résumés des travaux de transcodage.

CreationTime

String

L'heure de création de la tâche de transcodage. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.

CompleteTime

String

L'heure de fin de la tâche de transcodage. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.

Name

Type

Description

TranscodeTemplateId

String

L'ID du modèle de transcodage utilisé.

Width

String

La largeur de la vidéo en sortie. Unité : pixels.

Height

String

La hauteur de la vidéo en sortie. Unité : pixels.

Duration

String

La durée de la vidéo en sortie. Unité : secondes.

Filesize

String

La taille du fichier vidéo en sortie. Unité : octets.

Bitrate

String

Le débit binaire moyen de la vidéo en sortie. Unité : Kbit/s.

Fps

String

La fréquence d'images de la vidéo en sortie. Unité : images par seconde.

Format

String

Le format de conteneur de la vidéo en sortie.

WatermarkIdList

String[]

La liste des ID de filigranes appliqués à la vidéo en sortie.

TranscodeProgress

Long

La progression du transcodage. Valeurs valides : [0 100].

TranscodeJobStatus

String

L'état de la tâche de transcodage. Valeurs valides :

• Transcoding : la tâche est en cours d'exécution.

• TranscodeSuccess : la tâche a abouti.

• TranscodeFail : le transcodage a échoué.

CreationTime

String

L'heure de création de la tâche de transcodage. L'heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et s'affiche en UTC.

CompleteTime

String

L'heure de fin de la tâche de transcodage. L'heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et s'affiche en UTC.

ErrorCode

String

Le code d'erreur renvoyé en cas d'échec de la tâche de transcodage.

ErrorMessage

String

Le message d'erreur renvoyé en cas d'échec de la tâche de transcodage.

Name

Type

Description

TranscodeTaskId

String

L'ID de la tâche de transcodage.

TranscodeTemplateGroupId

String

L'ID du groupe de modèles de transcodage utilisé pour le transcodage.

VideoId

String

L'ID de la vidéo.

TaskStatus

String

L'état de la tâche de transcodage. Valeurs valides :

• Processing : en cours.

• Partial : certaines tâches de transcodage sont terminées.

• CompleteAllSucc : toutes les tâches de transcodage ont été menées à bien avec succès.

• CompleteAllFail : toutes les tâches de transcodage ont échoué. Si la vidéo source présente des problèmes, aucune tâche de transcodage ne démarre et l'intégralité de la tâche échoue.

• CompletePartialSucc : toutes les tâches de transcodage sont terminées, mais seules certaines ont abouti.

CreationTime

String

L'heure de création de la tâche de transcodage. L'heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et s'affiche en UTC.

CompleteTime

String

L'heure de fin de la tâche de transcodage. L'heure respecte la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ et s'affiche en UTC.

Trigger

String

Le type de déclencheur. Valeurs valides :

• Auto : le transcodage est déclenché automatiquement après le téléchargement d'une vidéo.

• Manual : le transcodage est déclenché par l'appel de l'opération SubmitTranscodeJobs.

TranscodeJobInfoList

TranscodeJobInfo

Les informations relatives aux tâches de transcodage.

Name

Type

Description

TranscodeTaskId

String

L'ID de la tâche de transcodage.

TranscodeJobId

String

L'ID de la tâche de transcodage.

VideoId

String

L'ID de la vidéo.

TranscodeProgress

Long

La progression de la tâche de transcodage. Valeurs valides : [0 100].

TranscodeJobStatus

String

L'état de la tâche de transcodage. Valeurs valides :

• Transcoding : la tâche est en cours d'exécution.

• TranscodeSuccess : la tâche a abouti.

• TranscodeFail : la tâche a échoué.

Priority

String

La priorité de la tâche de transcodage.

Definition

String

La définition.

TranscodeTemplateId

String

L'ID du modèle de transcodage utilisé pour le transcodage.

CreationTime

String

L'heure de création de la tâche de transcodage.

CompleteTime

String

L'heure de fin de la tâche de transcodage.

InputFileUrl

String

L'URL OSS du fichier source.

OutputFile

OutputFile

Les informations relatives au fichier en sortie.

ErrorCode

String

Le code d'erreur renvoyé en cas d'échec de la tâche de transcodage.

ErrorMessage

String

Le message d'erreur renvoyé en cas d'échec de la tâche de transcodage.

Name

Type

Description

OutputFileUrl

String

L'URL OSS du fichier en sortie.

Format

String

Le format de conteneur du fichier en sortie.

Width

String

La largeur de la vidéo dans le fichier en sortie. Unité : pixels.

Height

String

La hauteur de la vidéo dans le fichier en sortie. Unité : pixels.

Duration

String

La durée du fichier en sortie. Unité : secondes.

Bitrate

String

Le débit binaire moyen du fichier en sortie. Unité : Kbit/s.

Fps

String

La fréquence d'images du fichier en sortie. Unité : images par seconde.

Filesize

Long

La taille du fichier en sortie. Unité : octets.

EncryptType

String

Le type de chiffrement utilisé pour le fichier en sortie. La valeur est une chaîne JSON.

WatermarkIdList

String

La liste des ID de filigranes appliqués au fichier en sortie.

VideoStreamList

String

La liste des flux vidéo. Pour plus d'informations, consultez VideoStream : informations sur le flux vidéo.

AudioStreamList

String

La liste des flux audio. Pour plus d'informations, consultez AudioStream : informations sur le flux audio.

Name

Type

Description

CallbackType

String

La méthode de rappel. Valeurs valides : HTTP et MNS.

CallbackURL

String

L'adresse webhook pour les rappels HTTP.

MnsEndpoint

String

Le point de terminaison public de la file d'attente MNS pour les rappels MNS.

MnsQueueName

String

Le nom de la file d'attente MNS pour les rappels MNS.

EventTypeList

String

Le type d'événement de rappel.

AuthSwitch

String

Le commutateur d'authentification pour les rappels HTTP. Valeurs valides :

• On : activé.

• off : désactivé.

AuthKey

String

La clé d'authentification pour les rappels HTTP.

Name

Type

Description

AppId

String

L'ID de l'application.

AppName

String

Le nom de l'application.

Description

String

La description de l'application.

Type

String

Le type d'application. Valeurs valides :

• Le système est défini par défaut.

• Custom : créé par l'utilisateur.

Status

String

L'état de l'application. Valeurs valides :

• Normal : normal.

• Disable : l'application est désactivée.