xiboplayerxiboplayer
EN

Resolució de problemes

Problemes de connexió

"Connection failed: NetworkError"

  • PWA: Verifiqueu que l'adreça del CMS coincideix amb el domini des del qual es serveix el reproductor (requisit de mateix origen). Utilitzeu Electron o Chromium per a configuracions amb orígens creuats.
  • Electron/Chromium: Comproveu que el CMS és accessible des del reproductor. Proveu curl https://your-cms.example.com/xmds.php des de la màquina del reproductor.

"Display not authorized"

  1. Aneu a CMS → Displays
  2. Cerqueu la vostra pantalla (estat: Waiting)
  3. Feu clic a Authorize
  4. Espereu fins a 30 segons o premeu D al reproductor per forçar una recollida

El reproductor mostra la insígnia "OFFLINE"

El reproductor ha perdut la connectivitat amb el CMS però encara mostra contingut en memòria cau. Comproveu:

  • La connexió de xarxa a la màquina del reproductor
  • La disponibilitat del CMS
  • Les regles del tallafocs (port 443 per a HTTPS, port 9505 per a XMR WebSocket)

Problemes de visualització

Pantalla negra

Electron:

# Check PWA files exist
ls -la ~/.local/share/xiboplayer/electron/pwa/

# Reinstall if missing
sudo dnf reinstall xiboplayer-electron

Chromium:

# Check if the server is running
curl http://localhost:8766/player/pwa/

Els dissenys no es mostren

  • Comproveu la consola del navegador (Electron: Ctrl+Shift+I en mode dev) per errors de descàrrega
  • Verifiqueu que la programació té dissenys actius assignats a aquesta pantalla al CMS
  • Premeu T per comprovar la línia de temps — si està buida, la programació encara no s'ha rebut
  • Premeu D per comprovar si els mitjans encara s'estan descarregant

El vídeo no es reprodueix

  • Instal·leu els controladors VAAPI per a la descodificació de vídeo per maquinari:
    • Intel: sudo dnf install libva-intel-media-driver
    • AMD: sudo dnf install mesa-va-drivers
    • NVIDIA: sudo dnf install libva-nvidia-driver (des de RPM Fusion)
  • Comproveu vainfo per verificar que la descodificació per maquinari funciona
  • Els fluxos HLS requereixen accés a la xarxa — no es poden emmagatzemar en memòria cau fora de línia

Problemes de servei

El reproductor no s'inicia

# Check if port 8765 is in use
ss -tlnp | grep 8765

# Try a different port
xiboplayer-electron --port=8080

# Check service logs
journalctl --user -u xiboplayer-electron.service -n 50

El servei no s'inicia automàticament

# Enable lingering (allows user service without login)
loginctl enable-linger $USER

# Re-enable the service
systemctl --user enable --now xiboplayer-electron.service

# Check status
systemctl --user status xiboplayer-electron.service

No es pot sortir del mode quiosc

  • Electron: Premeu Ctrl+Shift+F12 per al menú de la safata del sistema → Exit Player
  • Kiosk: Premeu Ctrl+R (drecera keyd) per reconfigurar, o connecteu-vos per SSH i executeu pkill xiboplayer
  • Des del terminal: pkill -f xiboplayer-electron o pkill -f chromium

Problemes de rendiment

Ús elevat de memòria

  • Comproveu si el contingut inclou imatges o vídeos molt grans
  • El reproductor limita les descàrregues segons la RAM del dispositiu — els dispositius amb poca memòria (< 4GB) utilitzen fragments més petits
  • Si la memòria continua creixent, comproveu si hi ha dissenys amb molts elements de vídeo concurrents

Descàrregues de mitjans lentes

  • Premeu D per veure el progrés i la velocitat de descàrrega
  • Comproveu l'amplada de banda de la xarxa cap al CMS
  • El reproductor utilitza 4 fragments de descàrrega paral·lels — assegureu-vos que el CMS/proxy invers permet connexions concurrents
  • Comproveu si hi ha una finestra de descàrrega configurada als ajustos de pantalla del CMS que pugui estar bloquejant les descàrregues

Problemes específics del quiosc

L'assistent de configuració no apareix

L'assistent s'executa només al primer arrencada quan no existeix cap configuració del CMS. Per tornar-lo a activar:

# Remove existing config and restart
rm -f ~/.config/xiboplayer/config.json
systemctl --user restart xibo-player.service

O premeu Ctrl+R (drecera keyd) per reconfigurar.

La pantalla s'apaga / entra en suspensió

El quiosc desactiva l'apagament de pantalla mitjançant gsettings i logind, però si encara passa:

# Verify settings
gsettings get org.gnome.desktop.session idle-delay
# Should be 0

# Check logind
loginctl show-session $(loginctl | grep xibo | awk '{print $1}') -p IdleAction
# Should be ignore

Obtenir ajuda

  • Consulteu les incidències de GitHub per al vostre reproductor específic
  • Incloeu els registres quan informeu de problemes: journalctl --user -u xiboplayer-electron.service --no-pager -n 100
  • Per a Electron, incloeu la sortida de la consola del navegador (activeu-la amb el flag --dev)