View a markdown version of this page

MediaTailor Dienstvariablen für die Sitzungssteuerung - AWS Elemental MediaTailor
Unterstützte Parameteraws.StartTimeaws.prerollaws.overlay ist verfügbarAWS.LogModeaws.avail SuppressionMode

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 Dienstvariablen für die Sitzungssteuerung

AWS Elemental MediaTailor reserviert den Namespace der aws. Abfrageparameter für Dienstvariablen, die das Verhalten auf Sitzungsebene steuern. Im Gegensatz zu ads. Parametern (die an das ADS weitergeleitet werden) und manifest. Parametern (die an die personalisierten Manifest-URLs angehängt werden) werden aws. Parameter direkt vom Ursprungsserver oder ADS verarbeitet MediaTailor und nicht an diesen weitergeleitet.

Unterstützte Parameter

In der folgenden Tabelle sind die aws.* Parameter aufgeführt, mit denen Sie das Verhalten auf Sitzungsebene steuern können.

Parameter Typ Werte Standard Description
aws.startTime ISO 8601-Zeitstempel Beispiel: 2026-06-17T10:00:00Z Nicht gesetzt (Live-Edge-Join) Startet die Sitzung an einer bestimmten Stelle im DVR-Fenster. MediaTailor löst den Zeitstempel bis zur nächsten Segmentgrenze auf und gibt ihn EXT-X-START:TIME-OFFSET im HLS-Manifest aus.
aws.preroll Zeichenfolgen-Aufzählung enabled, (unterscheidet nicht zwischen Groß- und Kleinschreibung) disabled enabled Steuert, ob Pre-Roll-Anzeigen für die Sitzung geschaltet werden. Wenndisabled, wird Pre-Roll unterdrückt, auch wenn die Wiedergabekonfiguration eine hat. LivePreRollConfiguration
aws.overlayAvails Zeichenfolgen-Aufzählung on, off (Groß- und Kleinschreibung wird nicht beachtet) on Steuert, ob Overlay (nichtlinear) und Avails für die Sitzung verarbeitet werden. Wennoff, werden Overlay-Anzeigenmarkierungen im Quellmanifest ignoriert und es werden keine Overlay-Anzeigen eingefügt.
aws.logMode Zeichenfolgen-Aufzählung DEBUG, DISABLED DISABLED Aktiviert die ausführliche Debug-Protokollierung für die Sitzung. Wenn auf gesetztDEBUG, MediaTailor werden detaillierte Sitzungsprotokolle zur Problembehandlung in CloudWatch Logs gespeichert.
aws.availSuppressionMode Zeichenfolgen-Aufzählung OFF, AFTER_LIVE_EDGE (unterscheidet nicht zwischen Groß- BEHIND_LIVE_EDGE und Kleinschreibung) OFF Steuert anhand ihrer Position relativ zur Live-Kante, ob Werbeanzeigen unterdrückt werden.
aws.availSuppressionValue Zeitliche Dauer HH:MM:SS Format (zum Beispiel00:00:10) Nicht gesetzt Das Zeitfenster für die Auslöschung eines Fehlers. Erforderlich, wenn BEHIND_LIVE_EDGE oder availSuppressionMode AFTER_LIVE_EDGE ist.
aws.availSuppressionFillPolicy Zeichenfolgen-Aufzählung FULL_AVAIL_ONLY, PARTIAL_AVAIL (Groß- und Kleinschreibung wird nicht beachtet) FULL_AVAIL_ONLY Wenn Modus aktiviert istAFTER_LIVE_EDGE, steuert es, ob teilweise unterdrückte Felder gefüllt werden.

aws.StartTime

Wenn gesetzt aws.startTime ist, wird die Sitzung MediaTailor an der Segmentgrenze gestartet, die der angegebenen Programm-Datum/Uhrzeit am nächsten ist.

Usage

Übergeben Sie aws.startTime als Abfrageparameter in der Manifestanforderung:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.startTime=2026-06-17T10:00:00Z

Oder übergeben Sie es bei der expliziten Sitzungsinitialisierung als Feld der obersten Ebene ohne das aws. Präfix:

POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8

{
    "startTime": "2026-06-17T10:00:00Z"
}
Voraussetzungen

Die folgenden Anforderungen gelten für: aws.startTime

  • Das Quell-Manifest muss Segmente EXT-X-PROGRAM-DATE-TIME (PDT) enthalten. Ohne PDT kann es aws.startTime nicht aufgelöst werden und wird ignoriert.

  • Gilt nur für HLS-Live-Sitzungen (sowohl SSAI als auch SGAI).

Behavior

In der folgenden Tabelle wird beschrieben, wie aws.startTime sich das Verhalten in verschiedenen Szenarien verhält:

Szenario Ergebnis
Zeitstempel im DVR-Fenster An der nächsten Segmentgrenze beginnen und emittieren EXT-X-START
Zeitstempel, der älter als das DVR-Fenster ist Vom Fensterkopf aus auf 3×TargetDuration festklemmen
Zeitstempel innerhalb von 3×TargetDuration von Live Edge Als Live-Edge-Join behandeln (nein) EXT-X-START
Zeitstempel am oder nach dem Live-Edge Normaler Live-Edge-Join
Falsch formatiert oder nicht ISO 8601 Ignoriert — Fallback auf Live-Edge-Join, Fehler protokolliert
Das Manifest hat kein PDT Ignoriert — Fallback auf Live-Edge-Join, Fehler protokolliert
Parameter weggelassen Standard: normaler Live-Edge-Join
Verhalten beim Klemmen

Wenn der Startpunkt während der Sitzung außerhalb des DVR-Fensters EXT-X-START liegt, wird er vom Fensterkopf auf 3×TargetDuration begrenzt. Der 3×TargetDuration-Puffer entspricht den Empfehlungen von RFC 8216 §6.3.3 zur Pufferung von Playern.

Beispiel Manifestausgabe mit aws.StartTime

Wenn ein Spieler eine Sitzung mit dem Live-Edge initialisiert aws.startTime=2026-06-17T10:00:00Z und der aufgelöste Offset 120 Sekunden vom Live-Edge entfernt ist, wird Folgendes ausgegeben: MediaTailor 

#EXTM3U
#EXT-X-TARGETDURATION:6
#EXT-X-START:TIME-OFFSET=-120.120,PRECISE=YES
#EXT-X-MEDIA-SEQUENCE:500
#EXT-X-PROGRAM-DATE-TIME:2026-06-17T09:58:00.000Z
#EXTINF:6.006,
segment500.ts
#EXTINF:6.006,
segment501.ts
...

Der TIME-OFFSET=-120.120 weist den Spieler an, die Wiedergabe 120 Sekunden hinter dem Live-Edge an der Segmentgrenze zu beginnen, die der angeforderten Startzeit am nächsten ist.

Einschränkungen

Die folgenden Einschränkungen gelten:

  • Sie können diesen Parameter nach der Sitzungsinitialisierung nicht ändern.

  • EXT-X-PROGRAM-DATE-TIMEErforderlich im Quellmanifest.

  • EXT-X-STARTist ein Spielerhinweis — es MediaTailor kann nicht garantiert werden, dass alle Spieler ihn einhalten.

aws.preroll

Wennaws.preroll=disabled, MediaTailor unterdrückt das Einfügen von Pre-Roll-Anzeigen für die Sitzung, auch wenn die Wiedergabekonfiguration eine hat. LivePreRollConfiguration

Usage

Übergeben Sie aws.preroll als Abfrageparameter in der Manifest-Anfrage:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.preroll=disabled

Oder übergeben Sie es bei der expliziten Sitzungsinitialisierung als Feld der obersten Ebene ohne das aws. Präfix:

POST /v1/session/{hashed-account-id}/{origin-id}/{asset}.m3u8

{
    "preroll": "disabled"
}
Voraussetzungen

Die folgenden Anforderungen gelten für: aws.preroll

  • Die Wiedergabekonfiguration muss einen haben, LivePreRollConfiguration damit dieser Parameter eine Wirkung hat. Wenn kein Pre-Roll konfiguriert ist, hat die Einstellung dieses Parameters keine Auswirkung.

  • Gilt für HLS-Live-Sitzungen (sowohl SSAI als auch SGAI).

Behavior

In der folgenden Tabelle wird das Verhalten beschrieben: aws.preroll

Wert Ergebnis
enabled(oder weggelassen) Pre-roll wie gewohnt eingefügt
disabled Pre-roll für diese Sitzung unterdrückt
Ungültiger Wert Als Fehler protokolliert, behandelt als enabled
Einschränkungen

Sie können diesen Parameter nach der Sitzungsinitialisierung nicht ändern.

aws.overlay ist verfügbar

Wennaws.overlayAvails=off, MediaTailor ignoriert Overlay-Werbemarkierungen (nichtlineare) im Quellmanifest und fügt keine Overlay-Anzeigen für die Sitzung ein.

Usage

Übergeben Sie aws.overlayAvails als Abfrageparameter in der Manifestanforderung:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.overlayAvails=off
Voraussetzungen

Die folgenden Anforderungen gelten füraws.overlayAvails:

  • Das Quell-Manifest muss Overlay-Anzeigenmarkierungen enthalten (z. B. SCTE-35 Ereignisse mit dem Typ „Overlay-Segmentierung“), damit dieser Parameter eine Wirkung hat.

  • Gilt für HLS- und DASH-, Live- und VOD-Sitzungen (sowohl SSAI als auch SGAI).

Behavior

In der folgenden Tabelle wird das Verhalten beschrieben: aws.overlayAvails

Wert Ergebnis
on(oder weggelassen) Overlay-Angebote werden wie gewohnt verarbeitet und Anzeigen eingefügt
off Overlay-Anzeigenmarkierungen werden ignoriert, es werden keine Overlay-Anzeigen eingefügt
Ungültiger Wert Als Fehler protokolliert, als nicht angegeben behandelt (Standard:on)
Einschränkungen

Sie können diesen Parameter nach der Sitzungsinitialisierung nicht ändern.

AWS.LogMode

Wennaws.logMode=DEBUG, MediaTailor aktiviert die ausführliche Debug-Protokollierung für die Sitzung. Debug-Protokolle werden an CloudWatch Logs ausgegeben und enthalten detaillierte Informationen über die Personalisierung von Manifesten, die Serveranforderungen für die Anzeigenentscheidung und den Sitzungsstatus. Dies ist hilfreich bei der Behebung von Problemen mit der Anzeigenschaltung.

Usage

Übergeben Sie aws.logMode als Abfrageparameter in der Manifest-Anfrage:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.logMode=DEBUG
Voraussetzungen

Die folgenden Anforderungen gelten füraws.logMode:

  • In der Wiedergabekonfiguration muss die Protokollierung aktiviert (PercentEnabled > 0oder EnabledLoggingStrategies konfiguriert) sein, damit Debug-Logs ausgegeben werden.

  • Die Debug-Protokollierung ist pro Kunde begrenzt, um ein übermäßiges Protokollvolumen zu vermeiden.

Behavior

In der folgenden Tabelle wird das Verhalten aws.logMode beschrieben:

Wert Ergebnis
DEBUG Für die Sitzung werden ausführliche Debug-Protokolle ausgegeben
DISABLED(oder weggelassen) Normales Protokollierungsverhalten (basierend auf den Einstellungen der Wiedergabekonfiguration)
Ungültiger Wert Fehler ausgelöst, Sitzungsinitialisierung schlägt fehl
Einschränkungen

Die folgenden Einschränkungen gelten:

  • Sie können diesen Parameter nach der Sitzungsinitialisierung nicht ändern.

  • Bei Werten wird zwischen Groß- und Kleinschreibung unterschieden (DEBUG, nichtdebug).

aws.avail SuppressionMode

Steuert anhand ihrer Position relativ zum Live-Edge, ob Werbeanzeigen unterdrückt werden. Nutze diese Option, um Werbeunterbrechungen zu überspringen, die innerhalb eines Zeitfensters hinter oder nach dem Live-Rand liegen — zum Beispiel, um zu vermeiden, dass Werbeunterbrechungen überfüllt werden, die Zuschauer bereits passiert haben, als sie mitten im Event einem Livestream beitraten.

Usage

Übergeben Sie verfügbare Unterdrückungsparameter als Abfrageparameter in der Manifestanforderung:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10

Dieser Parameter funktioniert mit zwei Begleitparametern:

  • aws.availSuppressionValue— Das Zeitfenster (erforderlich, wenn der Modus nicht aktiviert istOFF)

  • aws.availSuppressionFillPolicy— Steuert das Verhalten beim teilweisen Füllen (gilt nur für den AFTER_LIVE_EDGE Modus)

Voraussetzungen

Die folgenden Anforderungen gelten für verfügbare Unterdrückungsparameter:

  • Gilt für HLS- und DASH-Live-Sitzungen.

  • aws.availSuppressionValuemuss im HH:MM:SS Format angegeben werden, wenn Modus BEHIND_LIVE_EDGE oder AFTER_LIVE_EDGE ist.

  • aws.availSuppressionFillPolicyist nur gültig, wenn der Modus aktiviert istAFTER_LIVE_EDGE.

Verhalten im Modus

In der folgenden Tabelle werden die Auswirkungen der einzelnen Unterdrückungsmodi beschrieben:

Mode Auswirkung
OFF(oder weggelassen) Keine effektive Unterdrückung — alle Werbeunterbrechungen werden normal gefüllt
BEHIND_LIVE_EDGE Unterdrückt Werbeunterbrechungen, die innerhalb des angegebenen Zeitfensters hinter dem Live-Edge beginnen
AFTER_LIVE_EDGE Unterdrückt Werbeunterbrechungen, die nach dem angegebenen Zeitfenster vom Live-Edge aus beginnen
Richtlinie ausfüllen (nur AFTER_LIVE_EDGE)

In der folgenden Tabelle wird das Verhalten der Füllrichtlinie beschrieben, wenn der Modus aktiviert ist: AFTER_LIVE_EDGE

Richtlinie ausfüllen Auswirkung
FULL_AVAIL_ONLY (Standard) Füllen Sie nur Felder aus, die vollständig außerhalb des Unterdrückungsfensters liegen
PARTIAL_AVAIL Füllen Sie den Teil eines Fehlers aus, der über das Unterdrückungsfenster hinausgeht
Beispiel Beispiel für die Unterdrückung von Avail

Die folgende Anforderung unterdrückt Werbeunterbrechungen innerhalb von 10 Sekunden hinter dem Live-Edge:

GET /v1/master/{hashed-account-id}/{origin-id}/{asset}.m3u8?aws.availSuppressionMode=BEHIND_LIVE_EDGE&aws.availSuppressionValue=00:00:10
Einschränkungen

Die folgenden Einschränkungen gelten:

  • Sie können diesen Parameter nach der Sitzungsinitialisierung nicht ändern.

  • aws.availSuppressionValuedarf nicht angegeben werden, wenn der Modus aktiviert istOFF.

  • Ungültiges Zeitformat aws.availSuppressionValue führt dazu, dass auf den Modus zurückgegriffen wirdOFF.