Verwenden von Domänenvariablen - AWS Elemental MediaTailor
Konfigurationsaliase zur Verwendung als dynamische Variablen erstellenVerwendung von Konfigurationsaliasnamen zur dynamischen Konfiguration von Domänen für eine Sitzung

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Verwenden von Domänenvariablen

Mit dynamischen Domänenvariablen können Sie mehrere Domänen, z. B. den my-ads-server.com-Teil von URL http://my-ads-server.com, mit den Player-Parametern in Ihrer Konfiguration verwenden. Auf diese Weise können Sie mehr als eine Inhaltsquelle oder einen Anzeigenentscheidungsserver (ADS) in einer einzigen Konfiguration verwenden.

Sie können Domänenvariablen mit jedem Parameter verwenden, der Folgendes enthältURI:

  • AdDecisionServerUrl

  • AdSegmentUrlPrefix

  • ContentSegmentUrlPrefix

  • LivePreroll.AdDecisionServerUrl

  • VideoContentSourceUrl

Domänenvariablen werden zusammen mit Konfigurationsaliasnamen verwendet, um dynamische Variablen zu ersetzen. Konfigurationsaliase ordnen den Player-Parametern, die für die dynamische Domänenkonfiguration verwendet werden, eine Reihe von Aliasnamen und Werten zu.

Konfigurationsaliase zur Verwendung als dynamische Variablen erstellen

Bevor Sie mit der Verwendung von Domänenvariablen beginnen, erstellen Sie Konfigurationsaliase für Ihre Konfiguration. Sie verwenden die Konfigurationsaliase bei der Initialisierung der Sitzung als Variablen für den Domänenersatz. Sie können beispielsweise Konfigurationsaliase verwenden, um einen Ursprung URL während der Sitzungsinitialisierung dynamisch zu konfigurieren.

Konfigurations-Aliase erstellen

Gehen Sie wie folgt vor, um Konfigurationsaliase für den Domainersatz mithilfe der MediaTailor Konsole zu erstellen.

So erstellen Sie Konfigurations-Aliase mithilfe der Konsole

  1. Öffnen Sie die MediaTailor Konsole unter. https://console.aws.amazon.com/mediatailor/

  2. Wählen Sie auf der Konfigurationsseite im Abschnitt Konfigurationsaliase die Option Player-Parameter hinzufügen aus.

  3. Geben Sie den Namen des Player-Parameters ein, den Sie als dynamische Variable für den Domainersatz verwenden möchten. Sie müssen dem Namen ein Präfix voranstellenplayer_params..

  4. Wählen Sie OK aus.

    AWS Elemental MediaTailor zeigt den neuen Parameter in der Tabelle im Abschnitt Konfigurationsaliase an.

  5. Jetzt fügen Sie einen Alias und einen Wert hinzu. Wählen Sie den Player-Parameter aus, den Sie gerade benannt haben. Dadurch wird der Abschnitt unter dem Parameternamen erweitert.

    Wählen Sie Neuen Alias hinzufügen aus.

  6. Geben Sie einen Aliasschlüssel und einen Wert ein. MediaTailor verwendet Value als Ersatzwert für die Domänenvariable.

Verwendung von Konfigurationsaliasnamen zur dynamischen Konfiguration von Domänen für eine Sitzung

Nachdem Sie die Konfigurationsaliase eingerichtet haben, können Sie sie als Ersatzvariablen für Domänen in Ihrer Anfrage zur Sitzungsinitialisierung verwenden. Auf diese Weise können Sie die Domänen für Ihre Sitzung dynamisch konfigurieren.

Einschränkungen

Beachten Sie bei der Verwendung von Konfigurationsaliasen die folgenden Einschränkungen:

  • Alle in der Domain verwendeten dynamischen Variablen müssen als ConfigurationAliases dynamische Variable definiert werden.

  • Den Player-Parametervariablen muss ein Präfix vorangestellt werden. player_params. Beispiel, player_params.origin_domain.

  • Die Liste der Aliaswerte muss für jeden Spielerparameter vollständig sein.

  • Wenn eine Anforderung für einen dynamischen Wert gestellt wird, der in der Domain verwendet wird, und diese Anfrage entweder nicht die dynamische Variable oder einen der vorkonfigurierten Aliase für diese Variable spezifiziert, schlägt die Anfrage mit einem Statuscode fehl. HTTP 400

Beispiel für die Verwendung

Hier ist ein Beispiel für eine Konfiguration, die Konfigurationsaliase und dynamische Domänenvariablen enthält. Achten Sie besonders auf die Player-Parametervariablen, z. B. [player_params.origin_domain] in den VideoContentSourceUrl Parameter-Domänen AdDecisionServerUrl und.

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

Erstellen Sie anhand der obigen Konfiguration eine Anfrage zur Initialisierung der Sitzung und geben Sie dabei die Player-Variablen und Aliase an: 

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

MediaTailor ersetzt die Aliaszeichenfolgen durch die zugewiesenen Werte in der Konfiguration der Konfigurationsaliase.

Die Anfrage an die ADS sieht wie folgt aus: 

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

Die Anfrage an die VideoContentSource sieht so aus: 

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