HandyCafe Docs
it-admin

Desktop Remoto

Il Desktop Remoto permette agli amministratori di visualizzare e controllare i PC client in tempo reale direttamente dall'interfaccia del Server HandyCafe. E progettato per la risoluzione dei problemi, il monitoraggio e l'assistenza ai clienti nel tuo internet cafe o gaming center senza doversi spostare fisicamente alla macchina.

Avvio di una Sessione Desktop Remoto

  1. Nel Pannello Admin, individua il client a cui vuoi connetterti.
  2. Clicca sulla scheda del client per rivelare i pulsanti azione.
  3. Clicca il pulsante Desktop Remoto.

Il visualizzatore desktop remoto si apre in una finestra dedicata, mostrando lo schermo del client con i controlli interattivi.

Tecnologia di Streaming

Codec H.264

Gli schermi dei client vengono codificati utilizzando il codec video H.264, che fornisce alta qualita visiva a bassa larghezza di banda. I frame chiave utilizzano la codifica JPEG come fallback per garantire una visualizzazione iniziale rapida e il recupero dalla perdita di pacchetti.

Trasmissione Frame UDP

I frame codificati vengono trasmessi su UDP per una latenza minima. Ogni frame viene suddiviso in blocchi utilizzando un protocollo strutturato con un header di 30 byte contenente:

Campo Header Scopo
Byte magici Identificazione del protocollo
Versione Versione del protocollo per la compatibilita
Tipo frame Indicatore frame chiave vs. frame delta
ID sessione Identifica la sessione desktop remoto
Numero sequenza Ordina i frame per il riassemblaggio
Timestamp Momento della cattura del frame
Indice blocco Posizione di questo blocco all'interno del frame
Conteggio blocchi Numero totale di blocchi nel frame

Questo approccio a blocchi permette ai frame di grandi dimensioni di attraversare la rete in modo affidabile mantenendo i singoli pacchetti UDP entro limiti MTU sicuri.

Controlli Interattivi

Relay Mouse e Tastiera

Una volta connesso, i movimenti del mouse, i clic e l'input da tastiera dell'operatore del server vengono trasmessi al PC client. Il client esegue questi input come se fossero eseguiti localmente, permettendo il pieno controllo interattivo.

Sincronizzazione Appunti

Gli appunti sono sincronizzati tra server e client durante una sessione desktop remoto attiva. Il testo copiato lato server puo essere incollato sul client e viceversa.

Bitrate e Qualita

Il bitrate dello streaming e configurabile tra 350 kbps e 25.000 kbps. Un meccanismo di regolazione automatica monitora le condizioni di rete e scala il bitrate dinamicamente per mantenere un'esperienza di visualizzazione fluida:

  • Su reti veloci e stabili, il bitrate aumenta per una qualita d'immagine piu nitida.
  • Su reti congestionate o lente, il bitrate diminuisce per prevenire perdita di frame e ritardo.

Gli amministratori possono anche selezionare manualmente preimpostazioni dello streaming che bilanciano qualita, FPS e bitrate per diversi casi d'uso (ad esempio monitoraggio vs. controllo attivo).

Impostazioni Configurabili

Il visualizzatore desktop remoto espone diverse impostazioni:

  • Qualita -- Livello di qualita dell'immagine per i frame codificati.
  • FPS -- Frame al secondo target per lo streaming.
  • Bitrate -- Override manuale del bitrate o modalita automatica.
  • Visibilita cursore -- Se visualizzare la sovrapposizione del cursore remoto.
  • Preimpostazioni streaming -- Configurazioni predefinite per scenari comuni.

Registrazione Sessione

Le sessioni desktop remoto possono essere registrate in file MP4 per una revisione successiva. La registrazione utilizza un sottoprocesso FFmpeg che codifica il flusso di frame in entrata in un file video standard. Le registrazioni vengono salvate nella directory config_dir/recordings/ con nomi file con timestamp.

Tracciamento Perdita Pacchetti

Il visualizzatore mostra una percentuale di tasso di perdita che indica quanti frame o blocchi sono stati persi durante la trasmissione. Tassi di perdita elevati suggeriscono congestione di rete e possono richiedere la riduzione del bitrate o l'indagine dei problemi di rete.