🔧 Problemi e domande frequenti

Controlla questi punti:

1. Permessi microfono: apri le Impostazioni di Windows → Privacy → Microfono e assicurati che le app desktop possano accedere al microfono.
2. Dispositivo corretto: in Windows, fai clic destro sull'icona del volume nella barra delle applicazioni → Impostazioni audio → assicurati che il microfono giusto sia selezionato come dispositivo di input.
3. Volume del microfono: nello stesso pannello, verifica che il volume del microfono non sia a zero o molto basso.
4. Prova con un'altra app: prova a registrare la tua voce con il Registratore vocale di Windows per verificare che il microfono funzioni in generale.

Possibili cause:

• OCR e Immagini disattivati: verifica nelle impostazioni (scheda Riconoscimento) che OCR e/o Immagini siano attivi.
• Parola poco chiara: prova a pronunciare più chiaramente, o usa una parola diversa.
• Elemento troppo piccolo: testo molto piccolo potrebbe non essere rilevato dall'OCR. Prova a ingrandire la finestra.
• Monitor sbagliato: se hai più monitor, controlla che sia selezionato quello giusto nelle impostazioni (scheda Generale → Monitor).
• Parola in altra lingua: per gli oggetti (non testo), Seaclic traduce automaticamente dall'italiano all'inglese. Prova termini semplici.

Il tasto scorciatoia richiede permessi speciali per funzionare a livello di sistema.

• Esegui come amministratore: prova a eseguire Seaclic con il tasto destro → "Esegui come amministratore".
• Conflitti con altri programmi: un altro programma potrebbe usare lo stesso tasto. Prova con un tasto diverso (es. F8 invece di F5).
• Tasto non supportato: alcuni tasti speciali (come i tasti multimediali) potrebbero non funzionare. Usa tasti standard (F1–F12, ecc.).

1. Gamepad attivato? Verifica che "🎮 Gamepad virtuale" sia attivo nelle impostazioni (scheda Generale).
2. Driver ViGEmBus: il driver ViGEmBus deve essere installato. Se non lo è, scaricalo da github.com/nefarius/ViGEmBus e installalo manualmente.
3. Riavvia il gioco: alcuni giochi rilevano i controller solo all'avvio. Avvia Seaclic e attiva il gamepad prima di avviare il gioco.
4. Verifica in Windows: apri "Pannello di controllo" → "Dispositivi e stampanti" → dovresti vedere un "Xbox 360 Controller for Windows" virtuale.

Se un gioco si comporta in modo strano perché rileva il gamepad virtuale di Seaclic (ad esempio, cambia automaticamente i prompt da tastiera a controller):

• Disattiva "🎮 Gamepad virtuale" nelle impostazioni generali.
• Il gamepad verrà disconnesso immediatamente.
• Puoi riattivarlo quando ti serve, senza riavviare Seaclic.

• Webcam già in uso: chiudi altri programmi che usano la webcam (Zoom, Teams, Skype, ecc.).
• Indice webcam errato: se hai più di una webcam, prova a cambiare il numero nelle impostazioni Tracking (0, 1, 2...).
• Driver webcam: verifica che la webcam funzioni con altre app (es. l'app Fotocamera di Windows).

1. Calibra: esegui la calibrazione guidata dalle impostazioni Tracking.
2. Illuminazione: assicurati che il tuo viso sia ben illuminato, senza controluce.
3. Regola i parametri:
   • Se il tracking è troppo sensibile → abbassa la sensibilità e aumenta la dead zone.
   • Se il tracking è poco reattivo → alza la sensibilità e riduci lo smoothing.
   • Se il tracking "trema" → aumenta lo smoothing (5–7).
4. Ricentra: se il punto neutro si è spostato, usa la ricentratura (comando vocale o hotkey).

Al primo avvio, Seaclic scarica i modelli di intelligenza artificiale (circa 900 MB). È normale che ci vogliano alcuni minuti, a seconda della velocità della connessione Internet. I modelli vengono salvati in cache e non verranno più scaricati.

• Antivirus: alcuni antivirus bloccano programmi che usano hook di tastiera o simulazione input. Prova ad aggiungere Seaclic alle eccezioni.
• File corrotto: prova a reinstallare Seaclic.
• Permessi: prova a eseguire come amministratore.

• Stessa rete: il Broadlink e il computer devono essere sulla stessa rete Wi-Fi.
• IP corretto: verifica l'indirizzo IP del Broadlink nell'app e-Control o Broadlink sul telefono, e inseriscilo nelle impostazioni di Seaclic (scheda Broadlink).
• Firewall: il firewall di Windows potrebbe bloccare la comunicazione. Prova a creare un'eccezione per Seaclic.
• Broadlink abilitato: verifica che il toggle "Abilita Broadlink" sia attivo nella scheda Broadlink delle impostazioni.
• Timeout: se la rete è lenta, prova ad aumentare il timeout di connessione.

• Dispositivo selezionato: verifica nelle impostazioni (scheda Gaze) che sia selezionato il dispositivo corretto. Usa il pulsante "Scan" per cercare i dispositivi.
• Calibrazione: se usi la webcam, esegui la calibrazione a 9 punti. Senza calibrazione la precisione sarà molto bassa.
• Webcam condivisa: se usi la stessa webcam per tracking e gaze, le due modalità condividono le risorse automaticamente. Verifica che il tracking funzioni correttamente.
• Tobii non rilevato: per il Tobii ET5, verifica che il software Tobii Experience sia installato e che il dispositivo sia collegato.
• Illuminazione: come per il tracking, il viso deve essere ben illuminato.

• Gaze attivo: i bottoni si attivano solo quando la modalità Gaze è in esecuzione.
• Dwell time: se il tempo di attivazione è troppo breve, potresti attivare i bottoni involontariamente. Se è troppo lungo, potrebbe sembrare che non funzionino. Regola il dwell time nelle impostazioni Gaze.
• Bottone abilitato: verifica che il toggle "Abilitato" sia attivo sulla card del bottone nelle impostazioni.
• Calibrazione: se lo sguardo non punta nella posizione giusta, i bottoni non verranno attivati. Ricalibra.

1. Credenziali: verifica che endpoint e API key siano inseriti correttamente nelle impostazioni (scheda Riconoscimento).
2. Testa connessione: usa il pulsante "Testa connessione" per verificare che le credenziali funzionino.
3. Connessione Internet: il backend Azure richiede una connessione a Internet attiva.
4. Quota esaurita: se hai superato la quota del tuo endpoint Azure, le richieste falliranno. Controlla il portale Azure.
5. Backend selezionato: verifica che "Azure Vision" sia selezionato come backend Trova (non "Locale").

In parte. Il motore vocale CapisciAMe e Google richiedono entrambi una connessione Internet per il riconoscimento vocale. Tuttavia, il tracking facciale e il controllo gamepad funzionano completamente offline.

Nota: i modelli di intelligenza artificiale (OCR e Object Detection) vengono scaricati solo al primo avvio. Una volta in cache, funzionano senza Internet.

Seaclic è progettato per l'italiano. Il riconoscimento vocale è configurato per la lingua italiana. L'interfaccia e i comandi sono in italiano. L'OCR può leggere testo in qualunque lingua, ma il riconoscimento vocale e la traduzione per la ricerca oggetti funzionano solo dall'italiano.

Una scheda video NVIDIA con supporto CUDA è raccomandata per velocizzare l'OCR e l'Object Detection (modalità Trova). Senza GPU, queste funzioni usano la CPU e sono più lente.

Le modalità Mouse, Comandi e Tracking funzionano perfettamente anche senza GPU dedicata.

Sì! Seaclic è progettato per funzionare in background. Il tasto scorciatoia funziona anche quando un altro programma è in primo piano. Il gamepad virtuale viene riconosciuto come un controller fisico da qualunque gioco.

Non c'è un limite tecnico al numero di comandi. Tuttavia, più comandi hai con parole simili, più possibilità ci sono che Seaclic confonda un comando con un altro. Come regola pratica, cerca di usare parole brevi e distinte tra loro.

L'audio viene inviato al motore di riconoscimento scelto (CapisciAMe o Google) per essere convertito in testo. Seaclic non registra né salva l'audio sul computer. Le impostazioni e i profili sono salvati localmente nel tuo PC e non vengono condivisi.

Sì! Puoi configurare le direzioni del tracking per premere tasti della tastiera (es. W/A/S/D) o per muovere il puntatore del mouse invece di usare il gamepad. In questo caso non hai bisogno di attivare il gamepad virtuale.

Il Tracking segue i movimenti della testa (girarla, inclinarla) e li converte in input. Il Gaze segue il punto che stai guardando con gli occhi e sposta il cursore o attiva bottoni a schermo. Sono due modalità indipendenti che possono coesistere sulla stessa webcam.

Sì! Quando entrambe le modalità usano la stessa webcam, Seaclic condivide automaticamente le risorse (camera e modello face detection). Il face tracking pubblica i dati di rilevamento e il gaze provider li legge passivamente, senza conflitti.

No. La modalità Gaze funziona anche con una semplice webcam, grazie al tracciamento iris di MediaPipe. L'eye tracker Tobii ET5 è supportato per una maggiore precisione, ma non è obbligatorio.

Usa la funzione Esporta profilo nella scheda Comandi delle impostazioni. Il profilo viene salvato come file JSON che puoi inviare per email, chiavetta USB, ecc. L'altra persona può usare Importa profilo per caricarlo nel suo Seaclic.

Le impostazioni generali (schede Generale, Riconoscimento, Ascolto, Mouse, Tracking) non vengono esportate con il profilo comandi — vanno configurate manualmente.