Criação e uso de aliases de configuração com MediaTailor - AWS Elemental MediaTailor
Etapa 1: criar aliases de configuraçãoEtapa 2: Usar aliases de configuração na inicialização da sessão

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criação e uso de aliases de configuração com MediaTailor

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.

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 variáveis de domínio em estado crítico URLs (VideoContentSourceUrl,,AdSegmentUrlPrefix). ContentSegmentUrlPrefix

  • Se for feita uma solicitação para uma variável de domínio crítica URLs que não especifique a variável dinâmica ou use um alias inválido, a solicitação falhará com um código de 400 status HTTP. Campos não críticos (SlateAdUrl,TranscodeProfileName, bumper URLs) registrarão os avisos, mas não falharão na solicitação.

Comportamento alternativo para aliases ausentes

Quando os aliases de configuração não são encontrados ou são inválidos, MediaTailor implementa o seguinte comportamento de fallback:

  • Variáveis de domínio: se um alias de variável de domínio estiver ausente ou for inválido, a solicitação falhará com o código de status HTTP 400. Todas as variáveis de domínio devem ter aliases válidos definidos.

  • Variáveis que não são de domínio: para variáveis usadas em partes que não são de domínio URLs (como elementos de caminho ou parâmetros de consulta), aliases ausentes resultam na substituição de uma string vazia.

  • Validação de configuração: MediaTailor valida se todos os aliases necessários estão presentes durante as operações de criação e atualização da configuração.

Etapa 1: criar 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.

Console
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. Em Parâmetro do jogador, insira o nome do parâmetro do jogador que você deseja usar como uma variável dinâmica. Por exemplo, .player_params.origin_domain

  4. Em Aliases, insira os aliases e seus valores que você deseja usar para o parâmetro do player.

  5. Escolha OK.

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

  6. Repita as etapas anteriores para adicionar mais parâmetros do player.

  7. Escolha Salvar.

API
Para criar aliases de configuração usando a API

Ao criar ou atualizar uma MediaTailor configuração, use o ConfigurationAliases parâmetro com a seguinte estrutura 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"
                }
                }
                }

Etapa 2: Usar aliases de configuração na inicialização da 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.

exemplo Exemplo de aliases de configuração básica

Aqui está um exemplo básico de uma configuração que inclui aliases de configuração e variáveis dinâmicas de domínio:

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"
        }
    }
}
exemplo Inicialização da sessão com aliases

Usando a configuração anterior, uma solicitação de inicialização de sessão usando as variáveis e os aliases do player seria semelhante à seguinte:

POST index.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 terá a seguinte aparência:

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

A solicitação à origem dos manifestos terá a seguinte aparência:

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