292 lines
6.6 KiB
Markdown
292 lines
6.6 KiB
Markdown
# Cabinet Digital Signage - Quick Start Guide
|
|
|
|
## 🚀 Schnellstart nach Video-Optimierung
|
|
|
|
### Was wurde geändert?
|
|
|
|
Die Display-Software wurde **massiv optimiert** um das Problem mit schwarzen Bildschirmen nach längerer Laufzeit zu beheben.
|
|
|
|
### ✅ Version 1.3 Features:
|
|
|
|
1. **Video-Cleanup** - Speicher wird nach jedem Video freigegeben
|
|
2. **Watchdog** - Überwacht ob Videos laufen und recovered automatisch
|
|
3. **Start-Timeout** - Videos die nicht starten werden übersprungen
|
|
4. **Error Recovery** - Automatischer Skip bei defekten Videos
|
|
5. **Memory-Monitoring** - Speicherüberwachung alle 10 Minuten
|
|
6. **Präventiver Reload** - Automatischer Neustart alle 6 Stunden
|
|
7. **Performance-Boost** - CSS Hardware-Beschleunigung aktiviert
|
|
|
|
---
|
|
|
|
## 📱 Display Setup
|
|
|
|
### 1. Display aufrufen
|
|
```
|
|
https://cabinet.b2in.eu
|
|
```
|
|
|
|
### 2. Vollbild aktivieren
|
|
- Klicke auf **"V 1.3"** Button oben links
|
|
- Display wechselt in Vollbildmodus
|
|
- Button verschwindet automatisch
|
|
|
|
⚠️ **WICHTIG:** Bei einem Page-Reload (nach 6h oder bei Fehlern) wird der Vollbildmodus beendet. Du siehst dann einen **orange pulsierenden Button** mit "⚠️ Vollbild aktivieren!". Einfach erneut klicken.
|
|
|
|
💡 **Besser:** Nutze **Fully Kiosk Browser** für permanenten Vollbild ohne manuelles Klicken. Siehe `KIOSK_MODE_SETUP.md`
|
|
|
|
### 3. Laufen lassen
|
|
- Display läuft jetzt automatisch 24/7
|
|
- Automatischer Reload alle 6 Stunden
|
|
- Watchdog überwacht Video-Playback
|
|
- Bei Problemen: Automatische Self-Recovery
|
|
|
|
---
|
|
|
|
## 📊 Monitoring
|
|
|
|
### Log-Viewer öffnen:
|
|
```
|
|
https://cabinet.b2in.eu/view-logs.php
|
|
```
|
|
|
|
### Was solltest du sehen:
|
|
|
|
#### ✅ Normale Logs (alles OK):
|
|
```
|
|
[INFO] Video started: video1.mp4
|
|
[INFO] Video cleanup durchgeführt
|
|
[INFO] Heartbeat - Display is running
|
|
[INFO] Memory Status: 45% (230MB / 512MB)
|
|
[INFO] Playlist-Loop abgeschlossen
|
|
```
|
|
|
|
#### ⚠️ Warnungen (beobachten):
|
|
```
|
|
[WARNING] Video stalled (buffering)
|
|
[WARNING] Hohe Speicherauslastung (85%)
|
|
[WARNING] Überspringe zum nächsten Video
|
|
```
|
|
|
|
#### ❌ Fehler (Action nötig):
|
|
```
|
|
[ERROR] Video start timeout
|
|
[ERROR] Video Error: MEDIA_ERR_NETWORK
|
|
[ERROR] Kritischer Zustand erkannt
|
|
[FATAL] JavaScript Error
|
|
```
|
|
|
|
---
|
|
|
|
## 🎬 Video-Upload Checklist
|
|
|
|
Beim Hochladen neuer Videos beachten:
|
|
|
|
### ✅ Must-Have:
|
|
- [ ] Format: **MP4** (H.264 + AAC)
|
|
- [ ] Auflösung: **Max 1920x1080**
|
|
- [ ] Bitrate: **5-10 Mbps**
|
|
- [ ] Dateigröße: **Max 200 MB**
|
|
- [ ] Länge: **15-60 Sekunden** (optimal)
|
|
|
|
### ⚠️ Vermeiden:
|
|
- ❌ Zu große Dateien (>200MB)
|
|
- ❌ Zu hohe Bitrate (>10 Mbps)
|
|
- ❌ Zu lange Videos (>3 Min)
|
|
- ❌ Exotische Formate (MOV, AVI, WMV)
|
|
- ❌ 4K Videos (overkill für Display)
|
|
|
|
### 🔧 Video optimieren (FFmpeg):
|
|
```bash
|
|
ffmpeg -i input.mp4 \
|
|
-c:v libx264 -preset slow -crf 23 \
|
|
-c:a aac -b:a 128k \
|
|
-vf scale=1920:1080 \
|
|
-movflags +faststart \
|
|
output.mp4
|
|
```
|
|
|
|
---
|
|
|
|
## 🐛 Troubleshooting
|
|
|
|
### Problem: Schwarzer Bildschirm
|
|
|
|
#### Schritt 1: Logs checken
|
|
```
|
|
→ Öffne view-logs.php
|
|
→ Schaue nach ERROR oder FATAL Logs
|
|
```
|
|
|
|
#### Schritt 2: Was sagt das Log?
|
|
|
|
**"Video start timeout"**
|
|
- Video lädt nicht → Check Video-URL
|
|
- Video zu groß → Komprimieren
|
|
- Netzwerkproblem → Check Internet
|
|
|
|
**"Video Error: MEDIA_ERR_NETWORK"**
|
|
- Netzwerk-Issue → Check Router/Internet
|
|
- Server down → Check b2in.eu erreichbar
|
|
|
|
**"Video definitiv stuck"**
|
|
- ✅ Watchdog hat recovered!
|
|
- Video wurde übersprungen
|
|
- Nächstes Video sollte laufen
|
|
|
|
**"Hohe Speicherauslastung"**
|
|
- Videos zu groß → Komprimieren
|
|
- Zu viele Videos → Playlist verkleinern
|
|
- Warte auf automatischen Reload (alle 6h)
|
|
|
|
#### Schritt 3: Manuelle Actions
|
|
|
|
**Display neu laden:**
|
|
```javascript
|
|
// In Browser-Console (F12):
|
|
location.reload();
|
|
```
|
|
|
|
**Display komplett neustarten:**
|
|
```
|
|
1. Browser schließen
|
|
2. Warten 10 Sekunden
|
|
3. Browser neu öffnen
|
|
4. URL aufrufen
|
|
5. Vollbild aktivieren
|
|
```
|
|
|
|
### Problem: Video buffert ständig
|
|
|
|
#### Ursachen:
|
|
- Internetverbindung zu langsam
|
|
- Video-Bitrate zu hoch
|
|
- Netzwerk überlastet
|
|
|
|
#### Lösung:
|
|
1. **Check Internet:** Speedtest machen
|
|
2. **Videos optimieren:** Bitrate reduzieren (5 Mbps)
|
|
3. **Playlist reduzieren:** Weniger Videos = weniger Daten
|
|
4. **Router prüfen:** Neustart? Kabel OK?
|
|
|
|
### Problem: Footer läuft, Video nicht
|
|
|
|
#### Das war das Haupt-Problem! Jetzt gefixt durch:
|
|
- ✅ Video-Cleanup nach jedem Video
|
|
- ✅ Watchdog erkennt stuck Videos
|
|
- ✅ Automatischer Skip/Recovery
|
|
- ✅ Memory-Management
|
|
- ✅ Präventiver Reload alle 6h
|
|
|
|
#### Falls es DOCH noch passiert:
|
|
```
|
|
1. Logs checken: view-logs.php
|
|
2. Memory-Status prüfen
|
|
3. Watchdog-Logs suchen
|
|
4. Falls >3 Fehler: Display reload automatisch
|
|
5. Falls nicht: Manuell reloaden
|
|
```
|
|
|
|
---
|
|
|
|
## 📞 Support
|
|
|
|
### Bei Problemen:
|
|
|
|
1. **Logs sichern:**
|
|
- Öffne view-logs.php
|
|
- Download/Screenshot der Fehler
|
|
- Besonders ERROR und FATAL Logs
|
|
|
|
2. **Info sammeln:**
|
|
- Welches Display (IP/Standort)?
|
|
- Wann trat Problem auf?
|
|
- Was zeigen die Logs?
|
|
- Memory-Status?
|
|
|
|
3. **Kontakt:**
|
|
- Mit Log-Auszug
|
|
- Screenshots
|
|
- Display-Info
|
|
|
|
---
|
|
|
|
## 🎯 Monitoring-Routine
|
|
|
|
### Täglich (optional):
|
|
- [ ] Kurzer Blick auf Display (läuft es?)
|
|
- [ ] Bei Problemen: Logs checken
|
|
|
|
### Wöchentlich:
|
|
- [ ] Logs checken (view-logs.php)
|
|
- [ ] Statistiken ansehen (Fatal/Error/Warning)
|
|
- [ ] Memory-Status prüfen
|
|
- [ ] Watchdog-Interventionen zählen
|
|
|
|
### Monatlich:
|
|
- [ ] Alte Logs aufräumen (>30 Tage automatisch)
|
|
- [ ] Video-Performance überprüfen
|
|
- [ ] Playlist aktualisieren
|
|
- [ ] Display-Uptime checken
|
|
|
|
---
|
|
|
|
## 💡 Tipps & Tricks
|
|
|
|
### Performance optimieren:
|
|
- Halte Playlist klein (5-10 Videos)
|
|
- Optimiere Videos vor Upload
|
|
- Nutze konsistente Video-Auflösung
|
|
- Vermeide sehr lange Videos (>2 Min)
|
|
|
|
### Zuverlässigkeit erhöhen:
|
|
- Lass präventiven Reload aktiv (6h)
|
|
- Check Logs wöchentlich
|
|
- Halte Internet-Verbindung stabil
|
|
- Nutze kabelgebundenes Netzwerk statt WiFi
|
|
|
|
### Memory sparen:
|
|
- Videos komprimieren (H.264, CRF 23)
|
|
- Playlist auf 10 Videos limitieren
|
|
- Preload='metadata' (bereits aktiv)
|
|
- Automatischer Cleanup (bereits aktiv)
|
|
|
|
---
|
|
|
|
## ✨ Neue Features nutzen
|
|
|
|
### Auto-Recovery:
|
|
```
|
|
Display recovered jetzt automatisch von:
|
|
✅ Stuck Videos (Watchdog)
|
|
✅ Video-Ladefehlern (Skip)
|
|
✅ Start-Timeouts (Skip)
|
|
✅ Memory-Problemen (Reload nach 6h)
|
|
✅ Kritischen Fehlern (Reload)
|
|
```
|
|
|
|
### Logging:
|
|
```
|
|
Alle Events werden geloggt:
|
|
📊 Video-Start/Ende
|
|
📊 Memory-Status
|
|
📊 Fehler und Warnungen
|
|
📊 Watchdog-Interventionen
|
|
📊 Heartbeats (Display läuft)
|
|
```
|
|
|
|
### Monitoring:
|
|
```
|
|
Live-Überwachung möglich:
|
|
🔍 view-logs.php
|
|
🔍 Auto-Refresh alle 10s
|
|
🔍 Statistiken (Fatal/Error/Warning)
|
|
🔍 Farbcodierung nach Schwere
|
|
```
|
|
|
|
---
|
|
|
|
**Version:** 1.3
|
|
**Release:** 2026-01-19
|
|
**Status:** ✅ Production Ready
|
|
|
|
🎉 **Viel Erfolg mit dem optimierten Display!**
|