xiboplayerxiboplayer
EN

Configurar la connexio al CMS

Despres d'instal·lar un reproductor, cal connectar-lo al teu Xibo.

Que necessites

  • Una instancia de Xibo en funcionament (v3 o v4)
  • La clau del servidor del CMS (es troba a CMS → Administration → Settings → Display Settings → CMS Secret Key)
  • La URL del CMS (p. ex. https://your-cms.example.com)

Pas 1: Introduir les credencials del CMS

Imatges de quiosc (assistent de primera arrencada)

L'assistent de configuracio apareix automaticament en la primera arrencada. Introdueix:

  1. URL del CMS — l'adreca del teu Xibo
  2. Clau del CMS — la clau del servidor des dels ajustos del CMS
  3. Nom de la pantalla — un nom per identificar aquesta pantalla (p. ex. "Pantalla Vestibul 1")

Reproductor Electron

En el primer inici, el reproductor mostra una pagina de configuracio. Introdueix els mateixos tres camps. Tambe pots configurar-ho per linia de comandes:

xiboplayer-electron --cms-url=https://your-cms.example.com --cms-key=YOUR_KEY --display-name="Lobby"

O edita el fitxer de configuracio a ~/.config/xiboplayer/electron/config.json.

Reproductor Chromium

El reproductor Chromium obre la pagina de configuracio del PWA al navegador. Introdueix la URL del CMS, la clau i el nom de la pantalla directament al formulari.

PWA (navegador)

Navega a https://your-cms.example.com/player/pwa/ i introdueix la clau del CMS i el nom de la pantalla a la pagina de configuracio.

Plantilles de configuracio (instal-lacions RPM/DEB)

Per a desplegaments automatitzats o gestionar multiples pantalles, utilitza plantilles de configuracio en lloc de l'assistent. Les plantilles separen els secrets (credencials CMS) dels perfils de configuracio (quiosc, dev, sync).

Secrets

Crea el fitxer de secrets un cop per CMS. Les plantilles el llegeixen automaticament.

cp /usr/share/xiboplayer-electron/configs/secrets.env.example \
   ~/.config/xiboplayer/secrets.env
nano ~/.config/xiboplayer/secrets.env
secrets.env
CMS_URL=https://el-teu-cms.exemple.com
CMS_KEY=la-teva-clau
API_CLIENT_ID=el-teu-client-oauth
API_CLIENT_SECRET=el-teu-secret-oauth

Perfils

Quiosc

Mode produccio. Pantalla completa, ratoli amagat, sense interficie de debug, nomes errors al registre. Per a pantalles desplegades.

apply.sh electron-kiosk electron
apply.sh chromium-kiosk chromium

Desenvolupament

Mode finestra amb overlays de debug, controls de teclat (T=timeline, D=descargues, S=configuracio), registre detallat. Per a proves i depuracio.

apply.sh electron-dev electron
apply.sh chromium-dev chromium

Sincronitzacio multi-pantalla

Reproduccio sincronitzada entre varies pantalles. Un lider coordina el temps, els seguidors escalen les transicions.

apply.sh electron-sync-lead electron-sync-lead
apply.sh electron-sync-follower electron-sync-follower-1 PORT=8771 DISPLAY_NAME=seguidor-1

Valors personalitzats

Passa variables a la linia de comandes per sobreescriure els valors per defecte:

apply.sh electron-kiosk electron DISPLAY_NAME="Pantalla Vestibul" PORT=8770

Sintaxi de plantilla: {{VAR}} es obligatori, {{VAR:default}} te valor per defecte. Els camps OAuth buits s'eliminen automaticament.

Reiniciar un reproductor

Esborrar cache

Esborra la cache del navegador (cache GPU, codi compilat) pero manté l'autenticacio CMS, fitxers multimedia i service worker.

clean.sh electron cache

Esborrat complet

Elimina totes les dades del reproductor. La pantalla es re-registra amb el CMS com un nou dispositiu.

clean.sh electron full

Pas 2: Autoritzar al CMS

Despres que el reproductor es registri, apareix al teu CMS amb l'estat Esperant autoritzacio.

  1. Obre la interficie d'administracio del CMS
  2. Ves a Displays
  3. Troba la teva nova pantalla (estat: Esperant)
  4. Fes clic a Autoritzar

El reproductor rebra l'autoritzacio en el proper cicle de recollida (normalment en menys de 30 segons).

Pas 3: Assignar contingut

  1. Al CMS, ves a Schedule
  2. Crea o selecciona una Campanya o Layout
  3. Programa-la per a la teva pantalla o grup de pantalles
  4. El reproductor descarrega els fitxers multimedia i comenca la reproduccio automaticament

Ajustos de pantalla

Un cop autoritzat, el CMS envia els ajustos de pantalla al reproductor, incloent:

  • Interval de recollida (cada quant el reproductor comprova si hi ha actualitzacions)
  • Finestra de descàrrega (restringir descàrregues grans a hores de baixa activitat)
  • Interval de captures de pantalla
  • Nivell de registre
  • Canal XMR (per a comandes push en temps real)

Aquests es configuren per pantalla o per grup de pantalles a CMS → Displays → Edit Display → Display Settings.

Verificar la connexio

Des del reproductor

Prem T per mostrar la superposicio de la linia de temps. Si la programacio esta carregada i es llisten els layouts, la connexio funciona.

Prem D per veure el progres de descàrrega dels fitxers multimedia.

Des del CMS

A CMS → Displays, comprova:

  • Estat: hauria de mostrar un tic verd (autoritzat i comunicant-se)
  • Darrer acces: hauria de mostrar una marca de temps recent
  • Emmagatzematge: mostra l'espai de disc restant al reproductor
  • Captura de pantalla: si esta configurat, mostra la darrera captura de pantalla del reproductor