23-01-2026
This commit is contained in:
parent
07959c0ba2
commit
854ce02bf6
166 changed files with 32909 additions and 1262 deletions
292
public/_cabinet/QUICK_START.md
Normal file
292
public/_cabinet/QUICK_START.md
Normal file
|
|
@ -0,0 +1,292 @@
|
|||
# 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 100 MB**
|
||||
- [ ] Länge: **15-60 Sekunden** (optimal)
|
||||
|
||||
### ⚠️ Vermeiden:
|
||||
- ❌ Zu große Dateien (>100MB)
|
||||
- ❌ 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!**
|
||||
Loading…
Add table
Add a link
Reference in a new issue