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. # Mit dem Zeitplan arbeiten ()AWS CLI Sie können den verwenden AWS CLI , um programmgesteuert mit dem Zeitplan zu arbeiten. In den Abschnitten weiter unten in diesem Kapitel wird beschrieben, wie Sie die entsprechenden Befehle eingeben. In diesen Abschnitten wird davon ausgegangen, dass Sie mit den Grundlagen der Verwendung der AWS CLI vertraut sind. Informationen zu den Grundlagen finden Sie in der [AWS CLI Befehlsreferenz](https://docs.aws.amazon.com/cli/latest/reference/). In den folgenden Abschnitten werden die einzelnen Befehle beschrieben und diese zusätzlichen Informationen bereitgestellt: + Eine Beschreibung der AWS CLI Befehlssyntax. + Eine Beschreibung des Schemas für die JSON-Nutzlast der Anforderung oder Antwort. Diese Nutzlast wird mithilfe der Syntax für die AWS CLI angezeigt. + Ein Beispiel für die JSON-Nutzlast der Anforderung oder Antwort. Diese Nutzlast wird auch mithilfe der AWS CLI-Syntax für angezeigt. Für Einzelheiten zu den JSON-Inhalten empfehlen wir Ihnen, die [AWS Elemental MediaLive API-Referenz](https://docs.aws.amazon.com/medialive/latest/apireference/) zu lesen. Diese Anleitung ist benutzerfreundlich, da es Links von Elementen in der JSON-Nutzlast zu Tabellen enthält, die das jeweilige Element beschreiben. Sie müssen jedoch die Syntax der Elemente im JSON-Code anpassen, da der eine Form der Großschreibung für Elemente AWS CLI verwendet (z. B.`SubSegmentNum`) und die API eine andere Form verwendet (z. B.`subSegmentNum`). **Topics** + [ # Erstellen und Löschen mit einem Batch-Befehl ](about-batch-update-schedule.md) + [ # Einen Batch-Update-Schedule-Befehl einreichen ](submitting-batch-command.md) + [ # JSON-Nutzlast zum Erstellen von Aktionen ](schedule-create-json.md) + [ # JSON-Nutzlast für Löschaktionen ](cli-schedule-delete-json.md) + [ # JSON-Payload zum Kombinieren von Create und Delete ](schedule-create-and-delete-json.md) + [ # Den Zeitplan anzeigen ()AWS CLI ](viewing-schedule-using-cli.md) # Erstellen und Löschen mit einem Batch-Befehl Batch-Befehl aktualisieren Um Aktionen im Zeitplan für einen Channel zu erstellen und zu löschen, verwenden Sie den Befehl zur Stapelaktualisierung. Mit diesem Befehl können Sie mehrere Aktionen in einer Anforderung ausführen. Es gibt keinen Befehl zum Erstellen von Aktionen und einen anderen zum Löschen von Aktionen. **Wichtig** Wenn Sie mit einem gestarteten und laufenden Channel arbeiten, verwenden Sie den **batch-update-schedule**Befehl, um Aktionen hinzuzufügen oder zu entfernen. Verwenden Sie den Befehl **delete-schedule** nur für inaktive Kanäle. Der Befehl **delete-schedule** löscht alle geplanten Aktionen und kann bei Verwendung auf einem Live-Kanal zu Dienstunterbrechungen führen. Verwenden Sie den Befehl wie folgt: + Senden Sie eine *einzelne* Anforderung, z. B. eine Anforderung, um Folgendes zu tun: + Erstellen einer Aktion. + Löschen einer Aktion. + Senden Sie eine *Stapelanforderung* z. B. eine Anforderung, um Folgendes zu tun: + Erstellen mehrerer Aktionen. + Löschen mehrerer Aktionen. + Erstellen einer oder mehrerer Aktionen und Löschen einer oder mehrerer Aktionen. **Wichtig** In einem Befehl, der Aktionen zum Erstellen und Löschen kombiniert, werden die Löschaktionen *immer* vor den Aktionen zum Erstellen ausgeführt. Das bedeutet, dass die Löschaktionen aus dem Zeitplan MediaLive entfernt werden, bevor die Erstellungsaktionen zum Zeitplan hinzugefügt werden. **Topics** + [ # Wie funktioniert eine Batch-Anfrage ](how-batch-schedule-requests-work.md) + [ # Batch-Befehl in verschiedenen Benutzeroberflächen ](batchupdatecommand-interfaces.md) + [ # JSON-Nutzlast in verschiedenen Schnittstellen ](batchupdatecommand-payloads.md) # Wie funktioniert eine Batch-Anfrage Sinn und Zweck der Stapelverarbeitung ist, dass alle Aktionen zusammen erfolgreich übergeben werden bzw. fehlschlagen. Daher MediaLive validiert AWS Elemental Batch-Aktionen gemeinsam. MediaLive führt die folgende Validierung durch: + Es stellt sicher, dass jede Aktion, die erstellt oder gelöscht wird, eine explizite oder implizite Startzeit hat, die mindestens 15 Sekunden in der future liegt. + Wenn sich die Aktion auf eine vorhandene Aktion im Zeitplan bezieht, wird sichergestellt, dass der Verweis auf die vorhandene Aktion korrekt ist. Ein nachfolgender Eingabewechsel enthält beispielsweise einen Verweis auf die Aktion, der er folgt. Diese Aktion muss vorhanden sein. Wenn die Validierung für eine Aktion fehlschlägt, schlägt sie automatisch für alle Aktionen im Stapel fehl. Wenn Sie nicht möchten, dass die Aktionen zusammen bestehen werden bzw. fehlschlagen, richten Sie keinen Stapel ein. Erstellen Sie stattdessen jede Aktion in einem eigenen Befehl zur Stapelaktualisierung. Wenn die Überprüfung erfolgreich ist, MediaLive werden alle Löschanforderungen vor den Erstellungsanforderungen verarbeitet, unabhängig von den Startzeiten der Aktionen. **Beispiel 1** Eine wichtige Anwendung der Batchverarbeitung besteht darin, mehrere Aktionen auszuführen, die gemeinsam erfolgreich sein müssen oder fehlschlagen. Nehmen wir beispielsweise an, Sie möchten das Firmenlogo entfernen und sofort ein splice\$1insert einfügen (um zu einem Ad-Avail zu wechseln). Dazu müssen Sie eine Aktion zum Entfernen des Logos und eine weitere Aktion zum Einfügen des splice\$1insert erstellen. Sie möchten die Aktion „Entfernen“ jedoch nicht einfügen MediaLive , wenn die Aktion splice\$1insert fehlschlägt, oder umgekehrt. Es ist besser, dass beide Aktionen fehlschlagen, da Sie dadurch die fehlerhaft formatierte Aktion korrigieren und dann beide Aktionen erneut übergeben können. Aus diesem Grund übermitteln Sie die beiden Aktionen zusammen in einem Befehl zur Stapelaktualisierung. **Beispiel 2** Eine weitere wichtige Verwendung von Stapelbefehlen besteht darin, einen Fehler bei einer Aktion im Zeitplan zu beheben. Sie können beispielsweise eine Bildüberlagerung korrigieren, die noch nicht gestartet bzw. mit der falschen Startzeit erstellt wurde. Dazu senden Sie einen Stapel-Aktualisierungszeitplanbefehl mit JSON, der Folgendes enthält: + Eine Nutzlast zum Entfernen der ursprünglichen Aktion zur Aktivierung der Bildüberlagerung. Diese Aktion hat die falsche Startzeit. + Eine Nutzlast zum Hinzufügen einer neuen Aktion zur Aktivierung derselben Bildüberlagerung. Diese Aktion hat die korrekte Startzeit. # Batch-Befehl in verschiedenen Benutzeroberflächen Der Befehl zur Stapelaktualisierung wird in verschiedenen Schnittstellen anders dargestellt: + In der AWS CLI ist der Befehl`batch-update-schedule`. + In der API wird der Befehl durch eine `HTTP PUT` auf `channels/channelId/schedule` dargestellt. + In der AWS SDKs wird der Befehl durch Konstrukte dargestellt, die für diese SDK-Sprache geeignet sind. # JSON-Nutzlast in verschiedenen Schnittstellen Die JSON-Nutzlast für den Befehl unterscheidet sich für die verschiedenen Schnittstellen: + In der AWS CLI hängt der Inhalt der Payload davon ab, wie Sie den Befehl verwenden: + Sie können einen Befehl mit zwei Parametern eingeben: `channel-id` und `--cli-input-json`. In diesem Fall erstellen Sie eine Datei, die die Channel-ID wiederholt und die JSON-Nutzlast enthält. + Sie können einen Befehl mit drei Parametern eingeben: einen für die Channel-ID, einen für die JSON-Nutzlast für die Erstellungsaktionen (falls anwendbar) und einen für die JSON-Nutzlast für die Löschaktionen (falls anwendbar). Sie übergeben die Nutzlasten in dem Befehl. Wenn beide Parameter vorhanden sind, verwendet jeder Parameter eine separate Nutzlast. Die beiden Nutzlasten werden jedoch validiert und als Stapel ausgeführt. Die Payload für AWS CLI wird immer in Pascal-Groß- und Kleinschreibung verwendet. + In der API gibt es eine Nutzlast mit zwei Abschnitten, einem `CREATES`-Abschnitt und einem `DELETES`-Abschnitt. Eine Anforderung kann einen oder beide Abschnitte enthalten. Die Nutzlast für die API verwendet für Variablennamen immer die gemischte Groß-/Kleinschreibung und für Klassen die gemischte Groß-/Kleinschreibung mit großen Anfangsbuchstaben. + In der wird die AWS SDKs JSON-Nutzlast durch Konstrukte dargestellt, die für diese SDK-Sprache geeignet sind. Um sich mit einzelnen Aktionen besser vertraut zu machen, empfehlen wir, die MediaLive Konsole zu verwenden, um eine Aktion zu erstellen. Nachdem Sie die Aktion erstellt haben, verwenden Sie den [DescribeSchedule](viewing-schedule-using-cli.md)Befehl in der entsprechenden Schnittstelle (z. B. im AWS CLI oder in einem SDK), um die unformatierte JSON-Payload für den gesamten Zeitplan abzurufen. Sie können einzelne Aktionen kopieren und sie als Modelle speichern, wenn Sie programmatisch arbeiten. # Einen Batch-Update-Schedule-Befehl einreichen Einen Befehl einreichen Der Befehl für einen Befehl zur Stapelaktualisierung ist für das Erstellen von Aktionen, das Löschen von Aktionen oder das Senden einer Kombination aus Aktionen zum Erstellen und Löschen identisch. Der Befehl ist identisch. Nur der Inhalt der JSON-Nutzlast unterscheidet sich. Es gibt verschiedene Möglichkeiten, den Befehl zum Erstellen einer Aktion einzugeben. Wir empfehlen, diese Vorgehensweise zu befolgen: + Geben Sie den Befehl mit zwei Parametern ein: `channel-id` und `--cli-input-json`. In diesem Fall erstellen Sie eine Datei, die die Channel-ID wiederholt und die JSON-Nutzlast enthält. Die Anweisungen und Beispiele in diesem Abschnitt veranschaulichen diese Vorgehensweise. Die folgenden allgemeinen Regeln gelten für Batch-Aktualisierungsbefehle: + Sie können Aktionen erstellen, wenn der Channel ausgeführt wird oder wenn er sich im Leerlauf befindet. + Sie können eine beliebige Anzahl von Aktionen in einer Anforderung oder eine beliebige Kombination von Aktionstypen in einer Anforderung erstellen. Sie können beispielsweise die Erstellung von SCTE 35-Nachrichtenaktionen und Image-Overlay-Aktionen kombinieren. + Wenn Sie mehrere Aktionen in einer Anforderung erstellen und eine der Anforderungen zum Erstellen fehlschlägt (für gewöhnlich, weil die Startzeit nicht weit genug in der Zukunft liegt), schlagen sie alle fehl. Für Löschaktionen gelten die folgenden Regeln: + Sie können eine Aktion löschen, wenn der Channel ausgeführt wird oder wenn er sich im Leerlauf befindet. + Sie können eine beliebige Anzahl von Aktionen in einer Anforderung oder eine beliebige Kombination von Aktionstypen in einer Anforderung löschen. Sie können beispielsweise das Löschen von SCTE 35-Nachrichtenaktionen und Image-Overlay-Aktionen kombinieren. + Wenn Sie mehrere Aktionen in einer Anforderung löschen und eine der Löschanforderungen fehlschlägt (für gewöhnlich, weil die Startzeit nicht weit genug in der Zukunft liegt), schlagen sie alle fehl. **So übermitteln Sie einen Stapelbefehl:** 1. Bevor Sie Aktionen hinzufügen oder löschen, lesen Sie [Aktionen im Zeitplan (Konsole) erstellen](schedule-using-console-create.md) und. [Löschen von Aktionen aus dem Zeitplan (Konsole)](schedule-using-console-delete.md) 1. Bereiten Sie eine Datei vor, die die Channel-ID und die entsprechende JSON-Nutzlast für die Aktionen enthält. Die Struktur und Beispiele für die JSON-Nutzlast für verschiedene Aktionen finden Sie in den folgenden Abschnitten. 1. Geben Sie der Datei einen geeigneten Namen mit der `.txt`-Erweiterung. Beispielsweise könnte der Dateiname für eine Nutzlast, die nur Aktionen erstellt, `schedule-create-actions.txt` lauten. 1. Speichern Sie die Datei in dem Ordner, in dem Sie die AWS CLI ausführen. 1. Geben Sie an der Befehlszeile den folgenden Befehl ein: `AWS medialive batch-update-schedule --channel-id value --cli-input-json value` + Geben Sie im Wert für `--channel-id` die Channel-ID als Zahl ein. + Geben Sie im Wert für `--cli-input-json` den Dateinamen in diesem Format ein: `file://filename.txt` Beispiel: `aws medialive batch-update-schedule --channel-id 999999 --cli-input-json schedule-create-actions.txt` 1. Betätigen Sie die **Eingabetaste**, um den Befehl zu übermitteln. Die Antwort wird auf dem Bildschirm angezeigt. In der Antwort werden die Daten aus der Anforderung wiederholt. # JSON-Nutzlast zum Erstellen von Aktionen JSON zum Erstellen von Aktionen Die folgenden Abschnitte zeigen die Struktur der Nutzlast und ein Beispiel für die Nutzlast für jede Art von Erstellungsaktion für einen MediaLive -Zeitplan. **Topics** + [ # Aktion „Eingabeschalter“ — Nutzlast ](cli-schedule-fields-for-input-switch.md) + [ # Eingabe, Aktion vorbereiten — Nutzlast ](cli-schedule-fields-for-input-prep.md) + [ # Aktiviere die globale Image-Aktion — Payload ](cli-schedule-fields-for-activate-image.md) + [ # Deaktivieren Sie die globale Overlay-Aktion — Payload ](cli-schedule-fields-for-deactivate-image.md) + [ # Aktiviert die Bild-Aktion — Payload für die einzelnen Ausgaben ](cli-schedule-fields-for-activate-image-per-output.md) + [ # Deaktivieren Sie die Overlay-Aktion pro Ausgang — Payload ](cli-schedule-fields-for-deactivate-image-per-output.md) + [ # Aktivieren Sie das Animationsgrafik-Overlay — Payload ](cli-schedule-fields-activate-mgi.md) + [ # Deaktivieren Sie das Motion Graphic Overlay — Payload ](cli-schedule-fields-deactivate-mgi.md) + [ # Nachricht splice\$1INSERT — Nutzdaten ](cli-schedule-fields-for-splice-insert.md) + [ # Time\$1Signal-Nachricht — Nutzlast ](cli-schedule-fields-for-time-signal.md) + [ # Return-to-network Nachricht — Nutzlast ](cli-schedule-fields-for-return-network.md) + [ # ID3 Metadatenelement — Payload ](cli-schedule-fields-for-id3.md) + [ # ID3 Segment-Tag-Element — Payload ](cli-schedule-fields-id3-segment-tag.md) + [ # Pipeline-Aktion unterbrechen — Payload ](cli-schedule-fields-for-pause.md) + [ # Kombination von Erstellungsaktionen ](cli-example-multiple-creates.md) # Aktion „Eingabeschalter“ — Nutzlast Aktion des Eingangsschalters Die folgenden Abschnitte zeigen die Nutzlast für Eingabewechsel-Aktionen. In dieser Nutzlast enthält `ScheduleActionStartSettings` nur einen von `FixedModeScheduleActionStartSettings`, `ImmediateModeScheduleActionStartSettings`, oder `FollowModeScheduleActionStartSettings`. Beispiele für jeden dieser Tags finden Sie in den folgenden Beispielen. Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder für einen Eingabeschalter](schedule-fields-for-ips.md). ``` { "ChannelId": "string", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "FollowModeScheduleActionStartSettings": { "FollowPoint": "enum", "ReferenceActionName": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "InputSwitchSettings": { "InputAttachmentNameReference": "string", "InputClippingSettings": { "InputTimecodeSource": "enum", "StartTimecode": { "Timecode": "string" }, "StopTimecode": { "LastFrameClippingBehavior": "enum", "Timecode": "string" } }, "UrlPath": ["string", ...] } } ] } } ``` ## Beispiel für einen Wechsel zu einem Live-Eingang mit fester Startzeit Live-Switch zu einer festen Zeit In diesem Beispiel einer Anforderung wird zu einer festen Startzeit zu einer Live-Eingabe gewechselt. Die Wechsel-Aktion wird aufgerufen, und `studio-feed` wechselt zu der Eingabe, die mit dem Eingabe-Anhang `live-studio-feed` verbunden ist. Es wird zur angegebenen UTC-Zeit zu dieser Eingabe gewechselt. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:19.000Z" } }, "ActionName": "studio-feed", "ScheduleActionSettings": { "InputSwitchSettings": { "InputAttachmentNameReference": "live-studio-feed" } } } ] } } ``` ## Beispiel für einen statischen Dateiwechsel wie folgt Dateiwechsel wie folgt Dieses Beispiel für eine Anforderung besteht darin, zu einer statischen Dateieingabe zu wechseln, folgend auf das Ende der vorherigen Eingabe. Die Wechsel-Aktion wird aufgerufen, und `action-ad-003` wechselt zu der Eingabe, die mit dem Eingabe-Anhang `zel-cafe` verbunden ist. Es wird zu dieser Eingabe gewechselt, wenn die aufgerufene Aktion `action-ad-002` beendet wird. Die Datei für diese Aktion wird gekürzt, so dass sie nach 30 Sekunden und 11 Frames endet: ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FollowModeScheduleActionStartSettings": { "FollowPoint": "END", "ReferenceActionName": "action-ad-002" } }, "ActionName": "action-ad-003", "ScheduleActionSettings": { "InputSwitchSettings": { "InputAttachmentNameReference": "zel-cafe", "InputClippingSettings": { "InputTimecodeSource": "ZEROBASED", "StopTimecode":{ "Timecode": "00:00:30:11", "LastFrameClippingBehavior": "INCLUDE_LAST_FRAME" } } } } } ] } } ``` ## Beispiel für einen Wechsel zu einer dynamischen Eingabe mit sofortiger Startzeit Dynamischer Wechsel sofort In diesem Beispiel einer Anforderung wird sofort zu einer dynamischen Dateieingabe gewechselt. Die Wechsel-Aktion wird aufgerufen, und `action-unscheduled-standby` wechselt zu der Eingabe, die mit dem Eingabe-Anhang `dynamic-unscheduled-standby` verbunden ist. Für diese Verwendung der dynamischen Eingabe sind die zu verwendenden Dateien `oceanwaves.mp4`. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "action-unscheduled-slate", "ScheduleActionSettings": { "InputSwitchSettings": { "InputAttachmentNameReference": "slate", "UrlPath":[ "main/oceanwaves.mp4", "redundant/oceanwaves.mp4"] } } } ] } } ``` # Eingabe, Aktion vorbereiten — Nutzlast Eingabe: Aktion vorbereiten Die folgenden Abschnitte zeigen die Nutzlast für Eingabewechsel-Aktionen. In dieser Nutzlast enthält `ScheduleActionStartSettings` nur einen von `FixedModeScheduleActionStartSettings`, `ImmediateModeScheduleActionStartSettings`, oder `FollowModeScheduleActionStartSettings`. Beispiele für jeden dieser Tags finden Sie in den folgenden Beispielen. Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder für einen Eingabeschalter](schedule-fields-for-ips.md). ``` { "ChannelId": "string", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "FollowModeScheduleActionStartSettings": { "FollowPoint": "enum", "ReferenceActionName": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "InputPrepareSettings": { "InputAttachmentNameReference": "string", "InputClippingSettings": { "InputTimecodeSource": "enum", "StartTimecode": { "Timecode": "string" }, "StopTimecode": { "LastFrameClippingBehavior": "enum", "Timecode": "string" } }, "UrlPath": ["string", ...] } } } ] } } ``` ## Beispiel für eine Eingabevorbereitung mit einer festen Startzeit Live-Switch zu einer festen Zeit In diesem Beispiel einer Anforderung wird zu einer festen Startzeit zu einer Live-Eingabe gewechselt. Die Wechsel-Aktion wird aufgerufen, und `studio-feed` wechselt zu der Eingabe, die mit dem Eingabe-Anhang `live-studio-feed` verbunden ist. Es wird zur angegebenen UTC-Zeit zu dieser Eingabe gewechselt. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:19.000Z" } }, "ActionName": "studio-feed", "ScheduleActionSettings": { "InputSwitchSettings": { "InputAttachmentNameReference": "live-studio-feed" } } } ] } } ``` ## Beispiel für eine Eingabe, bereiten Sie sich wie folgt vor Wechseln Sie die Datei wie folgt Dieses Beispiel für eine Anforderung besteht darin, zu einer statischen Dateieingabe zu wechseln, folgend auf das Ende der vorherigen Eingabe. Die Wechsel-Aktion wird aufgerufen, und `action-ad-003` wechselt zu der Eingabe, die mit dem Eingabe-Anhang `zel-cafe` verbunden ist. Es wird zu dieser Eingabe gewechselt, wenn die aufgerufene Aktion `action-ad-002` beendet wird. Die Datei für diese Aktion wird gekürzt, so dass sie nach 30 Sekunden und 11 Frames endet: ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FollowModeScheduleActionStartSettings": { "FollowPoint": "END", "ReferenceActionName": "action-ad-002" } }, "ActionName": "action-ad-003", "ScheduleActionSettings": { "InputSwitchSettings": { "InputAttachmentNameReference": "zel-cafe", "InputClippingSettings": { "InputTimecodeSource": "ZEROBASED", "StopTimecode":{ "Timecode": "00:00:30:11", "LastFrameClippingBehavior": "INCLUDE_LAST_FRAME" } } } } } ] } } ``` # Aktiviere die globale Image-Aktion — Payload Aktiviere die globale Image-Aktion Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder für die Aktivierung eines globalen Bild-Overlays](schedule-fields-for-activate-image.md). ``` { "ChannelId": "string", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "StaticImageActivateSettings": { "Duration": integer, "FadeIn": integer, "FadeOut": integer, "Height": integer, "Image": { "PasswordParam": "string", "Uri": "string", "Username": "string" }, "ImageX": integer, "ImageY": integer, "Layer": integer, "Opacity": integer, "Width": integer } } } ] } } ``` ## Beispiel In diesem Beispiel für eine Anfrage wird ein Bild-Overlay erstellt, das in jede Videoausgabe in jeder Ausgabegruppe des Kanals eingefügt wird. Das Overlay verwendet eine Datei, die in einem Amazon S3 S3-Bucket gespeichert ist. Die Anforderung enthält keine Dauer und folglich auch keine Ausblendung. Ziel ist vielmehr, zum richtigen Zeitpunkt eine separate Deaktivierungsanforderung zu senden. Alle Zeiten werden in Millisekunden und alle Positionswerte in Pixel angegeben. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:19.000Z" } }, "ActionName": "corporate-logo-030", "ScheduleActionSettings": { "StaticImageActivateSettings": { "Image": { "PasswordParam": "corplogo!2312", "Uri": "s3ssl://amzn-s3-demo-bucket/logos/corporate/high-res.bmp", "Username": "medialiveoperator" }, "Layer": 1, "FadeIn": 1500, "Height": 900 "Width": 800, "ImageX": 200, "ImageY": 300, "Opacity": 60, } } } ] } } ``` # Deaktivieren Sie die globale Overlay-Aktion — Payload Deaktiviere die globale Overlay-Aktion Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder zum Deaktivieren eines globalen Bild-Overlays](schedule-fields-for-deactivate-image.md). ``` { "ChannelId": "string", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "StaticImageDeactivateSettings": { "FadeOut": integer, "Layer": integer } } } ] } ``` ## Beispiel In diesem Beispiel für eine Anfrage wird eine Aktion zum Entfernen eines Bild-Overlays um 20:42:04.000 (UTC) mit einem 500-Millisekunden-Fadeout erstellt, das zur Endzeit hinzugefügt wird, was bedeutet, dass das Overlay um 20:42:04.500 unsichtbar ist. Die Aktion entfernt das Bild-Overlay, das sich auf der globalen Ebene 4 befindet. Das bedeutet, dass das Bild *nur entfernt wird, wenn* es mit der globalen Aktion (StaticImageActivateSettings) eingefügt wurde. Das Overlay wird nicht aus der Ebene 4 für die einzelnen Ausgaben entfernt. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:04.000Z" } }, "ActionName": "stop-overlay-029", "ScheduleActionSettings": { "StaticImageDeactivateSettings": { "FadeOut": 500, "Layer": 4 } } } ] } } ``` # Aktiviert die Bild-Aktion — Payload für die einzelnen Ausgaben Aktivieren Sie die Bild-Aktion pro Ausgabe Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder zur Aktivierung eines Bild-Overlays für die einzelnen Ausgaben](schedule-fields-activate-image-per-output.md). ``` { "ChannelId": "string", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "StaticImageOutputActivateSettings": { "Duration": integer, "FadeIn": integer, "FadeOut": integer, "Height": integer, "Image": { "PasswordParam": "string", "Uri": "string", "Username": "string" }, "ImageX": integer, "ImageY": integer, "Layer": integer, "Opacity": integer, "OutputNames": [ {} ], "Width": integer } } } ] } } ``` ## Beispiel In diesem Beispiel für eine Anfrage wird ein Bild-Overlay erstellt, das in bestimmte Ausgaben im Kanal eingefügt wird. Das Overlay verwendet eine Datei, die in einem Amazon S3 S3-Bucket gespeichert ist. Die Anfrage fügt das Bild in die Ausgaben ein `hls-high-res` und`mss-high-res`. Die Größe des Bilds entspricht der Videoauflösung in diesen Ausgängen. Die Anfrage soll immer präsent sein. Daher ist es so eingerichtet, dass es sofort startet (sobald der Kanal startet). Alle Zeiten werden in Millisekunden und alle Positionswerte in Pixel angegeben. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "ImmediateModeScheduleActionStartSettings": { } }, }, "ActionName": "logo-1280", "ScheduleActionSettings": { "StaticImageOutputActivateSettings": { "Image": { "PasswordParam": "corplogo!2312", "Uri": "s3ssl://amzn-s3-demo-bucket/logos/corporate/10percent-1280.bmp", "Username": "medialiveoperator" }, "Layer": 0, "outputNames": [ hls-high-res,mss-high-res ], "ImageX": 200, "ImageY": 300, "FadeIn": 1500, "Opacity": 60 } } } ] } } ``` # Deaktivieren Sie die Overlay-Aktion pro Ausgang — Payload Overlay-Aktion deaktivieren Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder zum Deaktivieren einer Bildüberlagerung pro Ausgabe](schedule-fields-deactivate-image-per-output.md). ``` { "ChannelId": "string", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "StaticImageOutputDeactivateSettings": { "FadeOut": integer, "Layer": integer, "OutputNames" } } } ] } ``` ## Beispiel Die Aktion „Deaktivieren“ deaktiviert das Bild in der angegebenen Ebene pro Ausgabe, in der oder den angegebenen Ausgaben. In diesem Beispiel, das auf das Aktivierungsbeispiel folgt, entfernt die Aktion alle Bildüberlagerungen, die sich in der Ausgabeebene 4 pro Ausgabe befinden. hls-high-res ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:04.000Z" } }, "ActionName": "stop-layer4-all-outputs", "ScheduleActionSettings": { "StaticImageOutputDeactivateSettings": { "outputNames": [ hls-high-res ], "FadeOut": 500, "Layer": 4 } } } ] } } ``` # Aktivieren Sie das Animationsgrafik-Overlay — Payload Aktivieren Sie das Overlay für Bewegungsgrafiken Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder für die Aktivierung eines Animationsgrafik-Overlays](schedule-fields-for-mg.md). ``` { "ChannelId": "string", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "MotionGraphicsImageActivateSettings": { "Duration": integer "Url": "string" "Username": "string", "PasswordParam": "string" } } ] } } ``` ## Beispiel In diesem Beispiel für eine Anfrage wird eine Animationsgrafik-Overlay-Aktion namens mg\$1ticker\$1tape erstellt. Das Animationsgrafik-Asset ist unter http://example.com/ticker\$1tape.html gespeichert. Für diesen Server sind Benutzeranmeldedaten erforderlich. Die Anfrage enthält keine Dauer. Ziel ist vielmehr, zum richtigen Zeitpunkt eine separate Deaktivierungsanforderung zu senden. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:04.000Z" } }, "ActionName": "mg_ticker_tape", "ScheduleActionSettings": { "MotionGraphicsImageActivateSettings": { "Url": "https://example.com/ticker_tape.html" "Username": "medialiveoperator", "PasswordParam": "/medialive/12345" } } ] } } ``` # Deaktivieren Sie das Motion Graphic Overlay — Payload Deaktivieren Sie das Overlay für Bewegungsgrafiken Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder zum Deaktivieren eines Animationsgrafik-Overlays](schedule-fields-for-mg-deactivate.md). ``` { "ChannelId": "string", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "MotionGraphicsImageDeactivateSettings": { } } } ] } } ``` ## Beispiel In diesem Beispiel für eine Anforderung wird eine Aktion zum Beenden eines Animationsgrafik-Overlays um 23:59:00.000 (UTC) erstellt . : ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T23:59:00.000Z" }, "ActionName": "deactivate-ticker-tape", "ScheduleActionSettings": { "MotionGraphicsImageDeactivateSettings": { } } } ] } } ``` # Nachricht splice\$1INSERT — Nutzdaten Splice\$1Insert-Nachricht Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter. [Felder für eine splice\$1insert-Nachricht](schedule-fields-for-splice_insert.md) ``` { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "FollowModeScheduleActionStartSettings": { "FollowPoint": "enum", "ReferenceActionName": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "Scte35SpliceInsertSettings": { "Duration": integer, "SpliceEventId": integer } } } ] } ``` ## Beispiel für eine Spleißeinfügung mit einer festen Startzeit In diesem Beispiel für eine Anforderung wird eine Aktion für einen splice\$1insert mit einer UTC-Startzeit von 20:42:04.000 erstellt. Sie verfügt auch über einen `ActionName`, der möglicherweise auf einen Ad-Avail aus Ihrer Datenbank verweist, eine eindeutige Ganzzahl für die Splice-Ereignis-ID und eine Dauer von 1.350.000 kHz-Ticks (15 Sekunden): ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:04.000Z" } }, "ActionName": "adavail-3708", "ScheduleActionSettings": { "Scte35SpliceInsertSettings": { "SpliceEventId": 3708, "Duration": 1350000 } } } ] } } ``` ## Beispiel für eine Spleißeinfügung wie folgt Dieses Beispiel für eine Anfrage erzeugt eine Aktion für ein splice\$1insert, das eingefügt wird, nachdem der Eingabeschalter mit dem Namen nature-doco-003 beendet wurde. Diese Aktion verfügt auch über einen `ActionName`, der möglicherweise auf einen Ad-Avail aus Ihrer Datenbank verweist, eine eindeutige Ganzzahl für die Splice-Ereignis-ID und eine Dauer von 1.350.000 kHz-Ticks (15 Sekunden): Der Follow-Modus für eine SCTE 35-Nachricht ist nützlich, wenn Sie möchten, dass eine Anzeige geschaltet wird, sobald eine Eingabe abgeschlossen ist, Sie aber nicht wissen, wann das geschehen wird. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FollowModeScheduleActionStartSettings": { "FollowPoint": "END", "ReferenceActionName": "nature-doco-003" } }, "ActionName": "adavail-3708", "ScheduleActionSettings": { "Scte35SpliceInsertSettings": { "SpliceEventId": 3708, "Duration": 1350000 } } } ] } } ``` # Time\$1Signal-Nachricht — Nutzlast Time\$1Signal-Nachricht Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter. [Felder für eine time\$1signal-Nachricht](schedule-fields-for-time-signal.md) ``` { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "FollowModeScheduleActionStartSettings": { "FollowPoint": "enum", "ReferenceActionName": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "Scte35TimeSignalSettings": { "Scte35Descriptors": [ { "Scte35DescriptorSettings": { "SegmentationDescriptorScte35DescriptorSettings": { "DeliveryRestrictions": { "ArchiveAllowedFlag": "enum", "DeviceRestrictions": "enum", "NoRegionalBlackoutFlag": "enum", "WebDeliveryAllowedFlag": "enum" }, "SegmentNum": integer, "SegmentationCancelIndicator": "enum", "SegmentationDuration": integer, "SegmentationEventId": integer, "SegmentationTypeId": integer, "SegmentationUpid": "string", "SegmentationUpidType": integer, "SegmentsExpected": integer, "SubSegmentNum": integer, "SubSegmentsExpected": integer } } } ] } } } ] } ``` ## Beispiel In diesem Beispiel für eine Anforderung wird eine Aktion für ein Zeitsignal mit der UTC-Startzeit 20:42:04.000 und mit einer eindeutigen Ganzzahl für `SegmentationEventId` erstellt. In den Einschränkungsfeldern wurde für `NoRegionalBlackoutFlag` eine Einschränkung festgelegt (regionale Blackouts sind vorhanden). ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:04.000Z" } }, "ActionName": "adavail-3708", "ScheduleActionSettings": { "Scte35TimeSignalSettings": { "Scte35Descriptors": [ { "Scte35DescriptorSettings": { "SegmentationDescriptorScte35DescriptorSettings": { "SubSegmentsExpected": 0, "SegmentationEventId": 7054, "SegmentationDuration": 1350000, "SegmentationCancelIndicator": 0, "SubSegmentNum": 0, "SegmentationUpidType": 12, "SegmentNum": 0, "SegmentationCancelIndicator": "SEGMENTATION_EVENT_NOT_CANCELED", "DeliveryRestrictions": { "DeviceRestrictions": "NONE", "WebDeliveryAllowedFlag": "WEB_DELIVERY_ALLOWED", "NoRegionalBlackoutFlag": "REGIONAL_BLACKOUT", "ArchiveAllowedFlag": "ARCHIVE_ALLOWED" }, "SegmentationUpid": "4a414e3136494e4155303031", "SegmentationTypeId": 52, "SegmentsExpected": 0 } } } ] } } } ] } } ``` # Return-to-network Nachricht — Nutzlast Return-to-network Nachricht Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder für eine Nachricht return-to-network](schedule-fields-for-return-to-network.md). ``` { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "FollowModeScheduleActionStartSettings": { "FollowPoint": "enum", "ReferenceActionName": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "Scte35ReturnToNetworkSettings": { "SpliceEventId": integer } } } ] } ``` ## Beispiel In diesem Beispiel für eine Anfrage wird eine return-to-network mit einer UTC-Startzeit von 20:42:19 erstellt. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:19.000Z" } }, "ActionName": "end-adavail-3708", "ScheduleActionSettings": { "Scte35ReturnToNetworkSettings": { } } } ] } } ``` # ID3 Metadatenelement — Payload ID3 Metadaten-Element Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder für Metadaten ID3](schedule-fields-for-id3-userdata.md). **Nutzlast für die Aktion HlsTimedMetadataSettings** ``` { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "HlsTimedMetadataSettings": { "Id3": "string" } } } ] } ``` **Nutzlast für die Aktion TimedMetadataSettings** ``` { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "TimedMetadataSettings": { "Id3": "string" } } } ] } ``` ## Beispiel In diesem Beispiel für eine Anfrage wird die `HlsTimedMetadataSettings` Aktion verwendet. Es erstellt ID3 Metadaten, die um 13:35:59 UTC in die entsprechenden Ausgabegruppen eingefügt werden. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2019-01-02T13:35:59Z" } }, "ActionName": "id3-metadata.2019-01-02T13:35:59Z", "ScheduleActionSettings": { "HlsTimedMetadataSettings": { "Id3": "SUQzBAAAAAAAF1RJVDIAAAANAAADSGVsbG8gV29ybGQA" } } } ] } } ``` # ID3 Segment-Tag-Element — Payload ID3 Segment-Tag-Element Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder für ID3 Segment-Tags](schedule-fields-for-id3-segment-tags.md). **Nutzlast für die Aktion HlsId 3 SegmentTaggingSettings** ``` { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "HlsId3SegmentTaggingSettings": { "Tag": "string" "Id3": "string" } } } ] } ``` **Nutzlast für die Id3-Aktion SegmentTaggingSettings** ``` { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "Id3SegmentTaggingSettings": { "Tag": "string" "Id3": "string" } } } ] } ``` ## Beispiel für die Verwendung der Tag-Eigenschaft In diesem Beispiel für eine Anfrage wird die `HlsId3SegmentTaggingSettings` Aktion verwendet. Es erstellt ein ID3 Segment-Tag, das ab 13:35:59 UTC eingefügt wird. In diesem Beispiel wird die `Tag` Eigenschaft verwendet, was bedeutet, dass Sie nur den Inhalt von `value` für das Feld angeben. `TXXX` In diesem Beispiel besteht der Inhalt aus Datum, Uhrzeit und Nummer des Segments. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2020-01-02T13:35:59Z" } }, "ActionName": "id3-datetime-and-segment", "ScheduleActionSettings": { "HlsId3SegmentTaggingSettings": { "Tag": "$dt$-$sn$" } } } ] } } ``` ## Beispiel mit der Eigenschaft Id3 In diesem Beispiel für eine Anfrage wird ein ID3 Segment-Tag erstellt, das sofort eingefügt wird. In diesem Beispiel wird die `Id3` Eigenschaft verwendet, was bedeutet, dass der Inhalt als Base64 codiert ist. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { ImmediateModeScheduleActionStartSettings } }, "ActionName": "id3-song309", "ScheduleActionSettings": { "HlsId3SegmentTaggingSettings": { "Id3": "SUQzBAAAAAAAF1RJVDIAAAANAAADSGVsbG8gV29ybGQA" } } } ] } } ``` # Pipeline-Aktion unterbrechen — Payload Pipeline-Aktion unterbrechen Informationen zur Bedeutung und zu den Werten der Felder in der folgenden JSON-Datei finden Sie unter[Felder für die Pause](schedule-fields-for-pause.md). ``` { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "string" }, "ImmediateModeScheduleActionStartSettings": { } }, "ActionName": "string", "ScheduleActionSettings": { "PauseStateSettings": { "Pipelines": [ { "PipelineId": "enum" } ] } } } ] } ``` ## Beispiel: Eine Pipeline pausieren In diesem Beispiel einer Anfrage wird Pipeline 0 um 20:42:19 UTC angehalten. MediaLive liest den Befehl immer wie folgt: *setzt die angegebene Pipeline oder Pipelines auf Pause und setzt alle anderen Pipelines auf* ununterbrochen. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:19Z" } }, "ActionName": "pause-pipeline-0-now", "ScheduleActionSettings": { "PauseStateSettings": { "Pipelines": [ { "PipelineId": "PIPELINE_0" } ] } } } ] } } ``` ## Beispiel: Die Pause für beide Pipelines aufheben In diesem Beispiel für eine Anforderung wird die Unterbrechung aller derzeit unterbrochenen Pipelines aufgehoben. **Anmerkung** MediaLive liest den Befehl immer wie folgt: *setzt die angegebene (n) Pipeline (n) auf Pause und setzt alle anderen Pipelines auf „ohne Pause*“. In diesem Beispiel ist das Array leer. `Pipelines` MediaLiveinterpretiert dieses leere Array als: *setzt alle Pipelines auf* ununterbrochen. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "ImmediateModeScheduleActionStartSettings": {} }, "ActionName": "unpause-pipeline-0", "ScheduleActionSettings": { "PauseStateSettings": { "Pipelines": [ {} ] } } } ] } } ``` # Kombination von Erstellungsaktionen Hier ist ein Beispiel für einen JSON-Hauptteil, der an den `--creates` Parameter des `batch-update-schedule` AWS CLI Befehls übergeben wird. Es enthält zwei Aktionen, die erstellt werden sollen. In diesem Beispiel handelt es sich bei beiden Aktionen um splice\$1inserts, aber tatsächlich können Sie beliebig viele und eine beliebige Arten von Erstellungsaktionen miteinander kombinieren. ``` { "ScheduleActions": [ { "ScheduleActionSettings": { "Scte35SpliceInsertSettings": { "Duration": 1350000, "SpliceEventId": 3 } }, "ActionName": "SpliceInsert-01", "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-11-05T16:10:30.000Z" } } }, { "ScheduleActionSettings": { "Scte35SpliceInsertSettings": { "Duration": 2700000, "SpliceEventId": 3 } }, "ActionName": "SpliceInsert-02", "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-11-05T16:30:45.000Z" } } } ] } ``` # JSON-Nutzlast für Löschaktionen JSON für Löschaktionen Schließen Sie in `Deletes` die Liste der Aktionen ein, die gelöscht werden sollen, indem Sie ein Array von `ActionNames` eingeben. Das Array enthält einen oder mehrere Aktionsnamen. Sie können diese Aktionsnamen mit dem `DescribeChannel`-Befehl abrufen (siehe [Den Zeitplan anzeigen ()AWS CLI](viewing-schedule-using-cli.md)). ``` { "ChannelId": "string", "Deletes": { "ActionNames": [ "" ] } } ``` ## Beispiel In diesem Beispiel für eine Anforderung werden die drei Aktionen gelöscht, die durch `ActionNames` angegeben sind, die beim Erstellen der Aktionen zugewiesen wurden. ``` { "ChannelId": "999999", "Deletes": { "ActionNames": [ "stop-overlay-33", "adavail-3711", "end-adavail-3711" ] } } ``` # JSON-Payload zum Kombinieren von Create und Delete JSON für Kombinationen Um einen Stapel von Erstellungen und Löschungen zu kombinieren, fügen Sie sowohl einen `Creates`-Abschnitt als auch einen `Deletes`-Abschnitt in die JSON-Nutzlast ein. In diesem Beispiel entfernt die Nutzlast im `Deletes`-Abschnitt eine Aktion zur Aktivierung einer Bildüberlagerung, da sie eine falsche Startzeit hat. Die Aktion hat den Namen `overlay-21`. Die Nutzlast im `Creates`-Abschnitt fügt diese Aktion erneut ein, diesmal mit der richtigen Startzeit. Obwohl der `Creates` Abschnitt in der JSON-Nutzlast an erster Stelle steht, werden die Löschaktionen MediaLive immer zuerst ausgeführt. In dieser Aktion haben die Löschaktion und die Erstellungsaktion die gleiche `ActionName`. Der Name wird wiederverwendet, da der Stapel ein „Löschen und Ersetzen“-Stapel ist. Sie können der Aktion zum Erstellen auch einen anderen Namen zuweisen. ``` { "ChannelId": "999999", "Creates": { "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:19.000Z" } }, "ActionName": "overlay-21", "ScheduleActionSettings": { "StaticImageActivateSettings": { "Image": { "PasswordParam": "imagespassword", "Uri": "s3ssl://amzn-s3-demo-bucket/banner-A/high-res.bmp", "Username": "medialiveoperator" }, "ImageY": 300, "FadeIn": 1500, "ImageX": 200, "Width": 800, "Opacity": 60, "Layer": 1, "Height": 900 } } } ] }, "Deletes": { "ActionNames": [ "overlay-21" ] } } ``` # Den Zeitplan anzeigen ()AWS CLI Den Zeitplan anzeigen Sie können den verwenden AWS CLI , um eine Liste der Aktionen anzuzeigen, die derzeit im Zeitplan für einen Kanal enthalten sind: + Aktionen, die noch nicht im Channel ausgeführt wurden + Aktionen, die zuvor ausgeführt wurden Verwenden Sie den `DescribeSchedule`-Befehl, um den Zeitplan anzuzeigen. Dieser Befehl wird in verschiedenen Schnittstellen anders dargestellt: + In der AWS CLI lautet der Befehl`describe-schedule`. + In der API wird der Befehl durch eine `HTTP GET` auf `channels/channelId/schedule` dargestellt. + In der AWS SDKs wird der Befehl durch Konstrukte dargestellt, die für diese SDK-Sprache geeignet sind. **So zeigen Sie Aktionen an (AWS CLI):** 1. Geben Sie diesen Befehl ein: **aws medialive describe-schedule --channel-id *value* --max-results value** 1. Betätigen Sie die **Eingabetaste**, um den Befehl zu übermitteln. Die Antwort wird auf dem Bildschirm angezeigt. 1. Wenn Sie die `-max-results`-Option und die Antwort in `NextToken` verwendet haben, geben Sie den **DescribeChannel**-Befehl ein und übergeben Sie den Wert von `NextToken` in `--next-token`. Beispiel: **aws medialive describe-schedule --channel-id *value* --next-token 3jhrprd0** 1. Betätigen Sie die **Eingabetaste**, um den Befehl zu übermitteln. Die Antwort wird auf dem Bildschirm angezeigt. ## Beispiel Den Zeitplan anzeigen Der JSON-Text der Befehls*antwort* ähnelt dem der `BatchUpdateSchedule`-Befehls*anforderung*. Dieses Antwortbeispiel zeigt die folgenden Aktionen: + Eine Aktion mit dem `ActionName` **corporate-logo-029** zum Aktivieren einer Bildüberlagerung in Ebene 1 um 20:30:00 UTC + Eine Aktion mit dem `ActionName` **stop-overlay-029** zum Deaktivieren der Überlagerung in Ebene 1 um 20:42:04 UTC + Eine Aktion mit dem `ActionName` **adavail-3708** zum Einfügen eines splice\$1insert zur gleichen Zeit wie die Deaktivierung. + Eine Aktion mit dem `ActionName` **end-adavail-3708** bis return-to-network 15 Sekunden später, um 20:42:19 UTC + Eine Aktion mit dem `ActionName` **corporate-logo-030** um dieselbe Überlagerung in Ebene 1 gleichzeitig mit der Rückgabe zu reaktivieren. Dieser Zeitplan beschreibt einen Workflow, in dem Sie Ihr Firmenlogo zeigen, es aber zu Beginn jedes Ad-Avails entfernen und dann am Ende des Ad-Avails erneut einblenden. ``` { "NextToken": "3jhrprd0", "ScheduleActions": [ { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:30:00.000Z" } }, "ActionName": "corporate-logo-029", "ScheduleActionSettings": { "StaticImageActivateSettings": { "Image": { "PasswordParam": "corplogo!2312", "Uri": "s3ssl://amzn-s3-demo-bucket/logos/corporate/high-res.bmp", "Username": "medialiveoperator" }, "ImageY": 300, "FadeIn": 1500, "ImageX": 200, "Width": 800, "Opacity": 60, "Layer": 1, "Height": 900 } } }, { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:04.000Z" } }, "ActionName": " stop-overlay-029", "ScheduleActionSettings": { "StaticImageDeactivateSettings": { "FadeOut": 1500, "Layer": 1 } } }, { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:04.000Z" } }, "ActionName": "adavail-3708", "ScheduleActionSettings": { "Scte35SpliceInsertSettings": { "SpliceEventId": 3708, "Duration": 1350000 } } }, { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:19.000Z" } }, "ActionName": "end-adavail-3708", "ScheduleActionSettings": { "Scte35ReturnToNetworkSettings": { "SpliceEventId": 3708 } } }, { "ScheduleActionStartSettings": { "FixedModeScheduleActionStartSettings": { "Time": "2018-05-21T20:42:19.000Z" } }, "ActionName": "corporate-logo-030", "ScheduleActionSettings": { "StaticImageActivateSettings": { "Image": { "PasswordParam": "corplogo!2312", "Uri": "s3ssl://amzn-s3-demo-bucket/logos/corporate/high-res.bmp", "Username": "medialiveoperator" }, "ImageY": 300, "FadeIn": 1500, "ImageX": 200, "Width": 800, "Opacity": 60, "Layer": 1, "Height": 900 } } } ] } ```