Tous les produits
Search
Centre de documentation

ApsaraVideo Media Processing:Activités de workflow

Dernière mise à jour :Sep 08, 2026

Cette rubrique décrit les activités et les paramètres pris en charge dans la topologie d'un workflow multimédia. Pour configurer la topologie d'un workflow multimédia via les opérations AddMediaWorkflow ou UpdateMediaWorkflow, reportez-vous à cette rubrique.

Activités

Nom de l'activité

Type d'activité dans la topologie

Description

Input

Start

Définissez la configuration globale, y compris les files d'attente MPS et les messages, ainsi que le chemin d'entrée OSS pour le workflow multimédia.

Publish (obligatoire)

Report

Définissez le mode de publication sur manuel ou automatique.

Analyze

Analysis

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

Encode

Transcode

Transcode les fichiers multimédias d'entrée vers différents formats afin qu'ils soient lisibles sur diverses plateformes.

Snapshot

Screenshot

Capture des instantanés vidéo à des moments précis. Utilisez un instantané comme miniature ou plusieurs instantanés pour générer un sprite.

Configuration du package

PackageConfig

Emballe les fichiers vidéo multi-résolution, multi-pistes audio et multi-sous-titres pour générer des fichiers M3U8.

Video Group

VideoGroup

Audio Group

AudioGroup

Subtitle Group

SubtitleGroup

Extract Video

Extract Audio

Extract Subtitle

Transcode

Generate

GenerateMasterPlayList

Content Moderation

Censor

Détecte le contenu pornographique, terroriste et indésirable dans les discours, le texte et les scènes d'une vidéo. Cela réduit les coûts de modération manuelle et limite les risques liés au contenu non conforme.

Video DNA

FpShot

Identifie une vidéo de manière unique. Cette fonctionnalité permet d'extraire et de comparer les empreintes digitales des images et de l'audio pour détecter les doublons, retracer la source des clips et identifier le plagiat.

Intelligent Thumbnail

Cover

Sélectionne l'image clé ou l'extrait optimal d'une vidéo comme miniature afin d'améliorer le taux de conversion des clics et l'expérience utilisateur. Des algorithmes basés sur une analyse approfondie du contenu vidéo, de l'esthétique de l'image et des données comportementales des utilisateurs assurent cette sélection.

Input

Cette activité est obligatoire. Configurez le chemin d'entrée OSS et les paramètres globaux, y compris la file d'attente MPS et les notifications de message pour un workflow multimédia.

Cette activité récupère les informations multimédias. En cas d'échec, les activités suivantes sont ignorées jusqu'à l'exécution de l'activité Publish.

Nom

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 workflows, consultez Règles de déclenchement des workflows pour les fichiers.

  • Le fichier doit être stocké dans OSS. Pour plus de détails sur le paramètre InputFile, consultez Détails des paramètres.

  • Le chemin d'un objet OSS doit être encodé en URL au format UTF-8 avant utilisation dans MPS. Pour plus d'informations, consultez Encodage URL.

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

PipelineId

String

Oui

ID de pipeline de configuration globale.

  • Cet ID de file d'attente MPS est utilisé uniquement pour les activités Analyze, Encode, Snapshot et Pack. Pour les tâches IA, configurez séparément l'ID de file d'attente MPS pour chaque activité.

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

MessageType

String

Non

Configuration globale : catégorie de message

  • Queue : file d'attente Simple Message Queue (anciennement MNS). Si vous définissez ce paramètre sur Queue, vous devez spécifier le paramètre QueueName.

  • Topic : topic MNS. Définissez-le sur TopicName.

  • Valeur par défaut : Queue.

QueueName

String

Non

La configuration globale spécifie la file d'attente MNS à associer à un pipeline ApsaraVideo Media Processing. Une fois associée, les résultats des tâches terminées du pipeline sont envoyés à cette file d'attente. Pour plus d'informations sur les messages, consultez Recevoir des notifications de message.

TopicName

String

Non

Le topic SMQ à associer à la file d'attente MPS (paramètre global). Une fois qu'une tâche est terminée dans la file d'attente MPS, les résultats sont poussés vers le topic SMQ. Le topic SMQ associé pousse ensuite un message concernant les résultats vers l'URL abonnée. Pour plus d'informations, consultez Recevoir des notifications.

RoleName

String

Non

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

  • Valeur par défaut : AliyunMTSDefaultRole.

Publish

Cette activité est obligatoire. Configurez le mode de publication des médias après l'exécution du workflow.

Nom

Type

Obligatoire

Description

PublishType

String

Non

Configuration globale pour le type de publication multimédia.

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

  • Auto : publie automatiquement le fichier multimédia une fois toutes les activités terminées.

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

  • Valeur par défaut : Manual.

    Remarque
    • Lorsqu'ApsaraVideo Media Processing exécute un workflow pour traiter des fichiers, il utilise un utilisateur temporaire Security Token Service (STS) pour modifier les fichiers de sortie selon le type de publication.

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

      • Non publié : les fichiers vidéo, audio et capture d'écran ont des autorisations d'accès privées.

      • Publié : les fichiers vidéo, audio et capture d'écran héritent des autorisations d'accès du Bucket qui les contient.

Analysis

Cette activité analyse intelligemment les fichiers multimédias d'entrée et recommande des modèles prédéfinis appropriés.

Nom

Type

Obligatoire

Description

KeepOnlyHighestDefinition

String

Non

Spécifie s'il faut conserver uniquement les résultats d'analyse de la définition la plus élevée.

  • True : conserve uniquement la vidéo de sortie avec 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.

Transcoding

Nom

Type

Obligatoire

Description

Outputs

String

Non

Les sorties des tâches de transcodage.

  • Spécifiez la valeur dans un 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 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'emballage HTTP Live Streaming (HLS) et Dynamic Adaptive Streaming over HTTP (DASH), le paramètre Bucket dans l'activité Pack est prioritaire sur le paramètre OutputBucket.

OutputLocation

String

Non

Spécifie la région de sortie.

  • Lors de l'emballage HLS et DASH, le paramètre Location dans 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'emballage HLS.

ExtXMedia

String

Non

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

  • Pour plus d'informations, consultez 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'emballage 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 lors de l'appel de 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'emballage DASH.

InputConfig

String

Non

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

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

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

Snapshot

Nom

Type

Obligatoire

Description

SnapshotConfig

String

Oui

Les configurations d'instantané.

  • Pour plus d'informations, consultez 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

Spécifie s'il faut définir l'instantané comme miniature du média. Ce paramètre n'est valide que pour un seul instantané. Valeurs valides :

  • true : Vrai.

  • false : Faux

  • Valeur par défaut : false.

Pack

Configuration de l'emballage (PackageConfig)

Nom

Type

Obligatoire

Description

Output

String

Oui

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

Remarque

Espaces réservés pouvant être utilisés pour spécifier le paramètre MasterPlayListName :

  • {ObjectPrefix} : le chemin du fichier d'origine sans les informations du bucket.

  • {FileName} : le nom du fichier d'origine avec son extension. L'extension varie selon le format du modèle de transcodage.

  • {ExtName} : l'extension du fichier d'origine.

  • {RunId} : l'ID de l'instance de workflow.

  • {MediaId} : l'ID du fichier multimédia traité dans le workflow.

Protocol

String

Oui

Le protocole utilisable pour l'emballage. Valeurs valides : hls et dash.

Groupe vidéo

Nom

Type

Obligatoire

Description

AdaptationSet

String

Non

Les informations sur le groupe vidéo. Ce paramètre est requis pour l'emballage DASH.

Groupe audio

Nom

Type

Obligatoire

Description

GroupId

String

Non

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

  • La longueur maximale est de 32 octets.

AdaptationSet

String

Non

Les informations sur le groupe audio. Ce paramètre est requis pour l'emballage DASH.

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

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

Groupe de sous-titres

Nom

Type

Obligatoire

Description

GroupId

String

Non

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

  • La longueur maximale est de 32 octets.

AdaptationSet

String

Non

Les informations sur le groupe de sous-titres. Ce paramètre est requis pour l'emballage DASH.

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

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

Emballage et génération (GenerateMasterPlayList)

Nom

Type

Obligatoire

Description

MasterPlayList

String

Non

  • Les flux vidéo multi-débit. Ce paramètre est exclusif et requis pour l'emballage HLS. Pour plus d'informations, consultez Détails des paramètres.

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

Références