Spécification des marqueurs SCTE-35 à l'aide du code 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 publicitaire dans vos sorties, vous pouvez fournir des documents XML ESAM (Event Signaling and Management) dans les paramètres de votre tâche AWS Elemental. MediaConvert Lorsque vous le faites, MediaConvert conditionnez 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 à ces points.

Pour vos groupes de sortie Apple HLS, vous pouvez également fournir un document XML de conditionnement du 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 d'image : 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 le découpage d'entrée pour ajuster les 20 dernières minutes de votre saisie 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 après le début du contenu principal, vous devez le spécifier huit minutes, soit trois minutes après votre prélancement de cinq minutes.

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

Ouvrez la MediaConvert console à l'adresse https://console.aws.amazon.com/mediaconvert.
Choisissez Create new job (Créer une nouvelle tâche).
Configurez votre entrée, vos groupes de sorties et vos sorties vidéo et audio comme décrit dans Configuration des tâches dans MediaConvert et Création de sorties.
Dans le volet Job (Tâche) à gauche, dans la section Job settings (Paramètres de tâche), choisissez Settings (Paramètres).
Dans la section Ad signaling (Signalisation d'annonces), activez Event signaling and messaging (ESAM).
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 obtenir un exemple, consultez Exemple de notification de traitement du signal XML ESAM.

Note
Par défaut, MediaConvert ajoute un prélancement de quatre secondes à la charge utile ESAM. Cela peut entraîner le MediaConvert placement du message SCTE-35 un segment plus tôt que ce que le marqueur de repère désigne dans le manifeste HLS. Pour supprimer le prélancement, réglez-le sur responseSignalPreroll zéro. Ce paramètre est un enfant de EsamSettings.
Si vous souhaitez inclure des informations sur vos marqueurs SCTE-35 dans vos manifestes HLS, entrez votre document XML conditionnel du manifeste ESAM sous forme de texte dans le champ de notification des conditions de confirmation du manifeste XML. MediaConvert n'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 en plus du manifeste, définissez l'dataPassThroughattribut dans votre document MCC sur. "true" Si vous ne voulez pas de marqueurs dans le flux de transport, supprimez les dataPassThrough attributs.

Pour obtenir un exemple, consultez Exemple de notification de condition de confirmation du manifeste XML ESAM.
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).
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 Inclure les 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 vos tâches (API, SDK,) AWS CLI

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 ... " 
    }
```

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"
            }

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 :

Définissez scte35Source sur PASSTHROUGH.
Incluez adMarkers et listez un ELEMENTAL_SCTE35 ou ELEMENTAL ou les deux dans un tableau.

Pour voir des exemples de manifestes créés avec chaque paramètre sélectionné, consultez Exemple de manifeste : marqueurs publicitaires Elemental et Exemple de manifeste : marqueurs publicitaires améliorés SCTE-35.

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"
            }

Soumettez votre tâche comme d'habitude.

Pour plus d'informations sur la soumission de MediaConvert tâches AWS Elemental par programmation, consultez Getting started with AWS Elemental MediaConvert using the AWS SDK or Getting AWS CLI started with AWS Elemental using the API. MediaConvert

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Passer par les marqueurs SCTE-35 depuis votre entrée

Exemple XML ESAM