Uso de variables de dominio

Con las variables de dominio dinámicas, puede usar varios dominios, como la parte my-ads-server.com de la URL http://my-ads-server.com, con los parámetros del reproductor en su configuración. Esto te permite usar más de una fuente de contenido o un servidor de decisiones publicitarias (ADS) en una sola configuración.

Puedes usar variables de dominio con cualquier parámetro que contenga un URI:

• AdDecisionServerUrl

• AdSegmentUrlPrefix

• ContentSegmentUrlPrefix

• LivePreroll.AdDecisionServerUrl

• VideoContentSourceUrl

Las variables de dominio se utilizan junto con los alias de configuración para sustituir las variables de forma dinámica. Los alias de configuración asignan un conjunto de alias y valores a los parámetros del reproductor que se utilizan para la configuración dinámica del dominio.

Crear alias de configuración para usarlos como variables dinámicas

Antes de empezar a utilizar variables de dominio, debe crear alias de configuración para la 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. Por ejemplo, puede usar los alias de configuración para configurar dinámicamente una URL de origen durante la inicialización de la sesión.

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.

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. Escriba el nombre del parámetro del reproductor que desee usar como variable dinámica para reemplazar el dominio. Debe anteponer el nombre. player_params.

4. Seleccione OK (Aceptar).

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

5. Ahora, añadirá un alias y un valor. Selecciona el parámetro del reproductor que acabas de nombrar. Esto expande la sección situada debajo del nombre del parámetro.

   Seleccione Añadir un nuevo alias.

6. Introduzca una clave y un valor de alias. MediaTailor usa Value como valor de reemplazo para la variable de dominio.

Uso de alias de configuración para configurar dinámicamente los dominios de una 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.

Restricciones

Tenga en cuenta las siguientes restricciones cuando utilice 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 cada parámetro del reproductor.

• Si se solicita un valor dinámico que se usa en el dominio y esa solicitud no especifica la variable dinámica o uno de los alias preconfigurados para esa variable, la solicitud fallará y mostrará un código de estado HTTP400.

ejemplo Ejemplo de uso

A continuación, se muestra un ejemplo de configuración que incluye alias de configuración y variables de dominio dinámicas. Presta especial atención a las variables de los parámetros del reproductor, por ejemplo[player_params.origin_domain], en los dominios de VideoContentSourceUrl parámetros AdDecisionServerUrl y.

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

Con la configuración anterior, cree una solicitud de inicialización de sesión, especificando las variables y los alias del reproductor:

POST master.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 tiene el siguiente aspecto:

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

La solicitud al VideoContentSource se ve así:

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