Spécification de marqueurs SCTE-35 à l'aide d'un document XML ESAM - MediaConvert

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Spécification de marqueurs SCTE-35 à l'aide d'un document XML ESAM

Si votre vidéo d'entrée ne contient pas de marqueurs SCTE-35, mais que vous devez spécifier des points d'insertion de publicité dans vos sorties, vous pouvez indiquer des documents XML ESAM (Event Signaling and Management) dans votre fichier AWS Elemental.MediaConvertparamètres de la tâche. Lorsque vous le faites,MediaConvertconditionne vos sorties avec des images IDR (Instantaneous Decoder Refresh) aux points d'insertion que vous spécifiez dans le document. Dans les sorties qui sont également encapsulées dans des conteneurs MPEG2-TS et HLS, MediaConvert insère des messages time_signal SCTE-35 au niveau de ces points.

Pour vos groupes de sortie Apple HLS vous pouvez si vous le souhaitez également fournir un document XML de conditionnement de manifeste HLS. Vous pouvez alors configurer votre tâche afin qu'elle prépare en conséquence les manifestes pour vos sorties HLS.

Note

Pour placer des marqueurs SCTE-35 dans vos sorties MPEG2-TS, en plus de fournir les documents XML ESAM, vous devez également activer ESAM SCTE-35 dans chaque sortie. Pour plus d'informations, consultez la procédure de console à la suite de cette présentation.

À propos des codes horaires dans les documents ESAM

Spécifiez les points d'insertion dans vos documents XML par rapport au minutage de la sortie finale, après découpe et assemblage de l'entrée. Commencez votre minutage à 00:00:00:00, quels que soient vos paramètres de code horaire. Utilisez le format 24 heures suivant avec un numéro de trame : HH:MM:SS:FF.

Par exemple, une tâche contient les trois entrées suivantes : un pre-roll de cinq minutes, un film d'une heure et un post-roll de cinq minutes. Vous utilisez la découpe d'entrée pour extraire les 20 dernières minutes de votre entrée d'une heure. Ainsi, votre sortie en incluant le pre-roll et le post-roll dure 30 minutes. Si vous souhaitez que votre premier point d'insertion apparaisse trois minutes dans le contenu principal, vous devez le spécifier à huit minutes, soit trois minutes après votre pré-rouleau de cinq minutes.

Pour inclure des documents XML ESAM dans les paramètres de votre tâche (console)

  1. Ouverture d'MediaConvertconsole àhttps://console.aws.amazon.com/mediaconvert.

  2. Choisissez Create new job (Créer une nouvelle tâche).

  3. Configurez votre entrée, vos groupes de sorties et vos sorties vidéo et audio comme décrit dans Configuration d'une tâche dans AWS Elemental MediaConvert et Création de sorties avec AWS ElementalMediaConvert.

  4. Dans le volet Job (Tâche) à gauche, dans la section Job settings (Paramètres de tâche), choisissez Settings (Paramètres).

  5. Dans la section Ad signaling (Signalisation d'annonces), activez Event signaling and messaging (ESAM).

  6. Pour Signal processing notification XML (Document XML de notification de traitement du signal), entrez votre document XML de signalisation ESAM sous forme de texte. Pour voir un exemple, consultez Exemple de notification de traitement de signal XML ESAM.

    Note

    Par défaut,MediaConvertajoute un prélaminage de quatre secondes à la charge utile ESAM. Cela peut entraînerMediaConvertplacer le message SCTE-35 un segment plus tôt que le marqueur de repère désigné dans le manifeste HLS. Pour supprimer le pré-rouleau, définissezresponseSignalPrerolljusqu'à zéro. Ce paramètre est un enfant deEsamSettings.

  7. Le cas échéant, si vous souhaitez inclure des informations sur les marqueurs SCTE-35 contenus dans vos manifestes HLS, pour Manifest confirm condition notification XML (Document XML de notification de condition de confirmation de manifeste), entrez votre document XML conditionnel de manifeste ESAM sous forme de texte. MediaConvertn'inclut pas d'informations sur vos marqueurs SCTE-35 dans vos manifestes DASH.

    Pour insérer des marqueurs SCTE-35 dans le flux de transport ainsi que dans le manifeste, définissez le paramètredataPassThroughdans votre document MCC à"true". Si vous ne voulez pas de marqueurs dans le flux de transport, supprimez ledataPassThroughattributs.

    Pour voir un exemple, consultez Exemple de notification de condition de confirmation du manifeste XML ESAM.

  8. Pour chaque sortie MPEG2-TS où doivent figurer les marqueurs SCTE-35, activez les marqueurs :

    1. Dans le volet Job (Tâche) à gauche, sous Output groups (Groupes de sorties), File group (Groupe de fichiers), choisissez la sortie.

    2. Vérifiez qu'il s'agit bien d'une sortie MPEG2-TS. Dans la section Output settings (Paramètres de sortie), vérifiez que Container (Conteneur) est défini sur MPEG-2 Transport Stream (Flux de transport MPEG-2).

    3. Choisissez Container settings (Paramètres de conteneur), puis faites défiler l'écran vers le bas jusqu'à la section PID controls (Contrôles PID).

    4. Pour ESAM SCTE-35, choisissez Enabled (Activé).

    5. Pour SCTE-35 source (Source SCTE-35), conservez la valeur par défaut None (Aucune).

  9. Effectuez cette étape uniquement pour les groupes de sortie Apple HLS de votre tâche.

    Si vous voulez préparer votre manifeste HLS avec votre points d'insertion ESAM, suivez la procédure décrite dans Inclusion d'informations SCTE-35 dans votre manifeste HLS. Sinon, suivez ces étapes pour vérifier que les paramètres suivants se trouvent toujours dans leur état par défaut :

    1. Vérifiez que le paramètre Manifest confirm condition notification XML (Document XML de notification de condition de confirmation de manifeste), présenté dans une étape précédente de cette procédure, est vide.

    2. Pour chaque groupe de sorties Apple HLS de votre tâche, vérifiez que Ad Markers (Marqueurs de publicité) est décoché.

      1. Dans le volet Job (Tâche) à gauche, sous Output groups (Groupes de sorties), Apple HLS.

      2. Dans la section Apple HLS group settings (Paramètres de groupe Apple HLS), choisissez Advanced (Avancé).

      3. Dans la section Ad markers (Marqueurs de publicité), décochez les cases Elemental et SCTE-35 enhanced (SCTE-35 optimisé).

    3. Pour chaque sortie de vos groupes de sorties Apple HLS, vérifiez que SCTE-35 source (Source SCTE-35) est défini sur None (Aucune) :

      1. Dans le volet Job (Tâche) à gauche, sous Output groups (Groupes de sorties), Apple HLS, choisissez une sortie.

      2. Dans la section Output settings (Paramètres de sortie), choisissez Transport stream settings (Paramètres de flux de transport).

      3. Pour SCTE-35 source (Source SCTE-35), choisissez None (Aucune).

Pour inclure des documents XML ESAM dans les paramètres de votre tâche (API, SDK, AWS CLI)

  1. Incluez la propriété esam et ses enfants à la racine des paramètres de la tâche dans la spécification de votre tâche JSON. Ces propriétés figurent dans l'exemple suivant.

    1. Incluez votre spécification XML de traitement du signal ESAM sous forme de chaîne dans le paramètre sccXml.

    2. Incluez éventuellement un document de notification XML de condition de confirmation de manifeste sous forme de chaîne dans le paramètre mccXml:

    "esam": { "responseSignalPreroll": 4000, "signalProcessingNotification": { "sccXml": "<?xml version=\"1.0\" encoding=\"utf-8\"?>\n<SignalProcessingNotification ..." }, "manifestConfirmConditionNotification": { "mccXml": "<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?>\n<ns2:ManifestConfirmConditionNotification ... " }
  2. Pour chaque sortie M2TS (flux de transport MPEG2) figurant dans votre tâche, définissez la spécification de votre tâche JSON comme dans l'exemple suivant. Incluez la propriété scte35Esam. Définissez scte35Source sur NONE.

    "outputs": [ { "extension": "m2ts", "containerSettings": { "container": "M2TS", "m2tsSettings": { ... "scte35Esam": { "scte35EsamPid": 508 }, ... "scte35Source": "NONE" }
  3. Si vous souhaitez préparer vos manifestes HLS avec des informations SCTE-35, pour chaque groupe de sorties Apple HLS de votre tâche, incluez ce qui suit. Ces paramètres figurent dans l'exemple à la fin de cette étape :

    Si vous ne souhaitez pas préparer vos manifestes HLS avec des informations SCTE-35, conservez le paramètre par défaut NONE pour scte35Source et n'incluez pas adMarkers :

    "outputGroups": [ { "customName": "apple_hls", "outputGroupSettings": { "type": "HLS_GROUP_SETTINGS", "hlsGroupSettings": { "adMarkers": [ "ELEMENTAL_SCTE35" ], ... } }, "outputs": [ { "extension": "m3u8", "nameModifier": "high", "outputSettings": { "hlsSettings": { ... } }, "containerSettings": { "container": "M3U8", "m3u8Settings": { ... "scte35Source": "PASSTHROUGH" }
  4. Soumettez votre tâche comme d'habitude.

    Pour plus d'informations sur la soumission d'AWS ElementalMediaConvertoffres d'emploi par programmation, voirPremiers pas avec AWS ElementalMediaConvertUtilisation de laAWSKits SDK ou leAWS CLIetPremiers pas avec AWS ElementalMediaConvertUtilisation de l'API.