Comandi vocali e Gamepad

📖 Cos'è un comando vocale?

Un comando vocale è un'associazione tra una parola (o frase) che pronunci e un'azione che Seaclic esegue. Ad esempio:

Dici "fuoco" → Seaclic preme il tasto Spazio.
Dici "salva" → Seaclic preme Ctrl+S.
Dici "salta" → Seaclic preme il pulsante A del controller.
Dici "accendi TV" → Seaclic invia il segnale IR per accendere la televisione.

I comandi sono organizzati in profili: puoi avere un profilo per i videogiochi, uno per il lavoro, uno per la domotica, ecc.

📁 I profili

Un profilo è una raccolta di comandi vocali. Puoi avere tutti i profili che vuoi e passare dall'uno all'altro facilmente.

Gestire i profili

Apri le Impostazioni → scheda Comandi. In cima troverai il selettore del profilo con questi pulsanti:

Pulsante	Cosa fa
Nuovo	Crea un nuovo profilo vuoto (con comandi start/stop predefiniti).
Rinomina	Cambia il nome del profilo selezionato.
Duplica	Crea una copia identica del profilo attuale (utile per modificarlo senza perdere l'originale).
Elimina	Elimina il profilo selezionato (deve restarne almeno uno).
Esporta	Salva il profilo come file JSON che puoi condividere con altri.
Importa	Carica un profilo da un file JSON (ricevuto da qualcuno o scaricato).

✅ Condivisione profili Puoi esportare un profilo e inviarlo a un amico o a un collega. Loro possono importarlo e avranno esattamente gli stessi comandi configurati. Comodo per configurare più PC allo stesso modo!

➕ Creare un nuovo comando

Apri Impostazioni → Comandi

Clicca sul pulsante ⚙ Impostazioni nella finestra principale, poi vai alla scheda Comandi.

Clicca "＋ Aggiungi comando"

In fondo alla lista dei comandi, clicca il pulsante per aggiungere un nuovo comando.

Scrivi la parola trigger

Nel campo di testo a sinistra, scrivi la parola o frase che dovrai pronunciare per attivare il comando. Ad esempio: "fuoco", "salta", "apri menu".

Scegli il tipo di azione

Dal menu a tendina, scegli cosa deve succedere quando pronunci la parola: Tastiera, Pulsante mouse, Gamepad, Azione Seaclic o Comando IR.

Configura i dettagli

In base al tipo scelto, compila i campi specifici (vedi le sezioni sotto per ogni tipo).

Salva

Clicca OK nella finestra delle impostazioni. Il comando è pronto per l'uso!

⚡ Tipi di azione

⌨️ Tastiera

Simula la pressione di un tasto o una combinazione di tasti. Dopo aver scelto "Tastiera", clicca nel campo dei tasti e premi la combinazione desiderata (ad esempio Ctrl+C per copiare). Seaclic registra automaticamente la combinazione premuta.

💡 Opzioni avanzate Cliccando su "▶ Opzioni avanzate" puoi configurare:

Tipo pressione: completa (premi e rilascia), solo "premi" (down) o solo "rilascia" (up).
Durata: quanti millisecondi tenere premuto il tasto (0 = istantaneo).
Ripetizioni: quante volte ripetere la pressione.
Intervallo: pausa tra le ripetizioni (in millisecondi).
Codice VK: codice Virtual-Key grezzo (Win32). Utile per tasti speciali come F13–F24 o per compatibilità con software come The Grid.

🖱️ Pulsante mouse

Simula un click del mouse: scegli se sinistro, destro o centrale. Utile per creare scorciatoie come "click" → click sinistro o "menu" → click destro.

🎮 Gamepad

Simula l'input di un controller XBox 360 virtuale. Questa funzione è pensata per i videogiochi: il gioco "vede" un controller collegato e risponde come se tu stessi premendo i pulsanti fisicamente.

⚠️ Prerequisito: ViGEmBus Per usare il gamepad virtuale, il driver ViGEmBus deve essere installato nel computer. Normalmente viene installato automaticamente con Seaclic. Se non funziona, vedi la pagina Problemi.

Il gamepad offre tre sotto-tipi di input:

🔘 Pulsante

Premi un pulsante del controller: A, B, X, Y, i 4 tasti del D-Pad (croce direzionale), LB, RB, LS, RS, Start, Back, Guide. Totale: 15 pulsanti.

🎚️ Trigger

I grilletti LT e RT. Puoi specificare quanto premere il trigger in percentuale (0% = rilasciato, 100% = premuto al massimo).

🕹️ Joystick

Gli stick analogici (sinistro o destro). Specifichi la posizione X e Y in percentuale (-100% = tutto a sinistra/su, 0% = centro, +100% = tutto a destra/giù).

💡 Abilita il gamepad Ricordati di attivare l'opzione "🎮 Gamepad virtuale" nelle impostazioni generali. Se il gioco non supporta controller o va in conflitto, puoi disattivarlo.

🔄 Azione Seaclic

Comandi interni per controllare Seaclic stesso con la voce:

Azione	Descrizione
Avvia ascolto	Come premere START (utile per l'attivazione vocale).
Ferma ascolto	Come premere STOP.
Attiva/Disattiva Trova	Accende o spegne la modalità Trova.
Attiva/Disattiva Mouse	Accende o spegne la modalità Mouse.
Attiva/Disattiva Comandi	Accende o spegne la modalità Comandi.
Attiva/Disattiva Tracking	Accende o spegne il face tracking.
Ricentra tracking	Riporta il punto neutro del tracking alla posizione attuale della testa.
Attiva/Disattiva Gaze	Accende o spegne il tracciamento oculare (eye tracking).
Esci	Chiude completamente Seaclic.

📡 Comando IR (Broadlink)

Se possiedi un Broadlink RM4 Mini (un piccolo dispositivo a infrarossi per la domotica), puoi associare comandi vocali al controllo di TV, condizionatori, decoder e altri dispositivi IR.

Collega il Broadlink

Configura l'indirizzo IP del tuo RM4 Mini nelle impostazioni (scheda Generale). Il dispositivo deve essere sulla stessa rete Wi-Fi del computer.

Crea un comando IR

Aggiungi un nuovo comando, scegli tipo Comando IR. Clicca il pulsante 📡 Apprendi.

Punta il telecomando e premi un tasto

Hai 15 secondi per puntare il telecomando originale verso il Broadlink e premere il tasto che vuoi "registrare" (ad esempio il tasto accensione della TV).

Testa e salva

Usa il pulsante ▶ Testa per verificare che funzioni, poi salva. D'ora in poi potrai dire la parola vocale per inviare quel segnale IR.

💡 Ripetizioni Puoi impostare il numero di ripetizioni dell'invio IR (utile per alcuni dispositivi che richiedono segnali ripetuti, come i comandi di accensione/spegnimento).

🎚️ Sensibilità del riconoscimento

In fondo alla scheda Comandi c'è uno slider di sensibilità (soglia di corrispondenza). Controlla quanto deve essere precisa la corrispondenza tra ciò che dici e la parola del comando:

Valore basso (es. 40%): Seaclic è più "tollerante" e accetta pronunce meno precise. Utile se la tua pronuncia non è perfetta.
Valore alto (es. 90%): Seaclic richiede una corrispondenza quasi esatta. Utile se hai molti comandi con parole simili.

Il valore predefinito (60%) è un buon compromesso. Regolalo in base alla tua esperienza.

💡 Consigli pratici

Usa parole brevi e distinte: "fuoco" e "salto" funzionano meglio di "premi il pulsante di attacco".
Evita parole troppo simili: se hai "su" e "giù", vanno bene. Ma "fuga" e "furia" potrebbero confondersi.
Crea un comando "start": così puoi avviare l'ascolto con la voce senza toccare nulla.
Duplica il profilo prima di modificarlo: se vuoi sperimentare, tieni una copia di sicurezza.
Disabilita il gamepad se non serve: evita conflitti con i giochi che usano solo tastiera.