Creación y uso de alias de configuración con MediaTailor - AWS Elemental MediaTailor
Paso 1: Crear alias de configuraciónPaso 2: Utilice los alias de configuración en la inicialización de la sesión

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.

Creación y uso de alias de configuración con MediaTailor

Antes de empezar a usar variables de dominio, debe crear alias de configuración para su configuración. Los alias de configuración se utilizan como variables de reemplazo del dominio en el momento de la inicialización de la sesión.

Restricciones

Tenga en cuenta las siguientes restricciones al utilizar los alias de configuración:

  • Todas las variables dinámicas utilizadas en el dominio deben definirse como variables ConfigurationAliases dinámicas.

  • Las variables de los parámetros del reproductor deben ir precedidas deplayer_params.. Por ejemplo, player_params.origin_domain.

  • La lista de valores con alias debe ser exhaustiva para las variables de dominio críticas URLs (VideoContentSourceUrl,AdSegmentUrlPrefix,ContentSegmentUrlPrefix).

  • Si se realiza una solicitud para una variable de dominio crítica URLs que no especifica la variable dinámica o utiliza un alias no válido, la solicitud fallará con un código de 400 estado HTTP. Los campos no críticos (SlateAdUrl,TranscodeProfileName, bumper URLs) registrarán las advertencias pero no rechazarán la solicitud.

Comportamiento alternativo para los alias faltantes

Cuando los alias de configuración no se encuentran o no son válidos, MediaTailor implementa el siguiente comportamiento alternativo:

  • Variables de dominio: si falta un alias de variable de dominio o no es válido, la solicitud falla con el código de estado HTTP 400. Todas las variables de dominio deben tener definidos alias válidos.

  • Variables que no son de dominio: en el caso de las variables que se utilizan en partes que no son de dominio URLs (como los elementos de ruta o los parámetros de consulta), si faltan alias, se reemplaza una cadena vacía.

  • Validación de la configuración: MediaTailor valida que todos los alias necesarios estén presentes durante las operaciones de creación y actualización de la configuración.

Paso 1: Crear alias de configuración

Para crear alias de configuración para utilizarlos en la sustitución de dominios mediante la MediaTailor consola, lleve a cabo el siguiente procedimiento.

Console
Para crear alias de configuración mediante la consola

  1. Abra la MediaTailor consola en. https://console.aws.amazon.com/mediatailor/

  2. En la sección Alias de configuración de la página de configuraciones, selecciona Añadir parámetro de reproductor.

  3. En Parámetro del reproductor, introduzca el nombre del parámetro del reproductor que desee utilizar como variable dinámica. Por ejemplo, player_params.origin_domain.

  4. En el caso de los alias, introduzca los alias y sus valores que desee utilizar para el parámetro del reproductor.

  5. Seleccione Aceptar.

    AWS Elemental MediaTailor muestra el nuevo parámetro en la tabla de la sección Alias de configuración.

  6. Repita los pasos anteriores para añadir más parámetros del reproductor.

  7. Seleccione Save.

API
Para crear alias de configuración mediante la API

Al crear o actualizar una MediaTailor configuración, utilice el ConfigurationAliases parámetro con la siguiente estructura JSON: 

{
                "ConfigurationAliases": {
                "player_params.origin_domain": {
                "pdx": "abc.mediapackage.us-west-2.amazonaws.com",
                "iad": "xyz.mediapackage.us-east-1.amazonaws.com"
                },
                "player_params.ad_type": {
                "customized": "abc12345",
                "default": "defaultAdType"
                }
                }
                }

Paso 2: Utilice los alias de configuración en la inicialización de la sesión

Después de configurar los alias de configuración, puede usarlos como variables de reemplazo para los dominios de su solicitud de inicialización de sesión. Esto le permite configurar dinámicamente los dominios de la sesión.

ejemplo Ejemplo de alias de configuración básica

Este es un ejemplo básico de una configuración que incluye alias de configuración y variables de dominio dinámicas:

PUT /playbackConfiguration
{
    "Name": "aliasedConfig",
    "AdDecisionServerUrl": "https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=[player_params.ad_type]",
    "VideoContentSourceUrl": "https://[player_params.origin_domain].mediapackage.[player_params.region].amazonaws.com/out/v1/[player_params.endpoint_id]",
    "ConfigurationAliases": {
        "player_params.origin_domain": {
            "pdx": "abc",
            "iad": "xyz"
        },
        "player_params.region": {
            "pdx": "us-west-2",
            "iad": "us-east-1"
        },
        "player_params.endpoint_id": {
            "pdx": "abcd",
            "iad": "wxyz"
        },
        "player_params.ad_type": {
            "customized": "abc12345",
            "default": "defaultAdType"
        }
    }
}
ejemplo Inicialización de la sesión con alias

Con la configuración anterior, una solicitud de inicialización de sesión que utilice las variables y los alias del reproductor tendría un aspecto similar al siguiente:

POST index.m3u8
{
    "playerParams": {
        "origin_domain": "pdx",
        "region": "pdx",
        "endpoint_id": "pdx",
        "ad_type": "customized"
    }
}

MediaTailor reemplaza las cadenas de alias por los valores mapeados en la configuración de los alias de configuración.

La solicitud al ADS tendrá el siguiente aspecto:

https://abc.execute-api.us-west-2.amazonaws.com/ads?sid=[session.id]&ad_type=abc12345

La solicitud de los manifiestos al origen tendrá el siguiente aspecto:

https://abc.mediapackage.us-west-2.amazonaws.com/out/v1/abcd