View a markdown version of this page

MediaTailor Parameter, Sitzungsverhalten und Persistenz - AWS Elemental MediaTailor

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.

MediaTailor Parameter, Sitzungsverhalten und Persistenz

AWS Elemental MediaTailor verarbeitet Parameter bei der Sitzungsinitialisierung und verwaltet sie während des gesamten Sitzungslebenszyklus. Das Verständnis des Sitzungsverhaltens ist entscheidend für die Implementierung dynamischer Parameterszenarien.

Methoden zur Sitzungsinitialisierung

MediaTailor unterstützt mehrere Methoden für die Sitzungsinitialisierung mit Parametern:

  1. Implizite Sitzungsinitialisierung: Parameter, die in der ersten Manifestanforderung enthalten sind

    GET /v1/master/123456789/originId/index.m3u8?manifest.auth_token=abc123&start=2024-08-26T10:00:00Z

  2. Explizite Sitzungsinitialisierung (POST): Im Anforderungstext angegebene Parameter

    POST /v1/session/123456789/originId/index.m3u8
{
    "adsParams": {"param1": "value1"},
    "manifestParams": {"auth_token": "abc123"}
}

  3. Explizite Sitzungsinitialisierung (GET): Als Abfrageparameter bereitgestellte Parameter

    GET /v1/session/123456789/originId/index.m3u8?ads.param1=value1&manifestParams.auth_token=abc123
Persistenz und Unveränderlichkeit von Parametern

MediaTailor Das Verhalten von Parametern folgt diesen Regeln:

  • One-time Spezifikation: Parameter können nur einmal, bei der Sitzungsinitialisierung, angegeben werden

  • Session-wide Persistenz: Die Parameter werden während der gesamten Sitzung beibehalten

  • Unveränderlich nach der Initialisierung: Parameter können nicht geändert werden, nachdem die Sitzung erstellt wurde

  • Auflösung des Konfigurationsalias: Aliase werden in tatsächliche Werte aufgelöst, bevor sie an Ziele weitergeleitet werden

Szenarien zur Änderung von Parametern

Um Parameter während der Wiedergabe zu ändern:

  • Neue Sitzung erstellen: Initialisieren Sie eine neue Sitzung mit aktualisierten Parameterwerten

  • Spielerübergang: Führe den Spieler nahtlos zur neuen Sitzung um

  • Parametervererbung: Zur Wahrung der Konsistenz werden unveränderte Parameter übernommen

BeispielÄndern von Zeitverschiebungsparametern

Um von einem 1-Stunden-Fenster zu einem 2-Stunden-Fenster zu wechseln:

  1. Aktuelle Sitzung: start=2024-08-26T10:00:00Z&end=2024-08-26T11:00:00Z

  2. Neue Sitzung erstellen: start=2024-08-26T10:00:00Z&end=2024-08-26T12:00:00Z

  3. Stellen Sie den Player auf die neue Sitzungs-URL um

Wichtig

Bei mehreren multivarianten Playlist-Anfragen für eine einzelne Sitzung werden die Parameter nach der ersten Anfrage nicht aktualisiert. Die Parameter bleiben für die Dauer der Sitzung unveränderlich.