Playlists: CLI-Befehle

Playlists

Eine Playlist ist ein JSON-Dokument von Seiten. playlist init bereitet ein Vollbild-Dokument aus geordneten Eingaben vor. playlist create und playlist update lesen dieses Dokument aus einer Datei; playlist patch, playlist rename und playlist page add|replace|remove ändern einen Teil davon. Die Form wird unter den Befehlen zusammengefasst.

playlist init <inputs...> --name NAME --output FILE [--overwrite] [--screen-id ID]
              [--target-width PX --target-height PX] [--duration-ms MS] [--fit contain|cover|fill] [--sound]
              [--no-transcode] [--no-progress] [--poll-ms MS]

screenrig playlist init med_01EXAMPLEIMAGE0000000000 med_01EXAMPLEVIDEO0000000000 --name "Lobby loop" --screen-id scr_01EXAMPLESCREEN00000000 --output lobby.json

playlist validate <file>

screenrig playlist validate ./lobby-loop.json

playlist create [file] [--from-template ID --name NAME [--set NAME=VALUE...] [--dry-run]] [--starter KEY [--name NAME]] [--format-region REGION --format-orientation ORIENTATION] [--note TEXT]

screenrig playlist create ./lobby-loop.json

screenrig playlist create --from-template pl_01EXAMPLETEMPLATE00000 --name "Monday notice" --set headline="Open late"

playlist update <id> <file> [--format-region REGION --format-orientation ORIENTATION] [--expect-rev REVISION] [--note TEXT]

screenrig playlist update pl_01EXAMPLEPLAYLIST000000 ./lobby-loop.json

playlist patch <id> [file] [--name NAME] [--clear-audio] [--expect-rev REVISION] [--note TEXT]

screenrig playlist patch pl_01EXAMPLEPLAYLIST000000 --name "Lobby loop" --expect-rev 7
screenrig playlist patch pl_01EXAMPLEPLAYLIST000000 changes.json --expect-rev 7

playlist rename <id> --name NAME [--expect-rev REVISION] [--note TEXT]

screenrig playlist rename pl_01EXAMPLEPLAYLIST000000 --name "Lobby loop" --expect-rev 7

playlist page add <playlist-id> (--file PAGE.json | --media MED_ID) [--seconds N] [--fit contain|cover] [--sound]
                  [--from WHEN] [--until WHEN] [--before PAGE_ID] [--page-id ID]
                  [--expect-rev REVISION] [--note TEXT]

screenrig playlist page add pl_01EXAMPLEPLAYLIST000000 --media med_01EXAMPLEIMAGE0000000000 --from 2026-12-01 --until 2026-12-24
screenrig playlist page add pl_01EXAMPLEPLAYLIST000000 --media med_01EXAMPLEVIDEO0000000000 --before up-ab12cd34 --note "Winter menu"
screenrig playlist page add pl_01EXAMPLEPLAYLIST000000 --file page.json --page-id welcome

playlist page replace <playlist-id> <page-id> [--file PAGE.json | --media MED_ID] [--seconds N] [--fit contain|cover]
                      [--sound] [--from WHEN] [--until WHEN | --always] [--expect-rev REVISION] [--note TEXT]

screenrig playlist page replace pl_01EXAMPLEPLAYLIST000000 up-ab12cd34 --media med_01EXAMPLEIMAGE0000000000
screenrig playlist page replace pl_01EXAMPLEPLAYLIST000000 up-ab12cd34 --until 2026-12-31
screenrig playlist page replace pl_01EXAMPLEPLAYLIST000000 up-ab12cd34 --always

playlist page remove <playlist-id> <page-id> [--expect-rev REVISION] [--note TEXT]

screenrig playlist page remove pl_01EXAMPLEPLAYLIST000000 up-ab12cd34

playlist show <id> [--output FILE [--overwrite]] [--editable]

screenrig playlist show pl_01EXAMPLEPLAYLIST000000
screenrig playlist show pl_01EXAMPLEPLAYLIST000000 --output playlist.json
screenrig playlist show pl_01EXAMPLEPLAYLIST000000 --editable

playlist list [--templates] [--library]

screenrig playlist list --templates
screenrig playlist list --library

playlist fields <id> [--set NAME=VALUE...] [--clear NAME...] [--refresh] [--expect-rev REVISION] [--note TEXT]

screenrig playlist fields pl_01EXAMPLECOPY00000000 --set headline="Closed today"

playlist instances <id>

screenrig playlist instances pl_01EXAMPLETEMPLATE00000

playlist revisions <id> [--after CURSOR]

screenrig playlist revisions pl_01EXAMPLEPLAYLIST000000

playlist revision show <id> --revision N

screenrig playlist revision show pl_01EXAMPLEPLAYLIST000000 --revision 3

playlist promote <id> --revision N --expect-rev CURRENT

screenrig playlist promote pl_01EXAMPLEPLAYLIST000000 --revision 3 --expect-rev 9

playlist delete <id> [--expect-rev REVISION]

screenrig playlist delete pl_01EXAMPLEPLAYLIST000000

playlist export <id> --output DIRECTORY [--skip-applications]

screenrig playlist export pl_01EXAMPLEPLAYLIST000000 --output ./lobby-bundle

playlist import <directory> [--name NAME] [--update ID [--expect-rev REVISION]] [--poll-ms MS] [--note TEXT]

screenrig playlist import ./lobby-bundle
screenrig playlist import ./lobby-bundle --name "Lobby loop (copy)"
screenrig playlist import ./lobby-bundle --update pl_01EXAMPLEPLAYLIST000000

playlist replace-release <id> --page PAGE_ID --primitive PRIMITIVE_ID --release-id REL_ID
                         [--apply [--expect-rev REVISION] [--expect-impact TOKEN] [--note TEXT]]

screenrig playlist replace-release pl_01EXAMPLEPLAYLIST000000 --page board-page --primitive board --release-id rel_NEW
screenrig playlist replace-release pl_01EXAMPLEPLAYLIST000000 --page board-page --primitive board --release-id rel_NEW --apply

Das Playlist-Dokument

Eine Playlist besteht aus name (1 bis 120 Zeichen) plus pages (1 bis 100), mit einem optionalen audio-Soundtrack und einem optionalen format. Jede Seite trägt id, canvas, transition, advance, optional visibility, optional audio_cue und primitives (1 bis 24). Seiten-, Primitiv- und Track-IDs sind ein Buchstabe gefolgt von bis zu 63 Buchstaben, Ziffern, _ oder -; Seiten-IDs sind in der Playlist eindeutig und Primitiv-IDs auf ihrer Seite. Ein canvas nimmt width und height von 1 bis 1.000.000, ein background und ein optionales viewport_fit: siehe Seitenhintergrund und Bewegung.

Ein format macht eine Playlist zu einer Videowand, {displays, arrangement, orientation} mit columns für ein grid, oder zu einem Streifen, {region, orientation}. Eine Wand hat 2 bis 12 Displays mit 1920 x 1080 (1080 x 1920 im Hochformat), jede gewöhnliche Seite hat die Leinwand der Wand, und das displays eines Primitivs nennt die Kacheln, die es abdeckt, anstelle von rect. Siehe Videowände und Streifen. Eine Werbeplatz-Seite, {id, type: "adslot", adslot_id} mit optionalem visibility, enthält keine Leinwand und keine Primitive; eine Playlist enthält höchstens 16 davon und behält eine gewöhnliche Seite ohne visibility.

Eine Vorlage fügt dem Dokument fields hinzu, [{name, label, type, required, max_length?}] mit type von text, media oder url, und kann jedes Primitiv als locked: true markieren. Eine Seite liest ein Feld als {field.NAME} in den params einer Karte (Text- und URL-Felder), als selector.media_id eines Bild- oder Videos (ein Medienfeld) oder als gesamtes src eines Iframes (ein URL-Feld). Jeder Platzhalter muss ein deklariertes Feld des richtigen Typs nennen, jedes Feld muss gelesen werden, und ein gesperrtes Primitiv liest keines; playlist validate prüft das offline. Nur die Inhaberin oder der Inhaber oder ein Mitglied, das genehmigen darf, ändert ein gesperrtes Primitiv (primitive_locked). Eine Vorlage deklariert höchstens 16 Felder: name hat 1 bis 32 Kleinbuchstaben, Ziffern oder Unterstriche, label bis zu 60 Zeichen und max_length eines Textfelds (Standard 200) bis zu 2000. Ein optionales Medien- oder URL-Feld ohne Wert lässt das Primitiv weg, das es liest. fields zu deklarieren und ein Primitiv zu sperren gehört zu den Playlist-Vorlagen, einer Premium-Funktion. Ein Videowand-format mit 2 oder 3 Displays erfordert Plus, eines mit 4 bis 12 Displays Enterprise. Ein Plan ohne die Funktion antwortet mit feature_not_in_plan und required_plan, während ein Schreibvorgang, der behält, was die Playlist schon hat, offen bleibt. Eine Kopie aus einer Vorlage zu erstellen ist in jedem Plan enthalten.

Die sechs Primitive sind image, hochgeladenes video, Live-stream, Web-iframe und application sowie card. Text und Rahmen sind keine Wire-Typen: Platzieren Sie eine card für Live-Text oder laden Sie ein fertiges Standbild hoch, das Ihr Agent erstellt hat, und platzieren Sie es als Bild.

Ein Stream verwendet eine oder zwei geordnete Quellen mit einzigartigen Protokollen und ein bereites Bild aus demselben Projekt als fallback_media_id. Verwenden Sie höchstens einen Stream pro Seite und dauerbasierte Fortschritte. HLS verwendet eine öffentliche HTTPS-URL; Android- und Qt-Player verbinden sich einschließlich der Anmeldedaten direkt mit RTSP-Kamerastreams. Die Details zum Kameratransport beschreiben die URL-Formate, die jeder Player öffnet; optionales direktes UDP/MPEG-TS-Multicast auf Android und Qt verwendet eine IPv4-Gruppe in 239/8 und einen Port. Eine Quelle kann nur ihre url angeben und das Schema das Protokoll bestimmen lassen. Andere Player wählen die HLS-Alternative oder zeigen den Fallback an. Stream-Bytes werden für die Wiedergabe nicht zwischengespeichert. Audio ist standardmäßig stummgeschaltet; muted auf false gesetzt spielt es ab, nach den unten beschriebenen Regeln für den Ton eines Videos. Der Import und Export von Playlist-Bundles unterstützt keine Streams.

{
  "id": "live",
  "primitive": "stream",
  "sources": [
    {
      "protocol": "udp-mpegts",
      "group": "239.10.0.1",
      "port": 5000
    },
    {
      "protocol": "hls",
      "url": "https://example.com/live.m3u8"
    }
  ],
  "fallback_media_id": "med_fallback",
  "muted": true,
  "rect": {
    "x": 0,
    "y": 0,
    "width": 1920,
    "height": 1080
  },
  "layer": 0,
  "content_fit": "contain"
}

Verwenden Sie dieses Primitive auf einer Seite mit advance: {"mode":"duration","after_ms":30000}. Ersetzen Sie den Beispiel-Feed und die Fallback-ID. Player-Anforderungen und Transport-Einrichtung.

Jedes Primitiv ist flach: id, primitive, die eigenen Felder dieses Primitivs, dann rect, layer, content_fit und optional enter und motion. Es gibt kein verschachteltes Inhaltsobjekt. rect ist x, y, width und height in Leinwandeinheiten und layer eine ganze Zahl von 0 bis 1024. Ein rect darf für den Anschnitt über die Leinwand hinausreichen: Player passen den Inhalt an das gesamte rect an und beschneiden dann auf die Leinwand, verwenden Sie also content_fit cover oder fill, um die sichtbare Leinwand zu füllen. Eine Karte wird durch layout platziert und benötigt ein rect nur für free; bei einer Wand-Playlist wird rect durch displays ersetzt.

Bild- und Video-Primitive erfordern ein selector. selector.by ist id mit einem bereiten media_id und one_at_a_time false, ids mit 1 bis 1.024 eindeutigen bereiten media_ids, all für jedes bereite Objekt dieses Primitivs, tag passend zu ^[A-Za-z0-9]{1,32}$, oder folder mit dem folder_id eines vorhandenen mfd_ Medienordners, der die bereiten Dateien direkt darin abspielt und keine seiner Unterordner. Setzen Sie media_id nicht auf das Primitiv selbst und senden Sie keine vom Server aufgelösten Elemente. Ein application-Primitiv fixiert ein release_id und ein iframe-Primitiv nimmt ein src und einen title von 1 bis 200 Zeichen, sodass keines von beiden einen Selektor akzeptiert. src ist jede http- oder https-Seite, die der Bildschirm erreichen kann, einschließlich einer LAN-Seite oder einer Seite hinter einem Login; ein YouTube-Link wird als sein automatisch abspielendes Embed gespeichert. src und das optionale fallback_src eines Iframes können Bildschirm-Token wie {screen.field.kiosk_id} tragen, und ein application-Primitiv kann params mit denselben Token tragen, sodass eine Playlist jedem Bildschirm seine eigene Seite gibt. Die Player für Android, Amazon Signage Stick, Linux, Raspberry Pi und Windows öffnen die Seite selbst. Die Player-Web-App und die Player für macOS, Samsung Tizen, LG webOS und BrightSign binden sie in einen Frame ein, sodass eine Seite, die X-Frame-Options sendet (DENY, SAMEORIGIN oder das veraltete ALLOW-FROM), oder eine Content-Security-Policy-frame-ancestors-Liste ohne den Ursprung des Players dort einen blockierten Frame zeigt, und die Player-Web-App zeigt nur https-Seiten ohne Login in der Adresse. Erkennt das Veröffentlichen eine öffentliche HTTPS-Seite, die das Einbetten verweigert, gelingt der Schreibvorgang trotzdem, und die CLI gibt den warnings-Eintrag des Servers aus: Code iframe_framing_refused, page_id, primitive_id und src, den Header, der abgelehnt hat, und den nächsten Schritt (eine Seite verwenden, die das Einbetten vom Ursprung des Players erlaubt, oder deren Inhaber bitten, diesen Ursprung zu erlauben). Der Server hängt außerdem eine playlist.iframe_framing_refused-Warnung an das Ereignisprotokoll an, eine pro ablehnender Seite, die events list mit primitive_id ausgibt. Eine LAN-Seite, eine http-Seite und eine Seite, die der Server innerhalb weniger Sekunden nicht erreicht, werden nicht geprüft. Ein Player meldet eine Playlist als spielend, sobald ihr Manifest auf dem Bildschirm ist, sodass ein verifiziertes Veröffentlichen nicht beweist, dass eine Iframe-Seite gerendert wurde: Handeln Sie auf die Warnung oder sehen Sie auf den Bildschirm. Beide Web-Primitive erfordern content_fit von fill, weil keines eine intrinsische Größe hat.

Ein iframe nimmt außerdem reload_s (0, der Standard, lädt nie neu; 60 bis 86400 lädt src alle reload_s Sekunden erneut, solange die Seite auf dem Bildschirm ist), fallback_src (die Seite, die angezeigt wird, wenn src nicht lädt, mit den Formen und Regeln von src; ein wiederhergestelltes src ersetzt sie beim nächsten Neuladen) und navigation_allowlist (1 bis 64 Host-Quellen der Form [scheme://]host[:port][path], etwa example.com, *.example.com oder https://example.com/docs/; mit einer Liste erreichen die Links, skriptgesteuerten Navigationen und Weiterleitungen der Seite nur src, fallback_src und passende Adressen; weglassen für keine Einschränkung, eine leere Liste wird abgelehnt). Ein eingefügter <iframe>-Embed-Code wird auf sein src gelesen. Eine Freigabe, ein „Im Web veröffentlichen“- oder Einbettungslink von Google Slides, Docs oder Sheets oder ein Embed-Link von Microsoft 365 wird für den Bildschirm neu aufgebaut gespeichert: Slides- und PowerPoint-Präsentationen laufen in einer Schleife, eine Slides-Präsentation schaltet mit der eigenen Verzögerung des Links weiter, begrenzt auf die Seitendauer (geben Sie der Seite die Zeit der gesamten Präsentation), und Docs, Sheets, Word und Excel laden alle 5 Minuten neu. Eine Datei, die Betrachter zur Anmeldung auffordert, wird mit document_not_shared abgelehnt, dessen Detail die zu ändernde Freigabeeinstellung nennt. Siehe Eine Webseite, ein Video oder ein Dokument anzeigen.

advance.mode ist duration mit after_ms, das auf einer Seite mit genau einem YouTube-Video (keine Playlist und kein Livestream) auch until mit dem Wert video_end tragen kann, damit die Seite bis zum Ende des Videos läuft und after_ms die Anzeigedauer ist, wenn der Bildschirm die Länge des Videos nicht lesen kann, media_end auf einer Seite mit genau einem Bild- oder Videoelement, audio_end auf einer Seite, deren audio_cue eine Soundtrack-Spur benennt, oder application mit max_ms, wenn die App ihren eigenen Zug beendet, indem sie window.screenrig.nextPage() aufruft. Eine application-Seite benötigt genau ein als controller markiertes Element; jeder andere Modus verbietet das. after_ms, max_ms und dwell_ms sind ganze Millisekunden von 1.000 bis 86.400.000, und ein Bild auf einer media_end-Seite benötigt dwell_ms. Eine Seite enthält höchstens ein stream und höchstens zwei application- oder iframe-Elemente, und media_end verbietet beides.

transition.type ist eines von crossfade, swipe-left, swipe-right, swipe-up, swipe-down, dip, wipe-left, wipe-right, wipe-up, wipe-down, slide-left, slide-right, slide-up, slide-down oder stinger. duration_ms ist erforderlich, Werte von 0 bis 60000. playlist init schreibt einen 200 ms Crossfade. Swipe bewegt beide Seiten zusammen wie ein Karussell. Slide schiebt die eingehende Seite über die ausgehende, die um ein Viertel mitgezogen wird. Wipe deckt die eingehende Seite hinter einer bewegten harten Kante auf. Dip blendet die ausgehende Seite zu einer Vollfarbe aus und dann zur eingehenden Seite ein; color ist ein optionaler #RRGGBB, Standard #000000, und gilt nur für dip. Richtungsnamen bezeichnen die Bewegungsrichtung: wipe-left ist eine Kante, die nach links bewegt wird. ease ist optional: linear, in, out oder in-out; Standard ist linear für crossfade und swipe-* sowie in-out für dip, wipe-* und slide-*; nicht erlaubt bei stinger. Die eingehende Seite besitzt ihre eigene Transition. Die erste Seite einer Playlist spielt keine Transition ab.

Ein Stinger ist eine thematische Vollbildgrafik, die die ausgehende Seite überdeckt, während der Bildschirm bedeckt ist die eingehende Seite einblendet und sie dann wieder freigibt. Verwenden Sie ihn, um einen Abschnitt einer Playlist zu benennen: Setzen Sie ihn auf die erste Seite des Abschnitts. Das stinger-Objekt ist für type: "stinger" erforderlich und bei anderen Typen nicht erlaubt. Alle seine Mitglieder sind optional. theme ist eines von neomustard (Standard), cyanotype, propaganda, signal, avant-garde, bloom oder primetime und entspricht den Kartenthemen. title ist bis zu 40 Zeichen lang und subtitle bis zu 60, eingestellt im Anzeigetyp des Themas. logo ist media: plus die ID eines bereiten Bildes im Projekt, zum Beispiel media:med_01EXAMPLE. accent ist ein optionales #RRGGBB, das den Akzent des Themas ersetzt. duration_ms für einen Stinger liegt zwischen 2000 und 6000 und deckt den gesamten Bumper ab; typische Längen sind 2700 bis 4000. Der Titel bleibt für hang_ms vollständig sichtbar, 0 bis 6000, Standard 1000 (eine Sekunde), und hang_ms beträgt höchstens 60 Prozent von duration_ms; ein längeres Verweilen benötigt eine längere duration_ms. Ein Player, der keinen Stinger darstellen kann, spielt eine Crossfade mit derselben Länge. Siehe die Live-Stinger-Karten-Seite, um die Übergangswiedergabe zu sehen.

Das folgende Beispiel zeigt einen Stinger-Seitenübergang:

{ "type": "stinger", "duration_ms": 3500, "stinger": { "theme": "primetime", "title": "BREAKFAST", "subtitle": "Served until 11", "logo": "media:med_01EXAMPLE", "hang_ms": 1000 } }

Ein optionales enter Objekt an einem Primitiv fügt eine Objektanimation hinzu: fade-up, fade-down, fade-left, fade-right, fade-in, zoom-in oder zoom-out, und ein optionales stagger von 0 bis 8 verzögert den Start um 120 ms pro Schritt. Ein optionales motion hält ein Primitiv nach dem Eintritt in Bewegung: spin und drift drehen oder verschieben ein Bild oder Video, und path bewegt ein Bild, Video, eine Anwendung oder ein Iframe entlang von Wegpunkten. Siehe Seitenhintergrund und Bewegung.

Ein optionales Seiten-visibility Objekt begrenzt, wann die Seite abgespielt wird: ein erforderliches enabled Boolean, optionale zivile from und until Grenzen und bis zu 16 wiederkehrende windows von Tagen und zivilen Zeiten. from und until sind YYYY-MM-DDTHH:MM in der Zeitzone jedes Bildschirms, from inklusiv und until exklusiv und später als from; ein Fenster ist days (mon bis sun) mit start und end als HH:MM, zusammen angegeben oder beide weggelassen für den ganzen Tag, und ein end bei oder vor start überschreitet Mitternacht. enabled: false blendet die Seite aus; enabled: true benötigt mindestens eines von from, until, windows oder data. Jede Playlist behält mindestens eine Seite ohne jegliches visibility Feld. Ein Bildschirm liest diese Zeiten in seiner effektiven Zeitzone: seiner Überschreibung, sonst der vom Player gemeldeten Zone, sonst UTC.

Eine Seitenbedingung visibility.data, {key, path?, equals?}, zeigt die Seite nur an, solange ein Kartendaten-Dokument passt: key ist ein Kartendaten-Schlüssel oder eine Karten-ID, path ein RFC-6901-Zeiger in das Dokument und equals eine Zeichenfolge, Zahl, ein Boolean oder null (weglassen, um zu prüfen, ob der Wert existiert). Der Schlüssel {screen.weather} liest das Wetter am eigenen Standort jedes Bildschirms, den screen update ID --location LAT,LON festlegt: {"enabled":true,"data":{"key":"{screen.weather}","path":"/condition","equals":"rain"}} zeigt die Seite nur an, solange es dort regnet, wo der Bildschirm steht. Das Wetterdokument enthält condition (clear, cloud, fog, rain, snow, storm oder wind), band (freezing unter 0 °C, cold 0 bis 9, mild 10 bis 17, warm 18 bis 24, hot ab 25), temperatureC in ganzen Grad und isDay. Es ist das aktuelle Wetter der 0,25-Grad-Zelle des Bildschirms, etwa stündlich aktualisiert, keine Vorhersage. Ein Bildschirm ohne Standort zeigt die Seite nie an, und das Veröffentlichen lehnt einen path oder einen equals ab, den das Dokument nicht enthalten kann, etwa cloudy statt cloud. Bei einem Player, der die Host-Fähigkeit page.conditions nicht deklariert, ist eine solche Seite deaktiviert. Datenbedingungen sind eine Plus-Funktion: Ohne sie erhält ein Schreibvorgang, der einer Seite eine visibility.data-Bedingung hinzufügt, die sie noch nicht hat, feature_not_in_plan, während das Behalten oder Entfernen einer gespeicherten Bedingung und die Sichtbarkeit nach Zeitfenstern offen bleiben. Behalten Sie eine gewöhnliche Seite ohne visibility als Ersatz.

Ein video- oder stream-Primitive spielt stumm, sofern es nicht muted auf false setzt. Dann spielt es seinen Ton mit der Lautstärke des Bildschirms, solange seine Seite aktuell ist, und diese Seite pausiert den Playlist-Soundtrack, der auf der nächsten Seite ohne Ton an derselben Stelle fortgesetzt wird. Mehrere Primitive auf einer Seite spielen alle ihren Ton. Eine Seite mit Ton kann kein audio_cue tragen: Ein Schreibvorgang, der eines hinzufügt, antwortet mit invalid_request bei pages[i].audio_cue, „a page with sound cannot cue the soundtrack“, während eine gespeicherte ältere Seite, die beides hat, weiterspielt. Werbung bleibt stumm.

Ein optionales Top-Level-audio Objekt fügt einen Soundtrack hinzu, der kontinuierlich spielt, während sich die Seiten ändern, und pausiert auf einer Seite mit Ton. tracks listet 1 bis 128 Einträge in Wiedergabereihenfolge auf, jeder mit einer eindeutigen id (dem Seiten-ID-Muster) und der media_id eines bereiten audio Medienobjekts. loop ist standardmäßig true und startet nach dem letzten Track wieder beim ersten; volume ist standardmäßig 1 und reicht von 0 bis 1, multipliziert mit der Player-Lautstärke; cued ist standardmäßig false und true stoppt den Soundtrack nach jedem Track, sodass ein Track nur spielt, wenn eine Seite audio_cue ihn startet. Eine gewöhnliche Seite kann audio_cue mit einer track ID aus dieser Liste und einem optionalen restart Boolean (Standard false) tragen: Wenn die Seite erscheint, wechselt der Player zu diesem Track von dessen Anfang, startet ihn nur neu, wenn er bereits spielt und restart true ist. Cues sind Hinweise, Werbeplatz-Seiten können sie nicht tragen, und ein Cue ohne Soundtrack wird abgelehnt. Eine Seite mit advance {"mode":"audio_end"} endet, wenn der Track, den ihr audio_cue benennt, endet, benötigt also diesen Cue und einen Soundtrack, nimmt kein after_ms und folgt den duration Regeln für Bild- und Video-Primitives; ein stream Primitive benötigt weiterhin eine duration Seite, und eine Anwendung auf der Seite ist niemals deren Steuerung; max_ms ist ein optionaler Hinweis, den der Server überschreibt. playlist update ersetzt das gesamte Dokument, sodass das Weglassen von audio den Soundtrack entfernt; playlist patch behält ihn, sofern nicht audio angegeben wird, und --clear-audio oder audio: null entfernt ihn. Ein Streifen hat keinen Soundtrack. Soundtrack-Erstellung.