ApsaraVideo Media Processing:Activités de workflow

Nom de l'activité

Type d'activité dans la topologie

Description

Entrée

Start

Obligatoire. Configure le chemin d'accès à l'entrée Object Storage Service (OSS) ainsi que les paramètres globaux, notamment la file d'attente MPS et les notifications de messages.

Publication

Report

Obligatoire. Définit le mode de publication. Deux modes sont pris en charge : automatique et manuel.

Analyse

Analysis

Analyse intelligemment les fichiers multimédias d'entrée et recommande des modèles prédéfinis adaptés à ces fichiers.

Encodage

Transcode

Convertit les fichiers multimédias d'entrée vers différents formats afin qu'ils puissent être lus sur diverses plateformes.

Capture d'écran

Screenshot

Capture des instantanés vidéo à des moments précis. Vous pouvez utiliser un instantané comme miniature ou générer une image composite (sprite) à partir de plusieurs instantanés.

Pack

PackageConfig

Regroupe les fichiers vidéo multirésolution, multipistes audio et multisous-titres pour générer des fichiers M3U8.

Groupe vidéo

VideoGroup

Groupe audio

AudioGroup

Groupe de sous-titres

SubtitleGroup

Extraire la vidéo

Extraire l'audio

Extraire les sous-titres

Transcode

Générer

GenerateMasterPlayList

Modération du contenu

Censor

Détecte les contenus pornographiques, terroristes et indésirables présents dans les discours, les textes et les scènes d'une vidéo. Cette fonctionnalité réduit les coûts liés à la révision manuelle et limite les risques associés aux contenus non conformes.

ADN vidéo

FpShot

Identifie une vidéo de manière unique. Cela vous permet d'extraire et de comparer les empreintes digitales des images et de l'audio contenues dans les vidéos. Ainsi, vous pouvez détecter les vidéos dupliquées, retracer l'origine des extraits vidéo et identifier le plagiat.

Miniature intelligente

Cover

Sélectionne l'image clé ou l'extrait vidéo optimal pour servir de miniature, améliorant ainsi le taux de clics et l'expérience utilisateur. Cette sélection repose sur des algorithmes analysant en profondeur le contenu vidéo, l'esthétique de l'image et un vaste volume de données comportementales utilisateurs.

Paramètre

Type

Obligatoire

Description

InputFile

String

Oui

Le fichier d'entrée. Utilisez les paramètres Bucket, Location et Object pour spécifier l'emplacement du fichier.

• Pour plus d'informations sur les règles de déclenchement des flux de travail, consultez la rubrique Règles de déclenchement des flux de travail pour les fichiers.

• Le fichier doit être stocké exclusivement dans OSS. Pour obtenir des détails sur le paramètre InputFile, reportez-vous à la section Détails des paramètres.

• Vous devez encoder l'URL du chemin d'accès à l'objet OSS en UTF-8 avant de l'utiliser dans MPS. Pour en savoir plus, consultez la page Encodage d'URL.

• Exemple : {"Bucket":"example-bucket","Location":"oss-cn-hangzhou","ObjectPrefix":"example.mp4"}.

PipelineId

String

Oui

L'ID de la file d'attente MPS, qui constitue un paramètre global.

• Cet ID de file d'attente MPS n'est utilisé que pour les activités Analyse, Encodage, Capture d'écran et Pack. Pour les tâches d'intelligence artificielle, vous devez configurer séparément l'ID de la file d'attente MPS propre à chaque activité.

• Dans un flux de travail multimédia, les paramètres de message d'une file d'attente MPS spécifique ne s'appliquent pas. Utilisez plutôt le paramètre QueueName ou TopicName défini pour le flux de travail multimédia.

MessageType

String

Non

Le type de message, qui constitue un paramètre global. Valeurs possibles :

• Queue : file d'attente Simple Message Queue (anciennement MNS). Si vous choisissez cette option, vous devez renseigner le paramètre QueueName.

• Topic : rubrique SMQ. Si vous choisissez cette option, vous devez renseigner le paramètre TopicName.

• Valeur par défaut : Queue.

QueueName

String

Non

La file d'attente SMQ à associer à la file d'attente MPS (paramètre global). Une fois la tâche terminée dans la file d'attente MPS, les résultats sont transmis à la file d'attente SMQ. Pour plus d'informations sur les notifications de messages, consultez la rubrique Recevoir des notifications.

• Spécifiez l'une des files d'attente SMQ que vous avez créées. Si aucune file d'attente SMQ n'est disponible, créez-en une depuis la console SMQ.

TopicName

String

Non

La rubrique SMQ à associer à la file d'attente MPS (paramètre global). Une fois la tâche terminée dans la file d'attente MPS, les résultats sont transmis à la rubrique SMQ associée, qui envoie ensuite une notification à l'URL abonnée à cette rubrique. Pour en savoir plus, consultez la rubrique Recevoir des notifications.

• Indiquez l'une des rubriques SMQ que vous avez créées. Si aucune rubrique SMQ n'est disponible, créez-en une depuis la console SMQ.

RoleName

String

Non

Le nom du rôle Resource Access Management (RAM), qui constitue un paramètre global.

• Valeur par défaut : AliyunMTSDefaultRole.

Paramètre

Type

Obligatoire

Description

PublishType

String

Non

Le mode de publication du fichier multimédia. Il s'agit d'un paramètre global. Valeurs valides :

• Manual : publie manuellement le fichier multimédia. Le fichier est dépublié après l'exécution du workflow. Vous pouvez publier manuellement le fichier multimédia. Pour plus d'informations, consultez la rubrique Gérer les fichiers multimédias.

• Auto : publie automatiquement le fichier multimédia une fois toutes les activités terminées. Le fichier multimédia est publié automatiquement après l'exécution du workflow.

• TranscodeCompletedAuto : publie automatiquement le fichier multimédia une fois l'activité de transcodage terminée. Les paramètres de messagerie de l'activité Input sont utilisés pour vous notifier que le transcodage est terminé. Si l'activité Transcode est ignorée, aucun message n'est envoyé.

• Valeur par défaut : Manual.

  Remarque

  • MPS traite les fichiers multimédias dans un workflow et utilise Security Token Service (STS) pour accorder des permissions aux utilisateurs RAM. Cela vous permet de configurer la manière dont les fichiers multimédias sont publiés.

  • L'état de publication affecte les permissions d'accès au fichier de sortie.

    • Si les fichiers vidéo, audio et les snapshots de sortie ne sont pas publiés, les permissions d'accès à ces fichiers sont privées.

    • Si les fichiers vidéo, audio et les snapshots de sortie sont publiés, les permissions d'accès à ces fichiers sont déterminées en fonction des permissions d'accès du bucket OSS dans lequel ils résident.

Paramètre

Type

Obligatoire

Description

KeepOnlyHighestDefinition

String

Non

Indique s'il faut conserver uniquement les résultats d'analyse pour les vidéos de la définition la plus élevée. Valeurs valides :

• True : conserve uniquement la vidéo de sortie de la définition la plus élevée.

• False : génère les vidéos de sortie dans toutes les définitions.

• Valeur par défaut : False.

Paramètre

Type

Obligatoire

Description

Outputs

String

Non

Les sorties des tâches de transcodage.

• Spécifiez la valeur sous forme de tableau JSON d'objets Output. Vous pouvez spécifier jusqu'à 30 objets Output.

• Pour plus d'informations sur les paramètres de chaque objet Output, consultez la rubrique Détails des paramètres.

• Exemple : [{"OutputObject":"transcode%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D","TemplateId": "S00000001-000070"}].

OutputBucket

String

Non

Le nom du bucket de sortie.

• Lors de l'empaquetage HTTP Live Streaming (HLS) et Dynamic Adaptive Streaming over HTTP (DASH), le paramètre Bucket de l'activité Pack est prioritaire sur le paramètre OutputBucket.

OutputLocation

String

Non

La région du bucket de sortie.

• Lors de l'empaquetage HLS et DASH, le paramètre Location de l'activité Pack est prioritaire sur le paramètre OutputLocation.

MultiBitrateVideoStream

String

Non

Ce paramètre est requis pour l'extraction des flux vidéo lors de l'empaquetage HLS.

• Pour plus d'informations, consultez la rubrique Détails des paramètres.

• Exemple : {"URI": "c/d/video1.m3u8"}.

ExtXMedia

String

Non

Ce paramètre est requis pour l'extraction des flux audio ou de sous-titres lors de l'empaquetage HLS.

• Pour plus d'informations, consultez la rubrique Détails des paramètres.

• Exemple : {"Name": "english","Language": "en-US","URI":"c/d/audio-1.m3u8"}.

WebVTTSubtitleURL

String

Non

L'URL du sous-titre. Ce paramètre est requis pour l'extraction des flux de sous-titres lors de l'empaquetage HLS.

• Seuls les fichiers de sous-titres Web Video Text Tracks (WebVTT) sont pris en charge. L'URL du sous-titre doit être conforme à la norme URL et peut être écrasée lorsque vous appelez l'opération AddMedia.

• Exemple : http://example-bucket-**.oss-cn-hangzhou.aliyuncs.com/subtitles**-en.vtt.

Representation

String

Non

Ce paramètre est requis pour l'extraction des flux vidéo, audio ou de sous-titres lors de l'empaquetage DASH.

• Pour plus d'informations, consultez la rubrique Détails des paramètres.

• Exemple : {\"Id\":\"480p\", \"URI\":\"videoSD/xx.mpd\"}.

InputConfig

String

Non

L'URL du sous-titre. Ce paramètre est requis pour l'extraction des flux de sous-titres lors de l'empaquetage DASH.

• Pour plus d'informations, consultez la rubrique Détails des paramètres.

• Exemple : "{\"Format\":\"vtt\",\"InputFile\":{\"URL\":\"http://example-Bucket-**.oss-cn-hangzhou.aliyuncs.com/subtitle/subtitle**-en.vtt\"}}".

Paramètre

Type

Obligatoire

Description

SnapshotConfig

String

Oui

Les configurations du snapshot.

• Pour plus d'informations, consultez la rubrique Détails des paramètres.

• Exemple : {"OutputFile": {"Bucket": "example-001", "Location": "oss-cn-hangzhou", "Object":"snapshot%2F%7BObjectPrefix%7D%2F%7BFileName%7D.%7BExtName%7D%2F1.jpg"},"Time": "5"}.

MediaCover

String

Non

Indique s'il faut définir le snapshot comme miniature du média. Ce paramètre n'est valide que pour un seul snapshot. Valeurs valides :

• true

• false

• Valeur par défaut : false.

Paramètre

Type

Obligatoire

Description

Output

String

Oui

Les informations détaillées sur le fichier de sortie, présentées sous forme de chaîne JSON. Exemple : {"Bucket":"output","Location":"oss-cn-hangzhou","MasterPlayListName":"a/b/c.m3u8"}.

Protocol

String

Oui

Protocole utilisable pour l'empaquetage. Valeurs valides : hls et dash.

Paramètre

Type

Obligatoire

Description

AdaptationSet

String

Non

Informations relatives au groupe vidéo. Ce paramètre est requis pour l'empaquetage DASH.

• Pour plus d'informations, consultez la rubrique Détails des paramètres.

• Exemple : "AdaptationSet":"{\"Group\":\"VideoGroup\"}".

Paramètre

Type

Obligatoire

Description

GroupId

String

Non

ID du groupe audio. Ce paramètre est requis pour l'empaquetage HLS.

• La longueur de l'ID peut atteindre 32 octets.

AdaptationSet

String

Non

Informations relatives au groupe audio. Ce paramètre est requis pour l'empaquetage DASH.

• Pour plus d'informations, consultez la rubrique Détails des paramètres.

• Exemple : "{\"Lang\":\"english\", \"Group\":\"AudioGroupEnglish\"}".

Paramètre

Type

Obligatoire

Description

GroupId

String

Non

ID du groupe de sous-titres. Ce paramètre est requis pour l'empaquetage HLS.

• La longueur de l'ID peut atteindre 32 octets.

AdaptationSet

String

Non

Informations relatives au groupe de sous-titres. Ce paramètre est requis pour l'empaquetage DASH.

• Pour plus d'informations, consultez la rubrique Détails des paramètres.

• Exemple : "{\"Lang\":\"english\", \"Group\":\"SubtitleENGroup\"}".

Paramètre

Type

Obligatoire

Description

MasterPlayList

String

Non

• Flux vidéo multi-débits. Ce paramètre est exclusif et requis pour l'empaquetage HLS. Pour plus d'informations, consultez la rubrique Détails des paramètres.

• Exemple : {"MultiBitrateVideoStreams": [{"RefActivityName": "video-1","ExtXStreamInf": {"BandWidth": "111110","Audio": "auds","Subtitles": "subs"}}]}.