Creazione e utilizzo di alias di configurazione con MediaTailor

Prima di iniziare a utilizzare le variabili di dominio, create alias di configurazione per la configurazione. Gli alias di configurazione vengono utilizzati come variabili sostitutive del dominio al momento dell'inizializzazione della sessione.

Restrizioni

Tieni presente le seguenti restrizioni quando usi gli alias di configurazione:

• Tutte le variabili dinamiche utilizzate nel dominio devono essere definite come variabili ConfigurationAliases dinamiche.

• Le variabili dei parametri del giocatore devono avere il prefisso. player_params. Ad esempio, player_params.origin_domain.

• L'elenco dei valori con alias deve essere esaustivo per le variabili di dominio in modalità critica URLs (VideoContentSourceUrl,,AdSegmentUrlPrefix). ContentSegmentUrlPrefix

• Se viene effettuata una richiesta per una variabile di dominio in modalità critica URLs che non specifica la variabile dinamica o utilizza un alias non valido, la richiesta avrà esito negativo con un codice di stato HTTP. 400 I campi non critici (SlateAdUrl,TranscodeProfileName, bumper URLs) registreranno gli avvisi ma non falliranno la richiesta.

Comportamento di riserva per gli alias mancanti

Quando gli alias di configurazione non vengono trovati o non sono validi, MediaTailor implementa il seguente comportamento di fallback:

• Variabili di dominio: se un alias di variabile di dominio è mancante o non valido, la richiesta ha esito negativo con il codice di stato HTTP 400. Tutte le variabili di dominio devono avere alias validi definiti.

• Variabili non di dominio: per le variabili utilizzate in parti non di dominio URLs (come elementi di percorso o parametri di query), gli alias mancanti comportano la sostituzione di stringhe vuote.

• Convalida della configurazione: MediaTailor verifica che tutti gli alias richiesti siano presenti durante le operazioni di creazione e aggiornamento della configurazione.

Fase 1: Creare alias di configurazione

Per creare alias di configurazione da utilizzare per la sostituzione del dominio tramite la MediaTailor console, eseguire la procedura seguente.

Console

Per creare alias di configurazione utilizzando la console

1. Apri la MediaTailor console all'indirizzo https://console.aws.amazon.com/mediatailor/.

2. Nella sezione Alias di configurazione della pagina Configurazioni, scegli Aggiungi parametro giocatore.

3. Per Parametro Player, inserisci il nome del parametro player che desideri utilizzare come variabile dinamica. Ad esempio, player_params.origin_domain.

4. Per Alias, inserisci gli alias e i relativi valori che desideri utilizzare per il parametro player.

5. Scegli OK.

   AWS Elemental MediaTailor visualizza il nuovo parametro nella tabella della sezione Alias di configurazione.

6. Ripeti i passaggi precedenti per aggiungere altri parametri del giocatore.

7. Scegli Save (Salva).

API

Per creare alias di configurazione utilizzando l'API

Quando crei o aggiorni una MediaTailor configurazione, utilizza il ConfigurationAliases parametro con la seguente struttura 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"
                }
                }
                }

Passaggio 2: utilizzare gli alias di configurazione nell'inizializzazione della sessione

Dopo aver impostato gli alias di configurazione, è possibile utilizzarli come variabili sostitutive per i domini nella richiesta di inizializzazione della sessione. Ciò consente di configurare dinamicamente i domini per la sessione.

Esempio di alias di configurazione di base

Ecco un esempio di base di configurazione che include alias di configurazione e variabili di dominio dinamiche:

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

Esempio Inizializzazione della sessione con alias

Utilizzando la configurazione precedente, una richiesta di inizializzazione della sessione che utilizza le variabili e gli alias del player sarebbe simile alla seguente:

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

MediaTailor sostituisce le stringhe di alias con i valori mappati nella configurazione degli alias di configurazione.

La richiesta all'ADS sarà simile alla seguente:

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

La richiesta all'origine dei manifesti sarà simile alla seguente:

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