Erstellen und Verwenden von Konfigurationsaliasnamen mit MediaTailor - AWS Elemental MediaTailor
Schritt 1: Konfigurations-Aliase erstellenSchritt 2: Verwenden Sie Konfigurationsaliase bei der Sitzungsinitialisierung

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.

Erstellen und Verwenden von Konfigurationsaliasnamen mit MediaTailor

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.

Einschränkungen

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

  • 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 Domänenvariablen in Critical URLs (VideoContentSourceUrl,,AdSegmentUrlPrefix) vollständig sein. ContentSegmentUrlPrefix

  • Wenn eine Anfrage für eine Domainvariable mit dem Status Critical gestellt wird URLs , die entweder die dynamische Variable nicht spezifiziert oder einen ungültigen Alias verwendet, schlägt die Anfrage mit einem 400 HTTP-Statuscode fehl. Bei unkritischen Feldern (SlateAdUrl,TranscodeProfileName, Bumper URLs) werden zwar Warnungen protokolliert, die Anfrage wird jedoch nicht fehlschlagen.

Ausweichverhalten bei fehlenden Aliasen

Wenn Konfigurationsaliase nicht gefunden werden oder ungültig sind, MediaTailor implementiert das folgende Fallback-Verhalten:

  • Domain-Variablen: Wenn ein Domainvariablen-Alias fehlt oder ungültig ist, schlägt die Anfrage mit dem HTTP 400-Statuscode fehl. Für alle Domänenvariablen müssen gültige Aliase definiert sein.

  • Nicht-Domain-Variablen: Bei Variablen, die in Teilen verwendet werden, die nicht zur Domäne gehören URLs (wie Pfadelemente oder Abfrageparameter), führen fehlende Aliase dazu, dass leere Zeichenketten ersetzt werden.

  • Konfigurationsvalidierung: MediaTailor Überprüft, ob alle erforderlichen Aliase bei der Erstellung und Aktualisierung der Konfiguration vorhanden sind.

Schritt 1: Konfigurations-Aliase erstellen

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

Console
So erstellen Sie Konfigurationsaliase 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 unter Spielerparameter den Namen des Spielerparameters ein, den Sie als dynamische Variable verwenden möchten. Beispiel, player_params.origin_domain.

  4. Geben Sie unter Aliase die Aliase und ihre Werte ein, die Sie für den Player-Parameter verwenden möchten.

  5. Wählen Sie OK aus.

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

  6. Wiederholen Sie die vorherigen Schritte, um weitere Player-Parameter hinzuzufügen.

  7. Wählen Sie Speichern.

API
Um Konfigurationsaliase mithilfe der API zu erstellen

Wenn Sie eine MediaTailor Konfiguration erstellen oder aktualisieren, verwenden Sie den ConfigurationAliases Parameter mit der folgenden JSON-Struktur: 

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

Schritt 2: Verwenden Sie Konfigurationsaliase bei der Sitzungsinitialisierung

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.

Beispiel für Aliase für die Grundkonfiguration

Hier ist ein einfaches Beispiel für eine Konfiguration, die Konfigurationsaliase und dynamische Domänenvariablen umfasst:

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"
        }
    }
}
Beispiel Initialisierung der Sitzung mit Aliasen

Bei Verwendung der vorherigen Konfiguration würde eine Anfrage zur Sitzungsinitialisierung unter Verwendung der Spielervariablen und Aliase etwa wie folgt aussehen:

POST index.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 das ADS wird wie folgt aussehen:

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

Die Anfrage an die Quelle für die Manifeste wird wie folgt aussehen:

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