View a markdown version of this page

MediaTailor variabili di servizio per il controllo della sessione - AWS Elemental MediaTailor
Parametri supportatiAWS. Ora di inizioaws.prerollaws.overlayAvailsAWS.LogModeaws.avail SuppressionMode

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à.

MediaTailor variabili di servizio per il controllo della sessione

AWS Elemental MediaTailor riserva lo spazio dei nomi dei parametri di query per le variabili di servizio che controllano il comportamento a livello di sessione. aws. A differenza dei ads. parametri (che vengono inoltrati all'ADS) e manifest. dei parametri (che vengono aggiunti agli URL del manifesto personalizzato), i aws. parametri vengono consumati direttamente MediaTailor e non vengono inoltrati al server di origine o all'ADS.

Parametri supportati

La tabella seguente elenca i aws.* parametri che è possibile utilizzare per controllare il comportamento a livello di sessione.

Parametro Tipo Valori Predefinita Description
aws.startTime Timestamp ISO 8601 Ad esempio, 2026-06-17T10:00:00Z Non impostato (live-edge join) Avvia la sessione in un punto specifico della finestra del DVR. MediaTailor risolve il timestamp relativo al limite del segmento più vicino ed emette nel manifesto HLS. EXT-X-START:TIME-OFFSET
aws.preroll Enumerazione stringa enabled, (disabledsenza distinzione tra maiuscole e minuscole) enabled Controlla se viene effettuato l'inserimento di annunci preliminari per la sessione. Quandodisabled, il pre-roll viene soppresso anche se la configurazione di riproduzione ha un. LivePreRollConfiguration
aws.overlayAvails Enumerazione stringa on, (senza distinzione tra maiuscole e off minuscole) on Controlla se gli overlay (non lineari) e gli avails vengono elaborati per la sessione. Quandooff, gli indicatori degli annunci sovrapposti nel manifesto di origine vengono ignorati e non viene inserito alcun annuncio in sovrapposizione.
aws.logMode Enumerazione stringa DEBUG, DISABLED DISABLED Abilita una registrazione dettagliata del debug per la sessione. Se impostato suDEBUG, invia registri di sessione dettagliati in Logs per MediaTailor la risoluzione dei problemi. CloudWatch
aws.availSuppressionMode Enumerazione stringa OFF,, (senza distinzione tra BEHIND_LIVE_EDGE maiuscole e AFTER_LIVE_EDGE minuscole) OFF Controlla se gli annunci sono soppressi in base alla loro posizione rispetto al live edge.
aws.availSuppressionValue Durata del tempo HH:MM:SS formato (ad esempio,00:00:10) Non impostato La finestra temporale per la soppressione degli avail. Obbligatorio quando availSuppressionMode è BEHIND_LIVE_EDGE o. AFTER_LIVE_EDGE
aws.availSuppressionFillPolicy Enumerazione stringa FULL_AVAIL_ONLY, PARTIAL_AVAIL (senza distinzione tra maiuscole e minuscole) FULL_AVAIL_ONLY Quando la modalità è attivaAFTER_LIVE_EDGE, controlla se vengono riempiti gli avail parzialmente soppressi.

AWS. Ora di inizio

Quando aws.startTime è impostato, MediaTailor avvia la sessione dal limite del segmento più vicino alla data-ora del programma specificata.

Utilizzo

Passa aws.startTime come parametro di interrogazione nella richiesta del manifesto:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.startTime=2026-06-17T10:00:00Z

Oppure, nell'inizializzazione esplicita della sessione, passalo come campo di primo livello senza il prefisso: aws.

POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8

{
    "startTime": "2026-06-17T10:00:00Z"
}
Requisiti

I seguenti requisiti si applicano a: aws.startTime

  • Il manifesto di origine deve contenere EXT-X-PROGRAM-DATE-TIME (PDT) nessun segmento. Senza PDT, aws.startTime non può essere risolto e viene ignorato.

  • Si applica solo alle sessioni live HLS (sia SSAI che SGAI).

Comportamento

La tabella seguente descrive come aws.startTime si comporta nei diversi scenari:

Scenario Risultato
Timestamp all'interno della finestra del DVR Inizia dal limite del segmento più vicino, emetti EXT-X-START
Timestamp più vecchio della finestra del DVR Fissare a 3×TargetDuration dalla testina della finestra
Timestamp entro 3×targetDuration of live edge Consideralo live-edge join (no) EXT-X-START
Timestamp in corrispondenza o dopo live edge Join live-edge normale
Malformato o non conforme alla norma ISO 8601 Ignorato: torna a live-edge join, è stato registrato un errore
Manifest non ha PDT Ignorato: torna a live-edge join, è stato registrato un errore
Parametro omesso Predefinito: normale live-edge join
Comportamento di bloccaggio

Se il punto iniziale esce dalla finestra del DVR a metà sessione, EXT-X-START viene fissato a 3×TargetDuration dalla testina della finestra. Il buffer 3×TargetDuration è in linea con i consigli di buffering per i giocatori della RFC 8216 §6.3.3.

Esempio Output manifesto con aws.StartTime

Quando un giocatore inizializza una sessione aws.startTime=2026-06-17T10:00:00Z e l'offset risolto è a 120 secondi dal live edge, emette: MediaTailor 

#EXTM3U
#EXT-X-TARGETDURATION:6
#EXT-X-START:TIME-OFFSET=-120.120,PRECISE=YES
#EXT-X-MEDIA-SEQUENCE:500
#EXT-X-PROGRAM-DATE-TIME:2026-06-17T09:58:00.000Z
#EXTINF:6.006,
segment500.ts
#EXTINF:6.006,
segment501.ts
...

TIME-OFFSET=-120.120Indica al giocatore di iniziare la riproduzione 120 secondi dopo il live edge, nel limite del segmento più vicino all'ora di inizio richiesta.

Limitazioni

Si applicano le limitazioni seguenti:

  • Non è possibile modificare questo parametro dopo l'inizializzazione della sessione.

  • Richiede EXT-X-PROGRAM-DATE-TIME nel manifesto di origine.

  • EXT-X-STARTè un suggerimento per il giocatore: MediaTailor non può garantire che tutti i giocatori lo rispettino.

aws.preroll

Quandoaws.preroll=disabled, MediaTailor sopprime l'inserimento di annunci pre-roll per la sessione anche se la configurazione di riproduzione ha un. LivePreRollConfiguration

Utilizzo

Passa aws.preroll come parametro di interrogazione nella richiesta manifest:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.preroll=disabled

Oppure, nell'inizializzazione esplicita della sessione, passalo come campo di primo livello senza il prefisso: aws.

POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8

{
    "preroll": "disabled"
}
Requisiti

I seguenti requisiti si applicano a: aws.preroll

  • Affinché questo parametro abbia effetto, LivePreRollConfiguration la configurazione di riproduzione deve avere un valore. Se non è configurato alcun pre-roll, l'impostazione di questo parametro non ha alcun effetto.

  • Si applica alle sessioni live HLS (sia SSAI che SGAI).

Comportamento

La tabella seguente descrive come si comporta: aws.preroll

Valore Risultato
enabled(o omesso) Pre-roll inserito come di consueto
disabled Pre-roll soppresso per questa sessione
Valore non valido Registrato come errore, trattato come enabled
Limitazioni

Non è possibile modificare questo parametro dopo l'inizializzazione della sessione.

aws.overlayAvails

Quandoaws.overlayAvails=off, MediaTailor ignora gli indicatori di annunci overlay (non lineari) nel manifest di origine e non inserisce annunci overlay per la sessione.

Utilizzo

Passa aws.overlayAvails come parametro di interrogazione nella richiesta del manifesto:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.overlayAvails=off
Requisiti

I seguenti requisiti si applicano aaws.overlayAvails:

  • Affinché questo parametro abbia effetto, il manifesto di origine deve contenere marcatori di annunci sovrapposti (ad esempio SCTE-35 eventi con tipo di segmentazione overlay).

  • Si applica alle sessioni HLS e DASH, live e VOD (sia SSAI che SGAI).

Comportamento

La tabella seguente descrive come si comporta: aws.overlayAvails

Valore Risultato
on(o omesso) Gli overlay vengono elaborati e gli annunci vengono inseriti come di consueto
off Gli indicatori degli annunci sovrapposti vengono ignorati, non vengono inseriti annunci in sovrapposizione
Valore non valido Registrato come errore, considerato come non specificato (impostazione predefinita:) on
Limitazioni

Non è possibile modificare questo parametro dopo l'inizializzazione della sessione.

AWS.LogMode

Quandoaws.logMode=DEBUG, MediaTailor abilita la registrazione dettagliata del debug per la sessione. I log di debug vengono inviati a CloudWatch Logs e forniscono informazioni dettagliate sulla personalizzazione dei manifesti, sulle richieste del server di decisione pubblicitaria e sullo stato della sessione, utili per risolvere i problemi di inserimento degli annunci.

Utilizzo

Passa aws.logMode come parametro di interrogazione nella richiesta manifest:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.logMode=DEBUG
Requisiti

I seguenti requisiti si applicano aaws.logMode:

  • La configurazione di riproduzione deve avere la registrazione abilitata (PercentEnabled > 0o EnabledLoggingStrategies configurata) per l'emissione dei log di debug.

  • La registrazione di debug è limitata a livello di velocità per cliente per evitare un volume di log eccessivo.

Comportamento

La tabella seguente descrive come si comporta: aws.logMode

Valore Risultato
DEBUG Log di debug dettagliati emessi per la sessione
DISABLED(o omessi) Comportamento normale di registrazione (basato sulle impostazioni di configurazione della riproduzione)
Valore non valido Errore generato, l'inizializzazione della sessione non riesce
Limitazioni

Si applicano le limitazioni seguenti:

  • Non è possibile modificare questo parametro dopo l'inizializzazione della sessione.

  • I valori fanno distinzione tra maiuscole e minuscole (DEBUGnon). debug

aws.avail SuppressionMode

Controlla se gli annunci avail vengono soppressi in base alla loro posizione rispetto al live edge. Utilizzalo per saltare le interruzioni pubblicitarie che rientrano in una finestra temporale successiva o successiva al live edge, ad esempio per evitare di riempire le interruzioni pubblicitarie che gli spettatori hanno già superato partecipando a un live streaming a metà evento.

Utilizzo

Passa i parametri di soppressione degli avail come parametri di interrogazione nella richiesta manifest:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10

Questo parametro funziona con due parametri complementari:

  • aws.availSuppressionValue— La finestra temporale (richiesta quando la modalità non lo èOFF)

  • aws.availSuppressionFillPolicy— Controlla il comportamento di riempimento parziale (si applica solo alla AFTER_LIVE_EDGE modalità)

Requisiti

I seguenti requisiti si applicano ai parametri di soppressione degli avali:

  • Si applica alle sessioni live HLS e DASH.

  • aws.availSuppressionValuedeve essere fornito nel HH:MM:SS formato quando la modalità è BEHIND_LIVE_EDGE o. AFTER_LIVE_EDGE

  • aws.availSuppressionFillPolicyè valido solo quando la modalità èAFTER_LIVE_EDGE.

Comportamento della modalità

La tabella seguente descrive l'effetto di ciascuna modalità di soppressione:

Modalità Effetto
OFF(o omesso) Eliminazione inefficace: tutte le interruzioni pubblicitarie vengono riempite normalmente
BEHIND_LIVE_EDGE Elimina le interruzioni pubblicitarie che iniziano entro la finestra temporale specificata dopo il live edge
AFTER_LIVE_EDGE Elimina le interruzioni pubblicitarie che iniziano dopo la finestra temporale specificata dal live edge
Compila la politica (solo AFTER_LIVE_EDGE)

La tabella seguente descrive il comportamento della politica di riempimento quando la modalità è: AFTER_LIVE_EDGE

Politica di riempimento Effetto
FULL_AVAIL_ONLY (predefinito) Solo i valori di riempimento che non rientrano completamente nella finestra di soppressione
PARTIAL_AVAIL Riempi la parte di un avail che si estende oltre la finestra di soppressione
Esempio Approfitta dell'esempio di soppressione

La seguente richiesta elimina le interruzioni pubblicitarie entro 10 secondi dal live edge:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10
Limitazioni

Si applicano le limitazioni seguenti:

  • Non è possibile modificare questo parametro dopo l'inizializzazione della sessione.

  • aws.availSuppressionValuenon deve essere fornito quando la modalità èOFF.

  • Il formato dell'ora non valido aws.availSuppressionValue causa il ritorno alla OFF modalità.