Utilizzo di variabili di dominio

Con le variabili di dominio dinamiche, puoi utilizzare più domini, ad esempio la parte my-ads-server.com dell'URL http://my-ads-server.com, con i parametri del player nella tua configurazione. In questo modo è possibile utilizzare più di una fonte di contenuto o un ad decision server (ADS) in un'unica configurazione.

Puoi utilizzare le variabili di dominio con qualsiasi parametro che contenga un URI:

• AdDecisionServerUrl

• AdSegmentUrlPrefix

• ContentSegmentUrlPrefix

• LivePreroll.AdDecisionServerUrl

• VideoContentSourceUrl

Le variabili di dominio vengono utilizzate insieme agli alias di configurazione per eseguire la sostituzione dinamica delle variabili. Gli alias di configurazione mappano un insieme di alias e valori ai parametri del player utilizzati per la configurazione dinamica del dominio.

Creazione di alias di configurazione da utilizzare come variabili dinamiche

Prima di iniziare a utilizzare le variabili di dominio, create degli alias di configurazione per la configurazione. Gli alias di configurazione vengono utilizzati come variabili sostitutive del dominio al momento dell'inizializzazione della sessione. Ad esempio, è possibile utilizzare gli alias di configurazione per configurare dinamicamente un URL di origine durante l'inizializzazione della sessione.

Creazione di alias di configurazione

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

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. Digita il nome del parametro del giocatore che desideri utilizzare come variabile dinamica per la sostituzione del dominio. È necessario aggiungere al nome il prefisso. player_params.

4. Scegli OK.

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

5. Ora aggiungerai un alias e un valore. Seleziona il parametro del giocatore a cui hai appena dato un nome. Questo espande la sezione sotto il nome del parametro.

   Seleziona Aggiungi nuovo alias.

6. Inserisci una chiave e un valore di alias. MediaTailor utilizza Value come valore sostitutivo per la variabile di dominio.

Utilizzo degli alias di configurazione per configurare dinamicamente i domini per una 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.

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 ogni parametro del giocatore.

• Se viene effettuata una richiesta per un valore dinamico utilizzato nel dominio e tale richiesta non specifica la variabile dinamica o uno degli alias preconfigurati per quella variabile, la richiesta avrà esito negativo e verrà visualizzato un codice di stato HTTP. 400

Esempio di utilizzo

Ecco un esempio di configurazione che include alias di configurazione e variabili di dominio dinamiche. Presta particolare attenzione alle variabili dei parametri del giocatore[player_params.origin_domain], ad esempio nei domini AdDecisionServerUrl e VideoContentSourceUrl parametrici.

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

Utilizzando la configurazione precedente, create una richiesta di inizializzazione della sessione, specificando le variabili e gli alias del player:

POST master.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 ha il seguente aspetto:

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

La richiesta a VideoContentSource ha il seguente aspetto:

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