View a markdown version of this page

MediaTailor variables de servicio para el control de la sesión - AWS Elemental MediaTailor
Parámetros admitidosAWS. StartTimeaws.prerollaws.Overlay está disponibleaws.LogModeaws.avail SuppressionMode

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

MediaTailor variables de servicio para el control de la sesión

AWS Elemental MediaTailor reserva el espacio de nombres de los parámetros de aws. consulta para las variables de servicio que controlan el comportamiento a nivel de sesión. A diferencia de ads. los parámetros (que se reenvían al ADS) y manifest. los parámetros (que se anexan a las URL del manifiesto personalizado), aws. los parámetros los consume directamente el servidor de origen o el ADS MediaTailor y no se reenvían a ellos.

Parámetros admitidos

En la tabla siguiente se enumeran los aws.* parámetros que puede usar para controlar el comportamiento a nivel de sesión.

Parámetro Tipo Valores Predeterminado Description (Descripción)
aws.startTime Marca de tiempo ISO 8601 Por ejemplo, 2026-06-17T10:00:00Z No se ha establecido (unión en vivo) Inicia la sesión en un punto específico de la ventana del DVR. MediaTailor resuelve la marca de tiempo con el límite del segmento más cercano y la emite EXT-X-START:TIME-OFFSET en el manifiesto HLS.
aws.preroll Enumerador de la cadena enabled, (sin distinción entre mayúsculas y minúsculas) disabled enabled Controla si se insertan anuncios previos a la publicación en la sesión. Cuandodisabled, se suprime el preroll aunque la configuración de reproducción tenga un. LivePreRollConfiguration
aws.overlayAvails Enumerador de la cadena on, off (no distingue mayúsculas y minúsculas) on Controla si los anuncios superpuestos (no lineales) se procesan para la sesión. En ese casooff, los marcadores de anuncios superpuestos del manifiesto fuente se ignoran y no se inserta ningún anuncio superpuesto.
aws.logMode Enumerador de la cadena DEBUG, DISABLED DISABLED Activa el registro detallado de depuración de la sesión. Cuando se establece enDEBUG, envía los registros detallados MediaTailor de la sesión a Logs para CloudWatch solucionar problemas.
aws.availSuppressionMode Enumerador de la cadena OFF,BEHIND_LIVE_EDGE, AFTER_LIVE_EDGE (no distingue mayúsculas y minúsculas) OFF Controla si la disponibilidad de los anuncios se suprime en función de su posición en relación con el borde activo.
aws.availSuppressionValue Duración del tiempo HH:MM:SS formato (por ejemplo,00:00:10) No configurado El intervalo de tiempo para la supresión de la disponibilidad. Obligatorio cuando availSuppressionMode es BEHIND_LIVE_EDGE o. AFTER_LIVE_EDGE
aws.availSuppressionFillPolicy Enumerador de la cadena FULL_AVAIL_ONLY, PARTIAL_AVAIL (no distingue mayúsculas y minúsculas) FULL_AVAIL_ONLY Cuando el modo esAFTER_LIVE_EDGE, controla si se rellenan las reservas parcialmente suprimidas.

AWS. StartTime

Cuando aws.startTime se establece, MediaTailor inicia la sesión en el límite del segmento más cercano a la fecha y hora del programa especificada.

De uso

Pase aws.startTime como parámetro de consulta en la solicitud de manifiesto:

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

O bien, en la inicialización explícita de la sesión, pásalo como un campo de nivel superior sin el aws. prefijo:

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

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

Los siguientes requisitos se aplican a: aws.startTime

  • El manifiesto de origen debe contener EXT-X-PROGRAM-DATE-TIME (PDT) los segmentos. Sin PDT, aws.startTime no se puede resolver y se ignora.

  • Se aplica únicamente a las sesiones en vivo de HLS (tanto a SSAI como a SGAI).

Comportamiento

En la siguiente tabla se describe cómo aws.startTime se comporta en diferentes escenarios:

Escenario Resultado
Marca de tiempo en la ventana del DVR Comience en el límite del segmento más cercano, emita EXT-X-START
Marca de tiempo anterior a la ventana del DVR Fija a 3 veces la duración del objetivo desde el cabezal de la ventana
Marca de tiempo dentro de 3 veces la duración objetivo de Live Edge Tratar como unión de borde activo (no) EXT-X-START
Marca de tiempo en Live Edge o después Unión normal a Live-Edge
Tiene una forma incorrecta o no es ISO 8601 Omitido: se recurre a la unión en vivo, se ha registrado un error
El manifiesto no tiene PDT Ignorado: vuelva a unirse a Live-Edge, error registrado
Parámetro omitido Predeterminado: unión normal entre bordes vivos
Comportamiento de sujeción

Si el punto de inicio desaparece de la ventana del DVR a mitad de la sesión, EXT-X-START se fija a 3 veces el valor de TargetDuration desde el encabezado de la ventana. El búfer TargetDuration de 3 veces se ajusta a las recomendaciones de almacenamiento en búfer de los reproductores según la RFC 8216 §6.3.3.

ejemplo Salida del manifiesto con AWS.StartTime

Cuando un jugador inicializa una sesión con aws.startTime=2026-06-17T10:00:00Z y el desfase resuelto está a 120 segundos de la ventaja en vivo, emite: 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.120Le indica al jugador que comience la reproducción 120 segundos por detrás del límite del segmento en vivo, en el límite del segmento más cercano a la hora de inicio solicitada.

Limitaciones

Se aplican las siguientes restricciones:

  • No puede cambiar este parámetro después de la inicialización de la sesión.

  • Es obligatorio EXT-X-PROGRAM-DATE-TIME en el manifiesto de origen.

  • EXT-X-STARTes una sugerencia para el jugador; MediaTailor no podemos garantizar que todos los jugadores la respeten.

aws.preroll

Cuandoaws.preroll=disabled, MediaTailor suprime la inserción de anuncios previos a la grabación en la sesión, incluso si la configuración de reproducción tiene un. LivePreRollConfiguration

De uso

Pase aws.preroll como parámetro de consulta en la solicitud de manifiesto:

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

O bien, en la inicialización explícita de la sesión, pásalo como un campo de nivel superior sin el aws. prefijo:

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

{
    "preroll": "disabled"
}
Requisitos

Los siguientes requisitos se aplican a: aws.preroll

  • La configuración de reproducción debe tener un LivePreRollConfiguration para que este parámetro surta efecto. Si no hay ninguna grabación previa configurada, la configuración de este parámetro no tendrá ningún efecto.

  • Se aplica a las sesiones en directo de HLS (tanto a SSAI como a SGAI).

Comportamiento

En la siguiente tabla se describe cómo se comporta: aws.preroll

Valor Resultado
enabled(u omitido) Pre-roll insertado como de costumbre
disabled Pre-roll suprimido para esta sesión
Valor no válido Registrado como error, tratado como enabled
Limitaciones

No puede cambiar este parámetro después de inicializar la sesión.

aws.Overlay está disponible

Cuandoaws.overlayAvails=off, MediaTailor ignora los marcadores de anuncios superpuestos (no lineales) del manifiesto de origen y no inserta anuncios superpuestos para la sesión.

De uso

Pase aws.overlayAvails como parámetro de consulta en la solicitud de manifiesto:

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

Los siguientes requisitos se aplican aaws.overlayAvails:

  • El manifiesto fuente debe contener marcadores publicitarios superpuestos (por ejemplo, SCTE-35 eventos con un tipo de segmentación superpuesta) para que este parámetro tenga algún efecto.

  • Se aplica a las sesiones de HLS y DASH, en directo y de VOD (tanto en SSAI como en SGAI).

Comportamiento

En la siguiente tabla se describe cómo se comporta: aws.overlayAvails

Valor Resultado
on(u omitido) Los anuncios superpuestos se procesan y los anuncios se insertan como de costumbre
off Los marcadores de anuncios superpuestos se ignoran y no se inserta ningún anuncio superpuesto
Valor no válido Registrado como error, tratado como no especificado (predeterminado:on)
Limitaciones

No puede cambiar este parámetro después de inicializar la sesión.

aws.LogMode

Cuandoaws.logMode=DEBUG, MediaTailor habilita el registro detallado de depuración de la sesión. Los registros de depuración se envían a CloudWatch Logs y proporcionan información detallada sobre la personalización de los manifiestos, las solicitudes de los servidores de decisión de anuncios y el estado de la sesión, lo que resulta útil para solucionar problemas de inserción de anuncios.

De uso

Pase aws.logMode como parámetro de consulta en la solicitud de manifiesto:

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

Los siguientes requisitos se aplican aaws.logMode:

  • La configuración de reproducción debe tener el registro habilitado (PercentEnabled > 0o EnabledLoggingStrategies configurado) para que se emitan los registros de depuración.

  • El registro de depuración tiene una velocidad limitada por cliente para evitar un volumen de registro excesivo.

Comportamiento

En la siguiente tabla se describe cómo se comporta: aws.logMode

Valor Resultado
DEBUG Registros de depuración detallados emitidos para la sesión
DISABLED(u omitido) Comportamiento normal del registro (según los ajustes de configuración de la reproducción)
Valor no válido Se produjo un error, la inicialización de la sesión falla
Limitaciones

Se aplican las siguientes restricciones:

  • No puede cambiar este parámetro después de la inicialización de la sesión.

  • Los valores distinguen entre mayúsculas y minúsculas (DEBUG, nodebug).

aws.avail SuppressionMode

Controla si la disponibilidad de anuncios se suprime en función de su posición en relación con el borde activo. Utilízalo para saltarte las pausas publicitarias que estén dentro de un intervalo de tiempo por detrás o por detrás del límite en directo; por ejemplo, para evitar cubrir las pausas publicitarias que los espectadores ya han superado cuando se unen a una emisión en directo a mitad de un evento.

De uso

Introduce los parámetros de supresión disponibles como parámetros de consulta en la solicitud de manifiesto:

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

Este parámetro funciona con dos parámetros complementarios:

  • aws.availSuppressionValue— La ventana de tiempo (requerida cuando el modo no está disponibleOFF)

  • aws.availSuppressionFillPolicy— Controla el comportamiento de llenado parcial (solo se aplica al AFTER_LIVE_EDGE modo)

Requisitos

Los siguientes requisitos se aplican a los parámetros de supresión disponibles:

  • Se aplica a las sesiones en vivo de HLS y DASH.

  • aws.availSuppressionValuedebe proporcionarse en HH:MM:SS formato cuando el modo es BEHIND_LIVE_EDGE oAFTER_LIVE_EDGE.

  • aws.availSuppressionFillPolicysolo es válido cuando el modo esAFTER_LIVE_EDGE.

Comportamiento del modo

En la siguiente tabla se describe el efecto de cada modo de supresión:

Mode Efecto
OFF(u omitido) La supresión fue inútil: todas las pausas publicitarias se rellenan con normalidad
BEHIND_LIVE_EDGE Suprime las pausas publicitarias que comiencen dentro del período de tiempo especificado detrás del límite de la publicación
AFTER_LIVE_EDGE Suprime las pausas publicitarias que comiencen después del período de tiempo especificado desde el límite en tiempo real
Política de relleno (solo en AFTER_LIVE_EDGE)

En la siguiente tabla se describe el comportamiento de la política de llenado cuando el modo es: AFTER_LIVE_EDGE

Política de llenado Efecto
FULL_AVAIL_ONLY (predeterminado) Rellene únicamente las reservas que estén completamente fuera del período de supresión
PARTIAL_AVAIL Rellene la parte de una reserva que se extienda más allá de la ventana de supresión
ejemplo Ejemplo de supresión de Avail

La siguiente solicitud suprime las pausas publicitarias transcurridos 10 segundos desde la fecha límite de la publicación:

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

Se aplican las siguientes restricciones:

  • No puedes cambiar este parámetro después de inicializar la sesión.

  • aws.availSuppressionValueno se debe proporcionar cuando el modo esOFF.

  • El formato de hora no válido aws.availSuppressionValue hace que el modo vuelva aOFF.