Guida ai Requisiti Tecnici

1. Introduzione

LiveAvatar è la funzionalità di Skillgym che porta in vita, in tempo reale, l’avatar virtuale con cui gli utenti interagiscono durante le simulazioni di training. Attraverso streaming audio/video sincronizzato, l’avatar reagisce, parla e mantiene un contatto visivo naturale con l’utente, per un’esperienza di apprendimento immersiva e coinvolgente.

Per garantire questa esperienza in tempo reale, LiveAvatar richiede risorse hardware, software e di rete adeguate sulla postazione dell’utente finale. Questo documento è pensato per essere condiviso con il reparto IT del cliente prima del roll-out, così da verificare in anticipo la compatibilità del parco macchine aziendale ed evitare sorprese in fase di utilizzo.

Un’adeguata preparazione dell’ambiente client, in particolare nei contesti aziendali con postazioni gestite centralmente (immagini standard, virtualizzazione, proxy e firewall aziendali), è il fattore più determinante per la qualità dell’esperienza LiveAvatar.

2. Requisiti hardware della postazione client

3. Requisiti software

4. Requisiti di rete

LiveAvatar utilizza connessioni WebRTC in tempo reale: la qualità percepita dipende più dalla stabilità della connessione (jitter, perdita di pacchetti, latenza) che dalla sola banda disponibile. Reti Wi-Fi condivise, hotspot mobili o reti aziendali con instradamento centralizzato del traffico su lunghe distanze sono i contesti in cui è più importante verificare questi parametri.

Oltre al canale audio/video, LiveAvatar mantiene aperta una connessione WebSocket sicura (wss://) per la gestione dei comandi di sessione: anche questo canale deve poter transitare liberamente su proxy e firewall aziendali, con le stesse attenzioni indicate per il traffico UDP (nessuna ispezione SSL, nessun inoltro forzato su instradamenti alternativi).

5. Ambienti aziendali gestiti (Corporate IT, VDI, firewall)

Le organizzazioni di grandi dimensioni adottano spesso postazioni gestite centralmente, con immagini standard, virtualizzazione, proxy e policy di sicurezza dedicate. Questi ambienti offrono grandi vantaggi in termini di sicurezza e governance, ma possono introdurre vincoli che vanno verificati in anticipo per assicurare il pieno funzionamento di LiveAvatar. Si raccomanda di condividere questa sezione con il reparto IT prima del roll-out.

Suggeriamo di includere questi punti nella checklist di provisioning delle postazioni per i team che utilizzeranno Skillgym, così da prevenire in fase di rollout eventuali limitazioni introdotte da configurazioni di sicurezza standard aziendali.

6. Domini e porte da consentire

Domini e porte da consentire per usare Skillgym da una rete aziendale.

Il traffico WSS (WebSocket sicuro) deve poter passare: il proxy deve consentire l’upgrade a WebSocket e non deve chiudere le connessioni lunghe. Se la rete usa l’ispezione TLS, si consiglia di escludere questi domini.

Il video dell’avatar arriva in tempo reale tramite WebRTC dal servizio LiveKit Cloud. Il minimo indispensabile è la porta TCP 443 verso *.livekit.cloud e *.turn.livekit.cloud. Le porte UDP sono consigliate per la qualità del video. Tutto il traffico è cifrato (TLS e DTLS). Requisiti ufficiali: docs.livekit.io — Corporate firewalls.

7. Cosa succede se l’ambiente non soddisfa i requisiti

Skillgym è progettato per garantire in ogni caso la continuità della formazione. Se la postazione o la rete dell’utente non soddisfano i requisiti indicati, il sistema applica automaticamente un meccanismo di salvaguardia dell’esperienza:

• L’avatar viene mostrato tramite un’immagine statica al posto del video in tempo reale, mentre tutte le altre componenti della simulazione (audio, interazione, questionari, debrief finale) restano pienamente funzionanti.
• L’utente viene informato con un messaggio chiaro e con l’indicazione del tempo stimato prima di un nuovo tentativo automatico di attivazione del LiveAvatar.
• Il sistema ritenta automaticamente l’attivazione del LiveAvatar al successivo accesso, senza necessità di intervento manuale da parte dell’utente.

Questo comportamento consente di non interrompere mai il percorso formativo, anche in presenza di condizioni hardware o di rete temporaneamente non ottimali.

8. Checklist di preparazione pre-rollout

Consigliamo al reparto IT del cliente di verificare quanto segue prima dell’avvio del progetto formativo:

• Le postazioni destinate agli utenti rispettano i requisiti hardware minimi indicati alla sezione 2.
• Il browser aziendale standard è tra quelli supportati e mantenuto aggiornato (sezione 3.2).
• La rete aziendale (sede e/o smart working) rispetta i parametri di banda, latenza e stabilità indicati alla sezione 4.
• Per postazioni virtualizzate: è disponibile accelerazione grafica dedicata alla sessione (sezione 5).
• I domini Skillgym sono inclusi nelle whitelist di proxy, firewall e sistemi di filtro web aziendali.
• È stato eseguito un test pilota con un piccolo gruppo di utenti rappresentativi delle diverse configurazioni aziendali (ufficio, smart working, dispositivi virtuali) prima del roll-out su larga scala.