Display-Bildschirme
Kernplattformdisplay_brand_settings_writeDisplay-BildschirmeChanges Display Screens settings shared by every facility in the facility's brand: the boot screen shown while screens start up, the settings new screens start with, and what templated content shows. Organisation admins only; read the current values and canEdit with display_settings_read boot_screen, screen_defaults or templated.
Actions:
- save_boot_screen: Save the boot screen. Sets the boot screen image (PNG, JPEG or WebP, up to 10 MB, from a public https imageUrl or imageBase64) and/or how it is laid out. Without an image, fit and background re-render the current one. Screens pick it up when they next start. Asks for confirmation.
- reset_boot_screen: Reset the boot screen. Removes the brand's boot screen; screens go back to the default one when they next start. Asks for confirmation.
- save_screen_defaults: Save the screen defaults. The settings a screen starts with when it is paired at one of the brand's facilities. Only the settings you pass change. Screens that are already paired keep their own settings; change those with device_inventory_write configure_screen. Asks for confirmation.
- save_templated: Save templated content settings. What templated content screens and the Schedule show: the data source name, workout names, programs in the Schedule and how far ahead, training phases and how far ahead, and Program Builder training camps (one banner per week) and how far ahead. Asks for confirmation.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "save_boot_screen" | "reset_boot_screen" | "save_screen_defaults" | "save_templated" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
imageUrl | string | Öffentliche https-URL des Bildes (save_boot_screen) |
imageBase64 | string | Das Bild als base64, wenn keine URL vorhanden ist (save_boot_screen) |
fit | "logo" | "fill" | (save_boot_screen) |
background | string | Hintergrundfarbe (#RRGGBB) (save_boot_screen) |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
orientation | "normal" | "left" | "right" | "inverted" | Screen rotation (save_screen_defaults) |
airplayEnabled | boolean | Screens accept AirPlay (save_screen_defaults) |
sessionTimerEnabled | boolean | Synchronised session timer (master clock) and its bells (save_screen_defaults) |
sonosEnabled | boolean | Sonos speaker control (save_screen_defaults) |
duressEnabled | boolean | Bluetooth duress button monitoring (save_screen_defaults) |
cameraRestreamingEnabled | boolean | Restream local camera feeds from the screen (save_screen_defaults) |
wifiSupport | boolean | Captive Wi-Fi setup portal (save_screen_defaults) |
showSourceName | boolean | (save_templated) |
showWorkoutNames | boolean | (save_templated) |
showProgramsInSchedule | boolean | (save_templated) |
programLookaheadDays | integernull | Tage im Voraus (0–90) oder null für keine Begrenzung (save_templated) |
showTrainingPhases | boolean | (save_templated) |
phaseLookaheadDays | integernull | Tage im Voraus (0–90) oder null für keine Begrenzung (save_templated) |
showTrainingCamps | boolean | (save_templated) |
campLookaheadDays | integernull | Tage im Voraus (0–90) oder null für keine Begrenzung (save_templated) |
confirm | boolean | Erst setzen, nachdem der Benutzer die vom ersten Aufruf zurückgegebene Vorschau bestätigt hat |
display_groups_writeDisplay-BildschirmeErstellt, benennt um und löscht Display-Screen-Gruppen in einer Einrichtung und legt fest, welche Bildschirme dazugehören. Gruppen sind Veröffentlichungsziele (display_publish targets.groupIds) und Befehlsziele (display_screen_command groupIds). Werden mehrere Bildschirme, Gruppen oder Ziele angegeben, wirkt der Aufruf auf alle gleichzeitig; stimmen Sie sich mit dem Benutzer ab, bevor Sie viele ändern.
Aktionen:
- save: Gruppe speichern. Erstellen: name (und optional screenIds). Umbenennen: groupId (ID oder aktueller Name) und name. screenIds ersetzt die Mitglieder; nicht aufgeführte Bildschirme verlassen diese Gruppe, behalten aber ihre anderen Gruppen.
- delete: Gruppe löschen. Löscht eine Gruppe: Ihre Bildschirme verlassen sie (sie behalten ihre anderen Gruppen), und für die Gruppe veröffentlichte Inhalte werden aus dem Zeitplan entfernt. Erfordert groupId. Fragt nach einer Bestätigung.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "save" | "delete" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
groupId | string | ID oder Name einer bestehenden Gruppe, um sie umzubenennen oder ihre Mitglieder zu ändern |
name | string | Gruppenname (beim Erstellen erforderlich) (save) |
screenIds | array | Bildschirme in der Gruppe; ersetzt die aktuellen Mitglieder (save) |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
confirm | boolean | Erst setzen, nachdem der Benutzer die vom ersten Aufruf zurückgegebene Vorschau bestätigt hat |
display_hosted_apps_writeDisplay-BildschirmeVeröffentlicht statische HTML-Apps („gehostete Apps“) für Display Screens. Rufen Sie zuerst display_library_read app_guidelines für Bildschirmgrößen, Gestaltungsregeln, Limits und das SDK auf und anschließend display_screenshot, um das Ergebnis auf einem Bildschirm zu prüfen. Werden mehrere Bildschirme, Gruppen oder Ziele angegeben, wirkt der Aufruf auf alle gleichzeitig; stimmen Sie sich mit dem Benutzer ab, bevor Sie viele ändern.
Aktionen:
- publish: Gehostete App veröffentlichen. Erstellt eine gehostete App (name + files) oder veröffentlicht eine neue Version (appId + files; sie wird überall live, wo die App angezeigt wird, rollback macht dies rückgängig). publishTo bringt sie außerdem auf Bildschirme, wie display_publish; ein Marken- oder Organisationsziel erfordert confirm. Erfordert files. Kann nach einer Bestätigung fragen.
- rollback: Gehostete App zurücksetzen. Macht eine frühere Version wieder zur aktuellen, überall, wo die App angezeigt wird. Versionen auflisten mit display_library_read app_versions. Erfordert appId, version.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "publish" | "rollback" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
appId | string | ID einer bestehenden gehosteten App (app_…), von der eine neue Version veröffentlicht werden soll |
name | string | App-Name (beim Erstellen erforderlich) (publish) |
files | array | Die App-Dateien. encoding ist utf8 (Standard) oder base64 für Binärdateien. (publish) |
entry | string | HTML-Einstiegsdatei (Standard index.html) (publish) |
durationSec | number | Standard-Anzeigedauer in Playlists, in Sekunden (publish) |
tags | array | (publish) |
ownerScope | "facility" | "brand" | "organisation" | Wem neue Inhalte gehören (Standard facility). brand und organisation erfordern organisationsweiten Zugriff. (publish) |
publishTo | object | (publish) |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
version | integer | Version, die zur aktuellen werden soll (rollback) |
confirm | boolean | Erst setzen, nachdem der Benutzer die vom ersten Aufruf zurückgegebene Vorschau bestätigt hat |
display_library_readDisplay-BildschirmeLiest die für eine Einrichtung sichtbare Display-Screens-Library: Medien (Bilder, Videos), Apps (Webseiten, gehostete HTML-Apps, KI-Agent-Apps, Videoüberwachungsansichten) und Playlists sowie KI-Agent-Apps und Videoüberwachungsquellen, die hinzugefügt werden können.
Jedes Element hat eine contentRef (media#…, app#…, playlist#…) für display_publish und Playlists. ownerScope zeigt, wem es gehört (facility#, brand# oder org#); Inhalte können nur innerhalb ihres Eigentümers veröffentlicht werden. Medien mit dem Status processing sind noch nicht bereit; failed muss erneut hochgeladen werden. Webseiten mit frameable: false können nicht in Playlists abgespielt werden, nur als ganzseitiger Bildschirm. Elemente mit displayIssue werden von Bildschirmen übersprungen: eine KI-Agent-App, die unveröffentlicht, pausiert, display-off, auf eine Zielgruppe beschränkt oder ohne Custom Apps ist; eine Videoüberwachungsansicht mit no-cctv, cctv-off (ein Einrichtungsadministrator aktiviert Videoüberwachung für Bildschirme in den Display-Screens-Einstellungen) oder no-cameras.
Aktionen:
- list: Library-Elemente auflisten. Medien und Apps (seitenweise; Filter nach type, kind, tag oder name) oder mit type agent-apps die auf Bildschirmen zugelassenen KI-Agent-Apps, die Sie mit display_publish content.agentAppId veröffentlichen können. Jedes Element hat einen type: media, app oder agent-app.
- cctv_sources: Videoüberwachungsquellen auflisten. Die Kameras und geteilten Live Views der Einrichtung für display_publish content.cctv und ob Videoüberwachung auf Bildschirmen aktiviert ist. Erfordert Zugriff auf Videoüberwachung in der Einrichtung.
- get: Library-Element abrufen. Ein Medienelement, eine App oder eine Playlist per contentRef. Erfordert contentRef.
- usages: Wo Inhalte verwendet werden. Die Zuweisungen im Live-Zeitplan und die Playlists, die ein Medienelement oder eine App verwenden (oder die Zuweisungen einer Playlist). Verwendete Inhalte können nicht gelöscht werden. Erfordert contentRef.
- app_versions: Versionen einer gehosteten App auflisten. Die Versionen einer gehosteten App und welche aktuell ist, für display_hosted_apps_write rollback. Erfordert appId.
- app_guidelines: Richtlinien für gehostete Apps. Bildschirmgrößen, Gestaltungsregeln, Bundle-Limits, das Display App SDK und eine Startvorlage. Rufen Sie dies auf, bevor Sie eine App für display_hosted_apps_write publish erstellen.
- check_url: Webseite prüfen. Ob eine Webseite in Playlists angezeigt werden kann (manche Websites lassen sich nicht einbetten), mit Hinweisen zur Darstellung. Seiten, die das Einbetten verweigern, können trotzdem ein ganzseitiger Bildschirm sein. Erfordert url.
- playlists: Playlists auflisten. Für die Einrichtung sichtbare Playlists (seitenweise), jeweils mit ihren Elementen (contentRef, duration, fit).
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "list" | "cctv_sources" | "get" | "usages" | "app_versions" | "app_guidelines" | "check_url" | "playlists" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
type | "media" | "apps" | "agent-apps" | Nur eine Art von Element (Standard: Medien und Apps) (list) |
kind | "image" | "video" | "url" | "hosted" | "agent-app" | "cctv-view" | (list) |
tag | string | Nur Elemente mit diesem Tag (list) |
search | string | Namensfilter ohne Berücksichtigung der Groß-/Kleinschreibung (list) |
limit | integer | Elemente pro Seite (Standard 25, höchstens 100) (list, playlists) |
cursor | string | nextCursor der vorherigen Seite (list, playlists) |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. (list, cctv_sources, get, usages, app_versions, check_url, playlists) |
contentRef | string | media#<id>, app#<id> oder playlist#<id>, aus display_library_read list oder playlists (get, usages) |
appId | string | ID der gehosteten App (app_…) (app_versions) |
url | string | Öffentliche https-URL (check_url) |
display_library_writeDisplay-BildschirmeFügt Inhalte zur Display-Screens-Library hinzu und ändert sie: Bilder und Videos hochladen, Apps für Webseiten, KI-Agent-Apps und Videoüberwachungsansichten erstellen, Namen, Tags, Dauer und Daten bearbeiten, ungenutzte Elemente löschen und die Vorschau einer App aktualisieren. Gehostete HTML-Apps werden mit display_hosted_apps_write veröffentlicht, Playlists mit display_playlists_write.
Gestalten Sie Bilder in 1920×1080 (Querformat) oder 1080×1920 (Hochformat). Neue Medien beginnen mit dem Status processing, während webtaugliche Versionen erstellt werden; sie können sofort in Playlists aufgenommen werden und werden abgespielt, sobald sie bereit sind. ownerScope: facility (Standard), brand oder organisation (brand und organisation erfordern organisationsweiten Zugriff).
Aktionen:
- upload_media: Bild oder Video hochladen. Fügt ein Bild oder Video aus einer öffentlichen https-url (bevorzugt; Bilder bis 25 MB, Videos bis 200 MB) oder als base64 mit mimeType (bis 20 MB) hinzu. Bilder im Format JPEG, PNG, WebP, GIF; Videos im Format MP4, WebM, MOV (konvertiert in H.264 MP4 bis 1080p). Größere Videos: create_video_upload.
- create_video_upload: Upload eines großen Videos starten. Für Videos bis 2 GB: legt das Video an und gibt einen vorsignierten Upload zurück (laden Sie die Datei per PUT mit upload.headers vor upload.expiresAt an upload.url hoch) und rufen Sie dann transcode mit seiner contentRef auf. Erfordert name, mimeType, bytes.
- transcode: Video verarbeiten. Konvertiert ein Video für Bildschirme: nach create_video_upload, erneut nach einem Fehler oder für ein älteres Video, das Bildschirme nicht abspielen können. Erfordert contentRef.
- create_app: App hinzufügen. Fügt eine Webseite (kind url, url übergeben; wird auf Einbettbarkeit geprüft), eine KI-Agent-App (kind agent-app, agentAppId aus display_library_read list type agent-apps übergeben) oder eine Videoüberwachungsansicht (kind cctv-view, im Besitz der Einrichtung, erfordert Zugriff auf Videoüberwachung) hinzu. Erfordert kind, name.
- update: Library-Element aktualisieren. Ändert Name, Tags oder Dauer eines Medienelements oder einer App; validFrom/validTo eines Medienelements (ISO, null löscht; außerhalb davon wird es übersprungen); die url einer Webseite; oder Kameras, Ansicht, Layout oder Qualität einer Videoüberwachungsansicht. Erfordert contentRef.
- delete: Library-Element löschen. Löscht ein Medienelement oder eine App. Gesperrt, solange es in einem Live-Zeitplan oder einer Playlist ist: Der Fehler listet diese auf (entfernen Sie sie zuerst mit display_schedule_write delete oder display_playlists_write save). Erfordert contentRef. Fragt nach einer Bestätigung.
- refresh_preview: Vorschau einer App aktualisieren. Erstellt einen neuen Screenshot einer App für ihre Library-Vorschau (zum Beispiel nachdem sich die Seite geändert hat). Erfordert contentRef.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "upload_media" | "create_video_upload" | "transcode" | "create_app" | "update" | "delete" | "refresh_preview" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
url | string | Öffentliche https-URL des Bildes oder Videos (bevorzugt) (upload_media, create_app, update) |
base64 | string | Dateiinhalt als base64 (max. 20 MB), wenn keine URL vorhanden ist (upload_media) |
mimeType | string | Bei base64 erforderlich, z. B. image/png (upload_media, create_video_upload) |
name | string | Name in der Library (upload_media, create_video_upload, create_app, update) |
tags | array | Tags (ersetzen die aktuellen Tags) (upload_media, create_video_upload, create_app, update) |
ownerScope | "facility" | "brand" | "organisation" | Wem neue Inhalte gehören (Standard facility). brand und organisation erfordern organisationsweiten Zugriff. (upload_media, create_video_upload, create_app) |
durationSec | number | Standard-Anzeigedauer für Bilder, in Sekunden (upload_media, create_app, update) |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
bytes | integer | Dateigröße in Byte (create_video_upload) |
resolution | "720" | "1080" | "1440" | "2160" | "original" | Maximale Größe, in die das Video für Bildschirme konvertiert wird (Standard 1080; original behält die Größe bei) (create_video_upload, transcode) |
contentRef | string | media#<id>, app#<id> oder playlist#<id>, aus display_library_read list oder playlists (transcode, update, delete, refresh_preview) |
kind | "url" | "agent-app" | "cctv-view" | (create_app) |
agentAppId | string | KI-Agent-Apps: die App-ID (create_app) |
source | "view" | "cameras" | Videoüberwachungsansichten: view (viewId übergeben) oder cameras (cameras übergeben) (create_app, update) |
viewId | string | Videoüberwachungsansichten: Live-View-ID (display_library_read cctv_sources) (create_app, update) |
cameras | array | Videoüberwachungsansichten: Kamera-IDs (display_library_read cctv_sources) (create_app, update) |
layout | "auto" | "1x1" | "2x1" | "1+2" | "2x2" | "1+5" | "2x3" | "3x3" | Videoüberwachungsansichten: Kachel-Layout (create_app, update) |
quality | "auto" | "native" | "1080p" | "720p" | "480p" | "360p" | "240p" | Videoüberwachungsansichten: Stream-Qualität (create_app, update) |
showNames | boolean | Videoüberwachungsansichten: Kameranamen auf den Kacheln anzeigen (create_app, update) |
validFrom | stringnull | Medien: ISO-Datum und -Uhrzeit, ab der es abgespielt wird; null löscht (update) |
validTo | stringnull | Medien: ISO-Datum und -Uhrzeit, ab der es nicht mehr abgespielt wird; null löscht (update) |
confirm | boolean | Erst setzen, nachdem der Benutzer die vom ersten Aufruf zurückgegebene Vorschau bestätigt hat |
display_playlists_writeDisplay-BildschirmeErstellt, aktualisiert und löscht Display-Screens-Playlists: geordnete Schleifen aus Medien und Apps. Änderungen erreichen jeden Bildschirm, der die Playlist zeigt, innerhalb von Sekunden. Veröffentlichen Sie eine Playlist mit display_publish content.contentRef "playlist#
Aktionen:
- save: Playlist speichern. Erstellen: name + items (items darf leer sein). Aktualisieren: playlistId + beliebige von name, items, transition; items ersetzt die gesamte Liste, senden Sie also jedes Element in der richtigen Reihenfolge.
- delete: Playlist löschen. Löscht eine Playlist. Gesperrt, solange sie irgendwo veröffentlicht ist: Der Fehler listet die Zuweisungen auf, die zuerst entfernt werden müssen (display_schedule_write delete). Erfordert playlistId. Fragt nach einer Bestätigung.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "save" | "delete" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
playlistId | string | ID einer bestehenden Playlist (pl_…), die aktualisiert werden soll |
name | string | Name der Playlist (beim Erstellen erforderlich) (save) |
transition | "fade" | "none" | (save) |
ownerScope | "facility" | "brand" | "organisation" | Wem neue Inhalte gehören (Standard facility). brand und organisation erfordern organisationsweiten Zugriff. (save) |
items | array | Die gesamte Liste in Reihenfolge (ersetzt die aktuellen Elemente; behalten Sie itemId bei, um ein Element zu behalten). Webseiten mit frameable: false werden nicht abgespielt. (save) |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
confirm | boolean | Erst setzen, nachdem der Benutzer die vom ersten Aufruf zurückgegebene Vorschau bestätigt hat |
display_publishDisplay-BildschirmeBringt Inhalte auf Display Screens: ein Medienelement, eine Playlist, eine App, eine Webseite, eine KI-Agent-App oder eine Live-Ansicht der Videoüberwachung, auf Bildschirme, Gruppen, die Einrichtung, ihre Marke oder ihre Organisation.
mode: now (Standard) ersetzt, was die Ziele normalerweise anzeigen; scheduled zeigt den Inhalt nur in wöchentlichen Zeitfenstern (Zeitzone der Einrichtung) und/oder zwischen from und to; takeover unterbricht alles für durationMin (oder bis zu einem Zeitpunkt) und endet dann von selbst (vorzeitig beenden mit display_takeover_stop). Bildschirme ermitteln die Anzeige zuerst nach Ebene (takeover > scheduled > default), dann danach, wie spezifisch das Ziel ist (screen > group > facility > brand > organisation).
Videoüberwachung: Live-Kamerabilder sind für alle in der Nähe der Bildschirme sichtbar. Der erste Aufruf gibt requiresConfirmation zurück (Code CCTV_CONFIRMATION_REQUIRED); fragen Sie den Benutzer und rufen Sie dann erneut mit confirmCctv: true auf. In der Einrichtung muss "Allow CCTV on display screens" aktiviert sein.
Nur Bildschirme im Player-Modus zeigen veröffentlichte Inhalte; andere werden in warnings aufgeführt. Gibt eine batchId zurück; display_schedule_write delete mit dieser ID macht die gesamte Veröffentlichung rückgängig. Werden mehrere Bildschirme, Gruppen oder Ziele angegeben, wirkt der Aufruf auf alle gleichzeitig; stimmen Sie sich mit dem Benutzer ab, bevor Sie viele ändern.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
targets* | object | Wohin Inhalte gehen. Beliebig kombinierbar. Gruppennamen funktionieren ebenso wie IDs. brand und organisation erfordern organisationsweiten Zugriff auf Display Screens. |
content* | object | Was angezeigt werden soll: genau eines von contentRef, url, agentAppId oder cctv. |
mode | "now" | "default" | "scheduled" | "takeover" | `now`/`default` (Standard): ersetzt, was die Ziele normalerweise anzeigen. `scheduled`: nur in den Zeitfenstern und/oder zwischen from und to. `takeover`: unterbricht alles für durationMin (oder bis zu einem Zeitpunkt) und endet dann von selbst. |
windows | array | Wöchentliche Zeitfenster in der Zeitzone der Einrichtung. days sind ISO-Wochentage (1 = Montag … 7 = Sonntag); start/end sind "HH:MM" (end "24:00" erlaubt). |
from | string | ISO-Datum und -Uhrzeit, zu der eine geplante Veröffentlichung beginnt |
to | string | ISO-Datum und -Uhrzeit, zu der eine geplante Veröffentlichung endet |
durationMin | number | Dauer des Takeovers in Minuten (max. 7 Tage) |
until | string | ISO-Datum und -Uhrzeit, zu der ein Takeover endet (anstelle von durationMin) |
priority | integer | Entscheidet zwischen sich überschneidenden geplanten Elementen (höherer Wert gewinnt) |
confirmCctv | boolean | Erst setzen, nachdem der Benutzer die Anzeige der Live-Videoüberwachung ausdrücklich bestätigt hat |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
confirm | boolean | Erst setzen, nachdem der Benutzer die vom ersten Aufruf zurückgegebene Vorschau bestätigt hat |
display_schedule_readDisplay-BildschirmeLiest, was auf Display Screens veröffentlicht ist: für einen Bildschirm, was er zu einem Zeitpunkt und über einen Zeitraum anzeigt (aufgelöst über alle Ebenen und Ziele, von denen er erbt), sowie die Zuweisungen, die ihn erreichen; oder die Zuweisungen, die für eine Gruppe, die Einrichtung, ihre Marke oder ihre Organisation veröffentlicht sind.
Zuweisungs-IDs (as_…) und Batch-IDs (bt_…) sind das, was display_schedule_write aktualisiert oder löscht. Zeiten sind im ISO-Format; Zeitfenster gelten in der Zeitzone der Einrichtung.
Aktionen:
- get: Zeitplan eines Bildschirms abrufen. Was ein Bildschirm zu
at(Standard jetzt) anzeigt, seine Zeitleiste vonfrombisto(Standard 24 Stunden) und jede Zuweisung, die ihn erreicht. Erfordert screenId. - list_assignments: Zuweisungen auflisten. Zuweisungen, die für eine Gruppe (groupId) oder für die Einrichtung, ihre Marke oder ihre Organisation (target, Standard facility) veröffentlicht sind. Seitenweise, neueste Änderung zuerst.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "get" | "list_assignments" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
screenId | string | Bildschirm-ID (der 6-stellige Code) aus display_screens_read list (get) |
at | string | ISO-Datum und -Uhrzeit, für die geprüft wird, was läuft (Standard jetzt) (get) |
from | string | Beginn der Zeitleiste im ISO-Format (Standard at, sonst jetzt) (get) |
to | string | Ende der Zeitleiste im ISO-Format (Standard 24 Stunden nach from) (get) |
includeExpired | boolean | Beendete Zuweisungen einbeziehen |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
groupId | string | ID oder Name der Bildschirmgruppe, aus display_screens_read groups (list_assignments) |
target | "facility" | "brand" | "organisation" | Wenn keine groupId angegeben ist (Standard facility) (list_assignments) |
limit | integer | Elemente pro Seite (Standard 25, höchstens 100) (list_assignments) |
cursor | string | nextCursor der vorherigen Seite (list_assignments) |
display_schedule_writeDisplay-BildschirmeÄndert, was auf Display Screens veröffentlicht ist: Zeitsteuerung, Priorität oder Inhalt einer Zuweisung bearbeiten (optional für die gesamte Veröffentlichung) oder eine Zuweisung bzw. eine ganze Veröffentlichung entfernen. IDs finden Sie mit display_schedule_read. Aus dem Zeitplan entfernte Inhalte bleiben in der Library; um einen Takeover vorzeitig zu beenden und seinen Verlauf zu behalten, verwenden Sie display_takeover_stop.
Aktionen:
- update: Zuweisung aktualisieren. Ändert Zeitsteuerung (wöchentliche Zeitfenster, from/to; null löscht ein Datum), Priorität oder Inhalt einer Zuweisung. applyToBatch wendet dieselbe Änderung auf jedes Ziel der Veröffentlichung an. Ein Takeover kann nur eine neue Endzeit erhalten. Inhalte der Videoüberwachung erfordern confirmCctv, nachdem der Benutzer zugestimmt hat. Erfordert assignmentId.
- delete: Aus dem Zeitplan entfernen. Entfernt eine Zuweisung (assignmentId) oder alles aus einer Veröffentlichung (batchId). Bildschirme kehren innerhalb von Sekunden zu dem zurück, was sie sonst anzeigen würden. Fragt nach einer Bestätigung.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "update" | "delete" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
assignmentId | string | Eine Zuweisung (as_…) aus display_schedule_read |
applyToBatch | boolean | Dieselbe Änderung auf jedes Ziel der Veröffentlichung anwenden (update) |
windows | array | Wöchentliche Zeitfenster in der Zeitzone der Einrichtung. days sind ISO-Wochentage (1 = Montag … 7 = Sonntag); start/end sind "HH:MM" (end "24:00" erlaubt). (update) |
from | stringnull | ISO-Datum und -Uhrzeit des Beginns; null löscht (update) |
to | stringnull | ISO-Datum und -Uhrzeit des Endes; null löscht (update) |
priority | integer | Entscheidet zwischen sich überschneidenden geplanten Elementen (höherer Wert gewinnt) (update) |
contentRef | string | media#<id>, app#<id> oder playlist#<id>, aus display_library_read list oder playlists (update) |
confirmCctv | boolean | Erst setzen, nachdem der Benutzer die Anzeige der Live-Videoüberwachung ausdrücklich bestätigt hat (update) |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
batchId | string | Eine ganze Veröffentlichung (bt_…) aus display_publish oder display_schedule_read, über alle ihre Ziele (delete) |
confirm | boolean | Erst setzen, nachdem der Benutzer die vom ersten Aufruf zurückgegebene Vorschau bestätigt hat |
display_screen_commandDisplay-BildschirmeSendet einen Live-Befehl an Display Screens in einer Einrichtung: reload (Player-Bildschirme laden ihren Zeitplan neu), identify (Name und Code des Bildschirms blinken, um ihn vor Ort zu finden), displayOn/displayOff (das TV-Panel), rebootDevice (startet den Computer des Bildschirms neu, 1–2 Minuten schwarz; erfordert confirm: true) oder osd (eine kurze Bildschirmmeldung; message übergeben).
Wählen Sie Bildschirme mit screenIds und/oder groupIds (jeder Bildschirm dieser Gruppen in der Einrichtung) oder allScreens: true für jeden Bildschirm der Einrichtung (displayOn/displayOff erreichen dann auch Bildschirme mit Templated content). Gibt Ergebnisse pro Bildschirm zurück. Werden mehrere Bildschirme, Gruppen oder Ziele angegeben, wirkt der Aufruf auf alle gleichzeitig; stimmen Sie sich mit dem Benutzer ab, bevor Sie viele ändern.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
screenIds | array | Bildschirm-IDs (die 6-stelligen Codes) aus display_screens_read list. Bei Verwendung von allScreens weglassen. |
groupIds | array | IDs oder Namen von Bildschirmgruppen: jeder Bildschirm dieser Gruppen in der Einrichtung |
allScreens | boolean | Jeder Bildschirm der Einrichtung, einschließlich Bildschirmen mit Templated content |
command* | "reload" | "identify" | "displayOn" | "displayOff" | "rebootDevice" | "osd" | Was getan werden soll (rebootDevice erfordert confirm) |
message | string | Text für osd |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
confirm | boolean | Erst setzen, nachdem der Benutzer die vom ersten Aufruf zurückgegebene Vorschau bestätigt hat |
display_screens_readDisplay-BildschirmeLiest die Display Screens einer Einrichtung: listet sie mit ihrem Status und dem, was jetzt und als Nächstes läuft (Filter nach Gruppe, Status oder Anzeigemodus), ruft alle Details und die Zeitleiste eines Bildschirms ab oder listet Bildschirmgruppen mit ihren Bildschirmen.
Der Anzeigemodus wird Benutzern als "Data Source" angezeigt: player ist "User managed content", program-builder ist "Templated content" (gegenüber Benutzern nie "Program Builder" sagen), url ist "Full-page website (Kiosk Mode)". Zeiten sind im ISO-Format; die Zeitzone der Einrichtung wird zurückgegeben.
Aktionen:
- list: Bildschirme auflisten. Bildschirme der Einrichtung (seitenweise), jeweils mit Status, letztem Heartbeat, Gruppen, Tags und dem, was jetzt und als Nächstes läuft. Gibt auch die Gruppen zurück.
- get: Bildschirm abrufen. Alle Details eines Bildschirms (Status, Heartbeat, Player-Version, letzte Fehler) und bei Player-Bildschirmen, was er über einen Zeitraum anzeigt (Standard die nächsten 24 Stunden, max. 14 Tage). Erfordert screenId.
- groups: Bildschirmgruppen auflisten. Bildschirmgruppen der Einrichtung (seitenweise), jeweils mit ihren Bildschirmen.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "list" | "get" | "groups" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
groupId | string | Nur Bildschirme in dieser Gruppe (ID oder Name) (list) |
status | "playing" | "provisioning" | "display-off" | "not-responding" | "offline" | "online" | (list) |
mode | "player" | "program-builder" | "url" | (list) |
limit | integer | Elemente pro Seite (Standard 25, höchstens 100) (list, groups) |
cursor | string | nextCursor der vorherigen Seite (list, groups) |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
screenId | string | Bildschirm-ID (der 6-stellige Code) aus display_screens_read list (get) |
from | string | Beginn der Zeitleiste im ISO-Format (Standard jetzt) (get) |
to | string | Ende der Zeitleiste im ISO-Format (Standard 24 Stunden nach from) (get) |
display_screens_writeDisplay-BildschirmeGeräteverwaltungÄndert Display Screens: einen neuen Bildschirm über seinen Kopplungscode koppeln; einen Bildschirm umbenennen, seine Gruppen und Tags festlegen oder seinen Anzeigemodus wechseln (Benutzern als "Data Source" angezeigt); das Token eines Player-Bildschirms erneuern; einen zeitlich begrenzten Vorschaulink für einen Bildschirm oder Inhalt erstellen; oder einen Bildschirm auf Werkseinstellungen zurücksetzen (entfernt ihn aus der Einrichtung).
Anzeigemodi: player ("User managed content"), url ("Full-page website (Kiosk Mode)", url übergeben, nur https), program-builder ("Templated content"; gegenüber Benutzern nie "Program Builder" sagen). Ein Moduswechsel lädt den Bildschirm sofort neu und ändert, was Mitglieder sehen, und erfordert daher eine Bestätigung durch den Benutzer.
Aktionen:
- update: Bildschirm aktualisieren. Legt Name, Gruppen (IDs oder Namen; ersetzt die aktuellen Gruppen), Tags (ersetzt sie) und/oder Anzeigemodus eines Bildschirms fest. Ein Moduswechsel gibt zuerst requiresConfirmation zurück. Erfordert screenId. Kann nach einer Bestätigung fragen.
- rotate_token: Bildschirm-Token erneuern. Stellt ein neues Token für einen Player-Bildschirm aus und lädt ihn neu; das alte Token funktioniert nicht mehr. Verwenden Sie dies, wenn die Player-URL eines Bildschirms möglicherweise offengelegt wurde. Erfordert screenId. Fragt nach einer Bestätigung.
- create_preview_link: Vorschaulink erstellen. Ein Link (zeitlich begrenzt gültig), der zeigt, was ein Bildschirm anzeigt oder wie Inhalte aussehen, optional zu einem zukünftigen Zeitpunkt. Jeder mit dem Link kann ihn bis zum Ablauf ansehen.
- reset: Bildschirm auf Werkseinstellungen zurücksetzen. Entfernt den Bildschirm aus der Einrichtung und setzt ihn auf Werkseinstellungen zurück; ein ausgeschalteter Bildschirm wird zurückgesetzt, sobald er wieder online ist, und zeigt dann seine Kopplungsseite. Übergeben Sie confirmName: den Bildschirmnamen genau so, wie der Benutzer ihn eingegeben hat. Erfordert Geräteverwaltung. Erfordert screenId, confirmName. Fragt nach einer Bestätigung.
- pair: Neuen Bildschirm koppeln. Fügt der Einrichtung einen neuen Bildschirm über den 6-stelligen Code auf seiner Kopplungsseite hinzu und lädt ihn dann neu. Einrichtungen mit nur Display Screens starten ihn im Modus player; mit zusätzlich Templated content entscheidet mode (Standard program-builder). Erfordert Geräteverwaltung. Erfordert pairingCode, name. Fragt nach einer Bestätigung.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "update" | "rotate_token" | "create_preview_link" | "reset" | "pair" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
screenId | string | Bildschirm-ID (der 6-stellige Code) aus display_screens_read list (update, rotate_token, create_preview_link, reset) |
name | string | Bildschirmname (update, pair) |
groupIds | array | Gruppen-IDs oder -Namen; ersetzt die aktuellen Gruppen (Gruppen erstellen mit display_groups_write save) (update) |
tags | array | Ersetzt die aktuellen Tags (update) |
mode | "player" | "program-builder" | "url" | Anzeigemodus ("Data Source") (update, pair) |
url | string | Website für den Modus url (https) (update) |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
contentRef | string | media#<id>, app#<id> oder playlist#<id>, aus display_library_read list oder playlists (create_preview_link) |
orientation | "landscape" | "portrait" | Für contentRef-Vorschauen (Standard landscape) (create_preview_link) |
at | string | ISO-Datum und -Uhrzeit für die Vorschau (Standard jetzt) (create_preview_link) |
confirmName | string | Der Name des Bildschirms, vom Benutzer zur Bestätigung eingegeben (muss genau übereinstimmen) (reset) |
pairingCode | string | Der Code, den der Bildschirm auf seiner Kopplungsseite anzeigt (0 und O sehen ähnlich aus) (pair) |
contentStream | string | Templated content: der Stream (Runde), den er abspielt, Standard 1 (pair) |
confirm | boolean | Erst setzen, nachdem der Benutzer die vom ersten Aufruf zurückgegebene Vorschau bestätigt hat |
display_screenshotDisplay-BildschirmeErfasst, was ein Display Screen gerade anzeigt, und gibt das Bild zurück, damit Sie Ihre Arbeit nach dem Veröffentlichen prüfen können (Layout, Textgröße, nichts abgeschnitten oder scrollend). Wartet bis zu 15 Sekunden auf die Antwort des Bildschirms; bei Offline-Bildschirmen tritt eine Zeitüberschreitung auf. Gibt außerdem eine Portal-URL für das JPEG zurück (nur für angemeldete Benutzer, 10 Minuten lang gespeichert).
Screenshots können Live-Videoüberwachung und sichtbare Mitglieder enthalten; teilen Sie sie nicht außerhalb der Unterhaltung.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
screenId* | string | Bildschirm-ID (der 6-stellige Code) aus display_screens_read list |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
display_settings_readDisplay-BildschirmeReads Display Screens settings for a facility: the fallback slate, polling and nightly reload, CCTV on screens; the screen power schedule (with the next days' on/off times); automations (brightness, bell volume, check-in power, round timer state); the brand's boot screen, screen defaults and templated content settings; and, with templated content, the scheduled program dates and the templated schedule.
Actions:
- settings: Get facility display settings. The fallback slate (message, background, logo, facility name), polling interval, nightly reload time and whether CCTV may be shown on screens.
- power_schedule: Get the power schedule. When screens turn on and off: the saved schedule (or the older automations' equivalent), the facility time zone and the on/off times for the next 7 days.
- power_schedule_preview: Preview a power schedule. The on/off times a schedule would give over the next 7 days, without saving it. Needs schedule.
- automations: Get display automations. Automatic brightness (day/night levels and triggers), bell volume levels and schedule (decimal hours, 6.5 = 06:30), check-in power, and the round timer state, for one or several facilities. usesGlobalDefaults is true until the facility saves its own.
- boot_screen: Get the brand's boot screen. The image the facility's brand shows while screens start up (fit, background, image URLs) and whether you can change it (organisation admins).
- screen_defaults: Get the brand's screen defaults. The settings a screen starts with when it is paired at one of the brand's facilities (orientation, screen mirroring, session timer, speaker control, duress monitoring, camera restreaming, Wi-Fi support) and whether you can change them (organisation admins). Screens that are already paired keep their own settings; see device_inventory_read for those.
- templated: Get the brand's templated content settings. What templated content screens and the Schedule show for the facility's brand (source name, workout names, programs and training phases, look-ahead days) and whether you can change it (organisation admins).
- program_dates: List scheduled program dates. The dates with a workout program, from the start of this month to the brand's look-ahead. Needs templated content (Program Builder) at the facility.
- templated_schedule: Get the templated schedule. Programs and training phases between two dates (YYYY-MM-DD, at most 62 days), as the brand shows them. Needs templated content (Program Builder) at the facility. Needs from, to.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "settings" | "power_schedule" | "power_schedule_preview" | "automations" | "boot_screen" | "screen_defaults" | "templated" | "program_dates" | "templated_schedule" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
schedule | object | Bildschirme sind während der besetzten Zeiten (um die Offsets erweitert) oder der benutzerdefinierten wöchentlichen Zeitfenster eingeschaltet, mit einer Feiertagsregel. (power_schedule_preview) |
facilityIds | array | Mehrere Einrichtungs-IDs, um dieselbe Anfrage für jede auszuführen. Anstelle von facilityId verwenden. (automations) |
from | string | Erstes Datum (YYYY-MM-DD) (templated_schedule) |
to | string | Letztes Datum (YYYY-MM-DD) (templated_schedule) |
display_settings_writeDisplay-BildschirmeÄndert die Display-Screens-Einstellungen einer Einrichtung: den Fallback Slate, Abfrage und nächtliches Neuladen sowie "Allow CCTV on display screens"; den Einschaltplan der Bildschirme; und Automatisierungen (Helligkeit, Glockenlautstärke, Einschalten bei Check-in). Weggelassene Felder behalten ihre aktuellen Werte. Markenweite Einstellungen (Boot screen, Templated content) finden Sie in display_brand_settings_write.
Aktionen:
- save_settings: Anzeigeeinstellungen der Einrichtung speichern. Der Fallback Slate, der angezeigt wird, wenn nichts geplant ist, Abfrageintervall (30–300 s), Uhrzeit des nächtlichen Neuladens (HH:mm) und allowCctv. Das Aktivieren von allowCctv erfordert eine Bestätigung durch den Benutzer und einen Einrichtungsadministrator mit Zugriff auf Videoüberwachung. Kann nach einer Bestätigung fragen.
- save_power_schedule: Einschaltplan speichern. Ändert, wann Bildschirme ein- und ausgeschaltet werden; die übergebenen Felder werden in den gespeicherten Plan übernommen. Gibt die Ein-/Ausschaltzeiten der nächsten 7 Tage zurück. Prüfen Sie zuerst mit display_settings_read power_schedule_preview. Erfordert schedule.
- save_automations: Display-Automatisierungen speichern. Ändert die Einstellungen für automatische Helligkeit, Glockenlautstärke und Einschalten bei Check-in. Die Einrichtung behält dann eigene Einstellungen statt der globalen Standardwerte.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "save_settings" | "save_power_schedule" | "save_automations" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
slate | object | (save_settings) |
pollIntervalSec | integer | (save_settings) |
nightlyReloadTime | string | HH:mm (save_settings) |
allowCctv | boolean | Videoüberwachung auf Bildschirmen zulassen (save_settings) |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
schedule | object | Bildschirme sind während der besetzten Zeiten (um die Offsets erweitert) oder der benutzerdefinierten wöchentlichen Zeitfenster eingeschaltet, mit einer Feiertagsregel. (save_power_schedule) |
autoPowerDisplays | boolean | Ältere Einschaltautomatisierung ein/aus (der Einschaltplan ersetzt sie) (save_automations) |
minsBeforeOpenDisplayOn | integer | Ältere Einschaltautomatisierung: Minuten vor der Öffnung (save_automations) |
minsAfterCloseDisplayOff | integer | Ältere Einschaltautomatisierung: Minuten nach der Schließung (save_automations) |
displaysOnCheckIn | boolean | Bildschirme einschalten, wenn jemand eincheckt (save_automations) |
minsLastCheckInDisplayOff | integer | Mit displaysOnCheckIn: Minuten nach dem letzten Check-in, nach denen sich die Bildschirme ausschalten (save_automations) |
enableAutoBrightness | boolean | Zwischen Tag- und Nachthelligkeit wechseln (save_automations) |
dayTriggerType | "auto" | "staffed" | "custom" | Wann die Taghelligkeit beginnt (save_automations) |
dayTimeStart | string | Für dayTriggerType custom: HH:mm (Ortszeit der Einrichtung) (save_automations) |
dayOffsetMinutes | integer | Minuten nach Sonnenaufgang oder Öffnung (save_automations) |
dayBrightnessLevel | integer | Taghelligkeit, % (save_automations) |
nightTriggerType | "auto" | "staffed" | "custom" | Wann die Nachthelligkeit beginnt (save_automations) |
nightTimeStart | string | Für nightTriggerType custom: HH:mm (Ortszeit der Einrichtung) (save_automations) |
nightOffsetMinutes | integer | Minuten nach Einbruch der Dunkelheit oder vor der Schließung (save_automations) |
nightBrightnessLevel | integer | Nachthelligkeit, % (save_automations) |
bellMasterLevel | integer | Gesamtlautstärke der Glocke, % (save_automations) |
bellClubHoursLevel | integer | Glockenlautstärke während der besetzten Zeiten, % (save_automations) |
bellExtendedHoursLevel | integer | Glockenlautstärke während der erweiterten Zeiten, % (save_automations) |
enableBellAutoVolume | boolean | Dem Zeitplan für die Glockenlautstärke folgen (save_automations) |
bellVolumeSchedule | object | Wöchentliche Glockenlautstärke-Blöcke pro Wochentag (mon … sun); ersetzt den gesamten Zeitplan (save_automations) |
confirm | boolean | Erst setzen, nachdem der Benutzer die vom ersten Aufruf zurückgegebene Vorschau bestätigt hat |
display_takeover_stopDisplay-BildschirmeBeendet laufende Display-Screens-Takeovers sofort: für eine Veröffentlichung (batchId aus display_publish), für Ziele (Standard: für die gesamte Einrichtung veröffentlichte Takeovers) oder mit allScreens für jeden Takeover, der für die Einrichtung, ihre Bildschirme oder deren Gruppen veröffentlicht ist. Takeovers von Marke und Organisation lassen sich nur per batchId beenden. Bildschirme kehren innerhalb von Sekunden zu ihren geplanten oder Standardinhalten zurück; gibt zurück, wie viele beendet wurden. Werden mehrere Bildschirme, Gruppen oder Ziele angegeben, wirkt der Aufruf auf alle gleichzeitig; stimmen Sie sich mit dem Benutzer ab, bevor Sie viele ändern.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
batchId | string | Die Takeover-Veröffentlichung (bt_…) aus display_publish |
targets | object | Wohin Inhalte gehen. Beliebig kombinierbar. Gruppennamen funktionieren ebenso wie IDs. brand und organisation erfordern organisationsweiten Zugriff auf Display Screens. |
allScreens | boolean | Jeder Takeover, der für die Einrichtung, ihre Bildschirme oder deren Gruppen veröffentlicht ist |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
display_templated_writeDisplay-BildschirmeSteuert Bildschirme mit Templated content (Anzeigemodus "Templated content" in display_screens_read): das Workout-Programm eines Tages darauf laden oder den Runden-Timer steuern. Bildschirme mit User managed content und ganzseitiger Website sind nie betroffen.
Aktionen:
- load_program: Workout-Programm laden. Lädt das Workout-Programm eines Datums (YYYY-MM-DD, Standard heute) aus der Datenquelle der Einrichtung auf jeden Bildschirm mit Templated content in einer oder mehreren Einrichtungen; Bildschirme laden innerhalb von Sekunden neu. Verwenden Sie dies, um das Workout von heute oder eines anderen Tages anzuzeigen oder wenn Bildschirme das falsche zeigen. Mehrere Einrichtungen erfordern confirm. Kann nach einer Bestätigung fragen.
- clock: Runden-Timer steuern. Startet, pausiert, startet neu oder stoppt den Runden-Timer auf Bildschirmen mit Templated content, schaltet Rundentöne stumm oder wieder ein, legt die Glockenlautstärke fest (setvolume mit volume 0–100) oder fragt seinen Status ab. Erfordert Templated content in der Einrichtung. Erfordert command.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
action* | "load_program" | "clock" | Was getan werden soll; jede Aktion ist in der Tool-Beschreibung erläutert. |
facilityIds | array | Mehrere Einrichtungs-IDs, um dieselbe Anfrage für jede auszuführen. Anstelle von facilityId verwenden. (load_program) |
date | string | Workout-Datum, YYYY-MM-DD (Standard heute) (load_program) |
facilityId | string | Einrichtungs-ID. Optional, wenn die verbundene Einrichtung gemeint ist. |
command | "getstate" | "play" | "pause" | "restart" | "stop" | "mute" | "unmute" | "setvolume" | (clock) |
volume | integer | Für setvolume: Glockenlautstärke, % (clock) |
confirm | boolean | Erst setzen, nachdem der Benutzer die vom ersten Aufruf zurückgegebene Vorschau bestätigt hat |