Usando variáveis de domínio

Com variáveis de domínio dinâmicas, você pode usar vários domínios, como a parte my-ads-server.com da URL http://my-ads-server.com, com os parâmetros do player em sua configuração. Isso possibilita que você use mais de uma fonte de conteúdo ou servidor de decisão de anúncios (ADS) em uma única configuração.

Você pode usar variáveis de domínio com qualquer parâmetro que contenha um URI:

• AdDecisionServerUrl

• AdSegmentUrlPrefix

• ContentSegmentUrlPrefix

• LivePreroll.AdDecisionServerUrl

• VideoContentSourceUrl

As variáveis de domínio são usadas junto com os aliases de configuração para realizar a substituição dinâmica de variáveis. Os aliases de configuração mapeiam um conjunto de aliases e valores para os parâmetros do player que são usados para a configuração dinâmica do domínio.

Criação de aliases de configuração para usar como variáveis dinâmicas

Antes de começar a usar variáveis de domínio, você cria aliases de configuração para sua configuração. Você usa os aliases de configuração como variáveis de substituição de domínio no momento da inicialização da sessão. Por exemplo, você pode usar aliases de configuração para configurar dinamicamente uma URL de origem durante a inicialização da sessão.

Criação de aliases de configuração

Para criar aliases de configuração a serem usados para substituição de domínio usando o MediaTailor console, execute o procedimento a seguir.

Para criar aliases de configuração usando o console

1. Abra o MediaTailor console em https://console.aws.amazon.com/mediatailor/.

2. Na seção Apelidos de configuração na página Configurações, escolha Adicionar parâmetro de player.

3. Digite o nome do parâmetro do player que você gostaria de usar como variável dinâmica para substituição de domínio. Você deve prefixar o nome complayer_params..

4. Escolha OK.

   AWS Elemental MediaTailorexibe o novo parâmetro na tabela na seção Apelidos de configuração.

5. Agora, você adicionará um alias e um valor. Selecione o parâmetro do player que você acabou de nomear. Isso expande a seção abaixo do nome do parâmetro.

   Selecione Adicionar novo alias.

6. Insira uma chave de alias e um valor. MediaTailor usa Value como o valor de substituição da variável de domínio.

Usando aliases de configuração para configurar dinamicamente domínios para uma sessão

Depois de configurar os aliases de configuração, você pode usá-los como variáveis de substituição para domínios na solicitação de inicialização da sessão. Isso permite que você configure dinamicamente os domínios da sua sessão.

Restrições

Observe as seguintes restrições ao usar aliases de configuração:

• Todas as variáveis dinâmicas usadas no domínio devem ser definidas como variáveis ConfigurationAliases dinâmicas.

• As variáveis dos parâmetros do player devem ser prefixadas complayer_params.. Por exemplo, player_params.origin_domain.

• A lista de valores com alias deve ser exaustiva para cada parâmetro do jogador.

• Se uma solicitação for feita para um valor dinâmico usado no domínio e essa solicitação não especificar a variável dinâmica ou um dos aliases pré-configurados para essa variável, a solicitação falhará com um código de 400 status HTTP.

exemplo Exemplo de uso

Aqui está um exemplo de uma configuração que inclui aliases de configuração e variáveis dinâmicas de domínio. Preste atenção especial às variáveis de parâmetros do player[player_params.origin_domain], como nos domínios de VideoContentSourceUrl parâmetros AdDecisionServerUrl e.

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

Usando a configuração anterior, crie uma solicitação de inicialização de sessão, especificando as variáveis e os aliases do player:

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

MediaTailor substitui as cadeias de caracteres de aliases pelos valores mapeados na configuração de aliases de configuração.

A solicitação para o ADS tem a seguinte aparência:

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

A solicitação para o VideoContentSource tem a seguinte aparência:

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