Zum Hauptinhalt springen

v0-Handoff — Idle-DOOH & Farben

Was​

Kurze Übergabe an v0-Entwickler nach Cockpit 0.1.782+ (Idle-Quelle screenCockpit) und 0.1.780+ (overlayColor, 0.1.781+ colorTokens): welche API-Aufrufe gleich bleiben, welche Felder neu ausgewertet werden müssen, und was bewusst nicht im Frontend passiert.

Warum​

Idle-Werbung aus screenCockpit läuft serverseitig über cockpitOS — v0 soll keine zweite Playlist-Logik bauen. Farben und Hintergrund-Overlay sind dagegen Frontend-Aufgaben; ohne v0-Implementierung bleibt die Stele optisch beim alten Stand, obwohl das Dashboard Werte liefert.

Wer ist betroffen​

  • v0 / Signage-Team: Implementierung und QA.
  • Redaktion: Pflegt Quelle und Farben im Cockpit — siehe Petersbogen-Pilot-Checkliste.
  • Cockpit / Backend: Liefert gemappte dooh/active-Antwort und Template-Optionen — keine v0-Änderung nötig.

Wo​

ThemaQuelle
Idle-PlaylistGET /api/centers/{centerId}/dooh/active (Slug idle, wie bisher aus apiHints / Signage-Surface)
DOOH-SchalterenableDoohIdle, ggf. Vollbild-Slot — signage-surface / signage-template-options
Berührungs-Button Ruhemodusoptions.kiosk.idleTouchHint — ab Cockpit 0.1.785 (v0 liest bereits aus)
Farben erweitertoptions.kiosk.colorTokens — GET …/signage-template-options?template=ai-premium (+ orientation=)
Hintergrund-Overlayoptions.kiosk.backgroundMedia — dimPercent, overlayColor
Idle-Quelle (nur Cockpit)Dashboard DOOH Video → Idle-Quelle des Kiosks — v0 liest nicht die Playlist-ID

Ausführliche Feldliste: AI Premium v0-Parität.


1. Idle-DOOH — unverändert für v0​

Pflicht​

  • Bei Inaktivität weiter GET …/dooh/active (typisch Slug idle).
  • Antwortformat unverändert: playlist.items[] als DoohSlot (VIDEO / IMAGE, payload.url, durationSeconds, …).
  • Signage-Optionen wie bisher: enableDoohIdle (+ optional Vollbild) aus der Surface.

Optional — Feld source​

Die Antwort kann zusätzlich enthalten:

"source": "cockpit"

oder

"source": "screencockpit"
WertBedeutung
cockpitItems aus cockpitOS-Playlist idle
screencockpitItems aus der im Cockpit gewählten screenCockpit-Playlist (serverseitig gemappt)

v0 darf source ignorieren — Wiedergabe nur über playlist.items. Empfohlen für QA: in Debug/Logs mit ausgeben.

Bei Fehler, fehlender Verbindung oder leerer screenCockpit-Playlist liefert cockpitOS Fallback auf die cockpitOS-idle-Playlist (source dann "cockpit").

Verboten​

  • Kein direkter Aufruf von screenCockpit im Browser.
  • Kein API-Key von screenCockpit in v0/Vercel-Env.
  • Keine parallele Playlist-Logik neben dooh/active.

Copy-Paste fürs v0-Team​

Idle-DOOH bleibt bei GET …/dooh/active?slug=idle.
Redaktion wählt im Cockpit unter DOOH Video → Idle-Quelle des Kiosks cockpitOS oder screenCockpit + Playlist; der Kiosk-Code bleibt gleich.
Optional response.source loggen.
Bei Störung liefert das Cockpit Fallback auf die cockpitOS-idle-Playlist.


2. Aufgaben v0 — colorTokens​

Was: Bis zu 24 optionale Hex-/RGB-Felder unter kiosk.colorTokens, Namen wie CSS-Variablen der Legacy-Petersbogen-App (inkl. logoBackground für die Logo-Box oben). Pro Orientierung Deep-Merge über kiosk.byOrientation.portrait|landscape.colorTokens.

Implementierung (Soll):

  • Pro gesetztem Feld CSS-Variable --k-<feldname> setzen (z. B. --k-hotPickBackground).
  • Fehlendes Feld = bisherige Automatik (kein Default erzwingen).
  • promoBox.backgroundColor / promoBox.textColor haben Vorrang vor ctaText* in der Info-Box.
  • logoBackground / logoOverride: Ist logoBackground gesetzt oder ein Logo-Override aktiv, Logo in Originalfarben darstellen (nicht erzwungen weiß auf dunklem Schema); --k-logoBackground setzen, wenn das Feld gesetzt ist.
  • Priorität accentColor vs. colors.accent: festlegen und dokumentieren (Cockpit trennt beide; Companion bevorzugt oft colors.accent).

Templates: nur ai-premium und ai-wayfinding.


3. Aufgaben v0 — backgroundMedia.overlayColor​

Was: Abdunklung über Video/Bild-Hintergrund: dimPercent (0–80) und overlayColor (#rrggbb, Default in API oft #000000).

Implementierung (Soll):

  • Farbe mit dimPercent mischen, z. B. Overlay rgba(overlayColor, dimPercent / 100) über dem Medium.
  • GET …/signage-template-options?orientation=portrait|landscape liefert gemergte Werte pro Format.

Ohne Auswertung bleibt der Hintergrund visuell wie vor 0.1.780.


4. Aufgaben v0 — idleTouchHint.animation​

Was: Berührungs-Button im DOOH-Vollbild-Ruhemodus — Cockpit liefert enabled, Text, Farben und animation: pulse | none (ab 0.1.785). Keine Rhythmus-Parameter in der API.

Implementierung (Soll, Referenz v0 CSS k-touch-hint-cycle):

animationRhythmus
pulse16 s Gesamtzyklus: 8 s sichtbar (inkl. dezenter Puls), 1 s Fade-out, 6 s ausgeblendet, 1 s Fade-in — Endlosschleife
noneButton durchgehend sichtbar, ohne Ein-/Ausblenden und ohne Puls

Barrierefreiheit: Bei prefers-reduced-motion: reduce Button dauerhaft sichtbar halten (kein 8+1+6+1-Rhythmus), unabhängig von pulse/none.

Redaktion wählt im Cockpit nur pulse vs. none — Zeiten nicht im Dashboard änderbar.


6. Suchmodus Stele (enableKeyboardSearch, ab Cockpit 0.1.814)​

Was: Neben enableAiSearch liefert das Cockpit enableKeyboardSearch (Default true, optional pro Orientierung). v0 leitet den Suchmodus ab: KI-Suche nur bei enableAiSearch und data.bots.companion.companionChatEnabled; sonst Tastatur-Suche, wenn enableKeyboardSearch an.

Cockpit: Reiter Module → Abschnitt „Suche an der Stele“; Companion-KI unter Bots & Assistenten → Companion-App.

Details: AI Premium v0-Parität — Kiosk-Optionen.


So testen​

  1. Center mit enableDoohIdle, Idle-Quelle screenCockpit (Pilot): Network → dooh/active → Items abspielen; optional source: "screencockpit".
  2. Fallback: Quelle cockpitOS oder Verbindung trennen → weiterhin Items, source: "cockpit".
  3. Dashboard: ein colorTokens-Feld setzen → in API sichtbar → nach v0-Implementierung an der Stele prüfen.
  4. overlayColor + dimPercent setzen → Overlay sichtbar nach v0-Implementierung.
  5. Vollständiger Pilot: Petersbogen-Pilot-Checkliste.

Siehe auch​

Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /digital-signage/v0-handoff-idle-und-farben