

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Specificazione dei marker SCTE-35 utilizzando ESAM XML
<a name="specifying-scte-35-markers-using-esam-xml"></a>

Se il video di input non contiene marcatori SCTE-35, ma devi specificare i punti di inserimento degli annunci nei tuoi output, puoi fornire documenti XML di Event Signaling and Management (ESAM) nelle impostazioni del lavoro. AWS Elemental MediaConvert Quando lo fate, MediaConvert condizionate le uscite con frame IDR (Instantaneous Decoder Refresh) nei punti di inserimento specificati nel documento. Negli output che sono anch'essi racchiusi in contenitori MPEG2 -TS e HLS, inserisce i messaggi time\$1signal SCTE-35 in quei punti. MediaConvert 

Per i gruppi di output **Apple HLS**, puoi anche fornire un documento XML di condizionamento del manifesto HLS. È quindi possibile configurare il processo in modo che condizioni di conseguenza i manifest degli output HLS.

**Nota**  
**Per inserire i marcatori SCTE-35 negli output MPEG2 -TS, oltre a fornire i documenti XML ESAM, è necessario abilitare ESAM SCTE-35 su ogni output.** Per ulteriori informazioni, consulta la procedura su console dopo questa panoramica.

**Informazioni sui timecode nei documenti ESAM**  
Specifica i punti di inserimento nei documenti XML rispetto alla tempistica dell'output finale, dopo il ritaglio e l'unione degli input. Avvia il tempo da 00:00:00:00, indipendentemente dalle impostazioni dei timecode. Utilizzate il seguente formato a 24 ore con un numero di frame: HH:MM:SS:FF.

Ad esempio, un processo ha i seguenti tre input: un preroll di cinque minuti, un film di un'ora e un postroll di cinque minuti. Utilizzate l'input clipping per regolare gli ultimi 20 minuti dell'input di un'ora. In questo modo, l'output con il preroll e il postroll dura 30 minuti. Se vuoi che il tuo primo punto di inserimento appaia tre minuti dopo il contenuto principale, devi specificarlo a otto minuti, tre minuti dopo il preroll di cinque minuti. 

**Per includere documenti XML ESAM nelle impostazioni del processo (console)**

1. [Apri la console in /mediaconvert. MediaConvert https://console.aws.amazon.com](https://console.aws.amazon.com/mediaconvert)

1. Scegli **Create new job** (Crea nuovo processo).

1. Configura l'input, i gruppi di output e gli output per video e audio, come descritto in [Tutorial: Configurazione delle impostazioni del lavoro](setting-up-a-job.md) e [Creazione di output](output-settings.md).

1. Nel riquadro **Job (Processo)** a sinistra, nella sezione **Job settings (Impostazioni processo)**, selezionare **Settings (Impostazioni)**.

1. Nella sezione **Ad signaling (Segnalazione annunci)**, abilitare **Event signaling and messaging (ESAM) (Segnalazione e messaggistica eventi, ESAM)**.

1. In **Signal processing notification XML (Segnala XML di notifica dell'elaborazione)**, inserire come testo il documento XML di segnalazione ESAM. Per vedere un esempio, consulta [Esempio di notifica di elaborazione del segnale ESAM XML](example-esam-xml.md).
**Nota**  
Per impostazione predefinita, MediaConvert aggiunge un preroll di quattro secondi al payload ESAM. Ciò potrebbe comportare il MediaConvert posizionamento del messaggio SCTE-35 un segmento prima del cue marker indicato nel manifesto HLS. Per rimuovere il preroll, impostalo su zero. `responseSignalPreroll` Questa impostazione è figlia di. [EsamSettings](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs-id.html#jobs-id-model-esamsettings)

1. Se desideri includere informazioni sui marcatori SCTE-35 nei manifesti HLS, per Manifest **Confirm Condition Notification XML, inserisci il documento XML condizionale del manifesto** ESAM come testo. MediaConvert non include informazioni sui marcatori SCTE-35 nei manifesti DASH.

   Per inserire i marker SCTE-35 nel flusso di trasporto oltre al manifesto, impostate l'attributo nel documento MCC su. `dataPassThrough` `"true"` Se non volete che i marker compaiano nel flusso di trasporto, rimuovete gli attributi. `dataPassThrough`

   Per vedere un esempio, consulta [Esempio di notifica della condizione di conferma del manifesto XML ESAM](example-esam-xml-manifest-conditioning.md). 

1. Per ogni uscita MPEG2 -TS in cui desideri utilizzare i marker SCTE-35, abilita i marker:

   1. Nel riquadro **Job (Processo)** a sinistra, in **Output groups (Gruppi di output)**, **File group (Gruppo di file)**, selezionare l'output.

   1. Confermate che si tratta di un output -TS. MPEG2 Nella sezione **Output settings (Impostazioni output)**, verificare che il **Container (Container)** sia impostato su **MPEG-2 Transport Stream (Flusso di trasporto MPEG2)**.

   1. Selezionare **Container settings (Impostazioni container)**, quindi scorrere verso il basso fino alla sezione **PID controls (Controlli PID)**.

   1. In **ESAM SCTE-35 (ESAM SCTE-35)**, selezionare **Enabled (Abilitato)**.

   1. In **SCTE-35 source (Origine SCTE-35)**, mantenere il valore predefinito **None (Nessuna)**.

1. Eseguire questo passaggio solo per eventuali gruppi di output **Apple HLS** nel lavoro.

   Se desideri condizionare il manifest HLS con i punti di inserimento ESAM, segui la procedura riportata in [Inclusione delle informazioni SCTE-35 nel manifesto HLS](including-scte-35-information-in-your-hls-manifest.md). In caso contrario, segui questi passaggi per confermare che le impostazioni seguenti sono ancora in stato predefinito:

   1. Verificare che **Manifest confirm condition notification XML (XML di notifica della condizione di conferma del manifest)**, discusso nel passaggio precedente, sia vuoto.

   1. Per ogni gruppo di output **Apple HLS (Apple HLS)** nel processo, confermare di aver mantenuto deselezionato **Ad Markers (Contrassegni pubblicità)**.

      1. Nel riquadro **Job (Processo)** a sinistra, in **Output groups (Gruppi di output)**, selezionare **Apple HLS (Apple HLS)**.

      1. Nella sezione **Apple HLS group settings (Impostazioni gruppo Apple HLS)**, selezionare **Advanced (Avanzate)**.

      1. Nella seziona **Ad markers (Contrassegni pubblicità)**, deselezionare le caselle di controllo **Elemental (Elemental)** e **SCTE-35 enhanced (SCTE-35 avanzato)**.

   1. Per ogni output nel gruppo di output **Apple HLS (Apple HLS)**, confermare che **SCTE-35 source (Origine SCTE-35)** sia impostata su **None (Nessuna)**:

      1. Nel riquadro **Job (Processo)** a sinistra, in **Output groups (Gruppi di output)**, **Apple HLS (Apple HLS)**, selezionare un output.

      1. Nella sezione **Output settings (Impostazioni output)**, selezionare **Transport stream settings (Impostazioni flusso di trasporto)**.

      1. Per **SCTE-35 source (Origine SCTE-35)**, selezionare **None (Nessuna)**.

**Per includere documenti ESAM XML nelle impostazioni dei lavori (API, SDK,) AWS CLI**

1. Includere la [proprietà `esam`](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-jobsettings-esam) e i relativi figli alla radice delle impostazioni del processo nella specifica del processo JSON. Queste proprietà sono raffigurate nell'esempio seguente.

   1.  Includere la specifica XML di elaborazione del segnale ESAM come stringa nell'impostazione `sccXml`. 

   1. Opzionalmente, includere un documento di notifica XML della condizione di conferma del manifest come stringa nell'impostazione `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 ... " 
       }
   ```

1. Per ogni output M2TS (MPEG2 Transport Stream) del job, imposta le specifiche del job JSON come mostrato nell'esempio seguente. Includere la proprietà [https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-m2tssettings-scte35esam](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-m2tssettings-scte35esam). Imposta [https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-m2tssettings-scte35source](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-m2tssettings-scte35source) su `NONE`.

   ```
     "outputs": [
           {
             "extension": "m2ts",
             "containerSettings": {
               "container": "M2TS",
               "m2tsSettings": {
                 ...
   
                 "scte35Esam": {
                   "scte35EsamPid": 508
                 },
                 ...
                 "scte35Source": "NONE"
               }
   ```

1. Se si desidera condizionare i manifest HLS con informazioni SCTE-35 information, per ogni gruppo di output Apple HLS nel processo, includere quanto segue. Queste impostazioni sono illustrate nell'esempio al termine di questo passaggio:
   +  Imposta [https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-m3u8settings-scte35source](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-m3u8settings-scte35source) su `PASSTHROUGH`.
   + Includere [https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-hlsgroupsettings-admarkers](https://docs.aws.amazon.com/mediaconvert/latest/apireference/jobs.html#jobs-prop-hlsgroupsettings-admarkers) ed elencare uno tra `ELEMENTAL_SCTE35` ed `ELEMENTAL` o entrambi in un array.

     Per i manifest di esempio creati con la selezione di ciascuna impostazione, consulta [Esempio di manifesto: Elemental ad marker](sample-manifest-elemental-ad-markers.md) e [Manifesto di esempio: marcatori pubblicitari avanzati SCTE-35](sample-manifest-scte-35-enhanced-ad-markers.md).

   Se non si desidera condizionare i manifest HLS con informazioni SCTE-35, mantenere l'impostazione predefinita `NONE` per `scte35Source` e non includere `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"
               }
   ```

1. Inviare il processo normalmente. 

   Per informazioni sull'invio di AWS Elemental MediaConvert lavori a livello di codice, consulta [Guida introduttiva all' AWS Elemental MediaConvert utilizzo dell' AWS SDKs or AWS CLI e Guida [introduttiva](https://docs.aws.amazon.com/mediaconvert/latest/apireference/getting-started.html) all'](https://docs.aws.amazon.com/mediaconvert/latest/apireference/custom-endpoints.html)utilizzo dell'API. AWS Elemental MediaConvert 

# Esempio di notifica di elaborazione del segnale ESAM XML
<a name="example-esam-xml"></a>

Questo blocco XML ESAM genera due interruzioni pubblicitarie di 30 secondi, una a 10 secondi e l'altra a 75 secondi.

```
<?xml version="1.0" encoding="UTF-8"?>
<SignalProcessingNotification xmlns="urn:cablelabs:iptvservices:esam:xsd:signal:1" xmlns:sig="urn:cablelabs:md:xsd:signaling:3.0" xmlns:common="urn:cablelabs:iptvservices:esam:xsd:common:1" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" acquisitionPointIdentity="ExampleESAM">

    <common:BatchInfo batchId="1">
      <common:Source xsi:type="content:MovieType" />
    </common:BatchInfo>

    <ResponseSignal acquisitionPointIdentity="ExampleESAM" acquisitionSignalID="1" signalPointID="10.00" action="create">
      <sig:NPTPoint nptPoint="10.00"/>
      <sig:SCTE35PointDescriptor spliceCommandType="06">
        <sig:SegmentationDescriptorInfo segmentEventId="1" segmentTypeId="52" upidType="9" upid="1" duration="PT30S" segmentNumber="1" segmentsExpected="1"/>
      </sig:SCTE35PointDescriptor>
    </ResponseSignal>
    <ConditioningInfo acquisitionSignalIDRef="1" startOffset="PT10S" duration="PT30S"/>

    <ResponseSignal acquisitionPointIdentity="ExampleESAM" acquisitionSignalID="2" signalPointID="40.00" action="create">
      <sig:NPTPoint nptPoint="40.00" />
      <sig:SCTE35PointDescriptor spliceCommandType="06">
        <sig:SegmentationDescriptorInfo segmentEventId="1" segmentTypeId="53" upidType="9" upid="2"/>
      </sig:SCTE35PointDescriptor>
    </ResponseSignal>

    <ResponseSignal acquisitionPointIdentity="ExampleESAM" acquisitionSignalID="3" signalPointID="75.00" action="create">
      <sig:NPTPoint nptPoint="75.00"/>
      <sig:SCTE35PointDescriptor spliceCommandType="06">
        <sig:SegmentationDescriptorInfo segmentEventId="2" segmentTypeId="52" upidType="9" upid="3" duration="PT30S" segmentNumber="2" segmentsExpected="1"/>
      </sig:SCTE35PointDescriptor>
    </ResponseSignal>
    <ConditioningInfo acquisitionSignalIDRef="3" startOffset="PT75S" duration="PT30S"/>
    
    <ResponseSignal acquisitionPointIdentity="ExampleESAM" acquisitionSignalID="4" signalPointID="105.00" action="create">
      <sig:NPTPoint nptPoint="105.00" />
      <sig:SCTE35PointDescriptor spliceCommandType="06">
        <sig:SegmentationDescriptorInfo segmentEventId="2" segmentTypeId="53" upidType="9" upid="4"/>
      </sig:SCTE35PointDescriptor>
    </ResponseSignal>

</SignalProcessingNotification>
```

# Esempio di notifica della condizione di conferma del manifesto XML ESAM
<a name="example-esam-xml-manifest-conditioning"></a>

Questo documento XML ESAM Manifest Confirm Condition (MCC) genera cue tag HLS manifest per due interruzioni pubblicitarie di 30 secondi. Il primo inizia a 10 secondi dopo; il secondo inizia a 75 secondi. Questi tag cue manifest contengono anche dati che possono essere utilizzati da un client downstream per la sostituzione e l'inserimento degli annunci. Gli output generati con questo documento MCC contengono un messaggio SCTE-35 incorporato nel file Transport Stream alla prima interruzione pubblicitaria, ma non alla seconda.

Nota l'`dataPassThrough`attributo sulla prima interruzione pubblicitaria. Quando questo attributo è presente e impostato su`"true"`, MediaConvert inserisce i marker SCTE-35 nel flusso di trasporto oltre al manifesto. Per qualsiasi interruzione pubblicitaria che desideri contrassegnare solo nel manifesto, tieni fuori l'attributo. `dataPassThrough`

MediaConvert supporta il condizionamento dei manifesti con ESAM solo nei pacchetti HLS.

```
<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ns2:ManifestConfirmConditionNotification xmlns:ns2="http://www.cablelabs.com/namespaces/metadata/xsd/confirmation/2" xmlns="http://www.cablelabs.com/namespaces/metadata/xsd/core/2" xmlns:ns3="http://www.cablelabs.com/namespaces/metadata/xsd/signaling/2">
  <ns2:ManifestResponse acquisitionPointIdentity="ExampleESAM" acquisitionSignalID="1" duration="PT30S" dataPassThrough="true"> 
  <ns2:SegmentModify>
      <ns2:FirstSegment>
        <ns2:Tag value="#EXT-X-CUE-OUT:4,SpliceType=VOD_DAI,Action=REPLACE, PAID=amazon.com/TEST2014020500000346,Acds=BA" />
      </ns2:FirstSegment>
      <ns2:SpanSegment>
        <ns2:Tag value="#EXT-X-CUE-OUT-CONT:${secondsFromSignal}/4, SpliceType=VOD_DAI,Action=REPLACE,PAID=amazon.com/TEST2014020500000346,Acds=BA" adapt="true" />
      </ns2:SpanSegment>
      <ns2:LastSegment>
        <ns2:Tag value="#EXT-X-CUE-IN:4,SpliceType=VOD_DAI" locality="after" adapt="true" />
      </ns2:LastSegment>
    </ns2:SegmentModify>
	</ns2:ManifestResponse>
  <ns2:ManifestResponse acquisitionPointIdentity="ExampleESAM" acquisitionSignalID="2"></ns2:ManifestResponse>
  <ns2:ManifestResponse acquisitionPointIdentity="ExampleESAM" acquisitionSignalID="3" duration="PT30S">  
  <ns2:SegmentModify>
      <ns2:FirstSegment>
        <ns2:Tag value="#EXT-X-OUT:4,SpliceType=VOD_DAI,Action=REPLACE, PAID=amazon.com/TEST2014020500000347,Acds=BA" />
      </ns2:FirstSegment>
      <ns2:SpanSegment>
        <ns2:Tag value="#EXT-X-OUT-CONT:${secondsFromSignal}/4, SpliceType=VOD_DAI,Action=REPLACE,PAID=amazon.com/TEST2014020500000346,Acds=BA" adapt="true" />
      </ns2:SpanSegment>
      <ns2:LastSegment>
        <ns2:Tag value="#EXT-X-CUE-IN:4,SpliceType=VOD_DAI" locality="after" adapt="true" />
      </ns2:LastSegment>
    </ns2:SegmentModify>
	</ns2:ManifestResponse>
	<ns2:ManifestResponse acquisitionPointIdentity="ExampleESAM" acquisitionSignalID="4"></ns2:ManifestResponse>
</ns2:ManifestConfirmConditionNotification>
```