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
| Thema | Quelle |
|---|---|
| Idle-Playlist | GET /api/centers/{centerId}/dooh/active (Slug idle, wie bisher aus apiHints / Signage-Surface) |
| DOOH-Schalter | enableDoohIdle, ggf. Vollbild-Slot — signage-surface / signage-template-options |
| Berührungs-Button Ruhemodus | options.kiosk.idleTouchHint — ab Cockpit 0.1.785 (v0 liest bereits aus) |
| Farben erweitert | options.kiosk.colorTokens — GET …/signage-template-options?template=ai-premium (+ orientation=) |
| Hintergrund-Overlay | options.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 Slugidle). - Antwortformat unverändert:
playlist.items[]alsDoohSlot(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"
| Wert | Bedeutung |
|---|---|
cockpit | Items aus cockpitOS-Playlist idle |
screencockpit | Items 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.
Optionalresponse.sourceloggen.
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.textColorhaben Vorrang vorctaText*in der Info-Box.logoBackground/logoOverride: IstlogoBackgroundgesetzt oder ein Logo-Override aktiv, Logo in Originalfarben darstellen (nicht erzwungen weiß auf dunklem Schema);--k-logoBackgroundsetzen, wenn das Feld gesetzt ist.- Priorität
accentColorvs.colors.accent: festlegen und dokumentieren (Cockpit trennt beide; Companion bevorzugt oftcolors.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
dimPercentmischen, z. B. Overlayrgba(overlayColor, dimPercent / 100)über dem Medium. GET …/signage-template-options?orientation=portrait|landscapeliefert 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):
animation | Rhythmus |
|---|---|
pulse | 16 s Gesamtzyklus: 8 s sichtbar (inkl. dezenter Puls), 1 s Fade-out, 6 s ausgeblendet, 1 s Fade-in — Endlosschleife |
none | Button 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
- Center mit
enableDoohIdle, Idle-Quelle screenCockpit (Pilot): Network →dooh/active→ Items abspielen; optionalsource: "screencockpit". - Fallback: Quelle cockpitOS oder Verbindung trennen → weiterhin Items,
source: "cockpit". - Dashboard: ein
colorTokens-Feld setzen → in API sichtbar → nach v0-Implementierung an der Stele prüfen. overlayColor+dimPercentsetzen → Overlay sichtbar nach v0-Implementierung.- Vollständiger Pilot: Petersbogen-Pilot-Checkliste.
Siehe auch
Nutzungsstatistik: Seitenaufrufe werden anonymisiert erfasst. Im Umami-Dashboard nach diesem Pfad filtern: /en/digital-signage/v0-handoff-idle-und-farben