Tipi di azione — Seaclic

💡 Dove si usa un'azione? I tipi di azione descritti qui si usano in Comandi (associati a parole), in Input (associati a tasti/pulsanti fisici), negli Eye Button (associati allo sguardo), e nelle direzioni di Tracking e Gaze.

⌨️ Tastiera

Simula la pressione di un tasto — singolo (es. Spazio) o in combinazione (es. Ctrl+S). Funziona con qualunque applicazione aperta, così come farebbe una tastiera fisica.

Parametro	Valori	Note
Tasto	Qualunque tasto + modificatori (Ctrl, Alt, Shift, Win)	Puoi usare anche combinazioni come Ctrl+Alt+Canc
Tipo pressione	Press (↓↑), Down (↓), Up (↑)	Press = premi e rilascia; Down = tieni premuto; Up = rilascia
Durata	0–5000 ms	Quanto tempo tenere premuto prima di rilasciare (con Press)
Ripetizioni	1–20	Quante volte ripetere l'azione
Codice VK raw	Intero (es. 124 = F13)	Per tasti non standard: F13–F24, tasti grid AAC (The Grid), numpad speciali

Esempi pratici

🎮

Salto (gioco)

Dici "salta" → press Spazio, durata 0, ripetizioni 1.

💾

Salva file

Dici "salva" → press Ctrl+S.

🔤

The Grid (AAC)

Trigger griglia → VK raw 124 (F13), usato dai software di comunicazione aumentativa.

🖱️ Mouse

Simula la pressione di un pulsante del mouse nella posizione corrente del cursore. Supporta click singolo, doppio, trascinamento e molto altro.

Parametro	Valori	Note
Pulsante	Sinistro, Destro, Centrale	—
Tipo pressione	Press (↓↑), Down (↓), Up (↑)	Stesso significato della tastiera
Durata	0–5000 ms	—
Ripetizioni	1–20	Ripetizioni click (es. doppio click = 2 ripetizioni con press)

✅ Combinazioni utili Usa Down per iniziare un trascinamento e Up su un altro comando per terminarlo. Oppure usa 2 ripetizioni di Press per un doppio click.

🎮 Gamepad

Simula input di un controller virtuale XBox 360 tramite ViGEmBus. Il driver deve essere installato (il programma di Setup lo offre automaticamente). C'è poi da abilitare il gamepad nella scheda Gamepad delle impostazioni.

Sono disponibili tre sotto-tipi di input gamepad:

Pulsanti digitali

Simula la pressione di uno dei 15 pulsanti del controller.

Pulsante	Descrizione
A	Pulsante inferiore (verde su XBox)
B	Pulsante destro (rosso)
X	Pulsante sinistro (blu)
Y	Pulsante superiore (giallo)
LB / RB	Bumper sinistro / destro
LS / RS	Click analogico left stick / right stick
Start / Back	Pausa / Select
Guide	Pulsante centrale XBox
DPAD_UP / DOWN / LEFT / RIGHT	D-Pad direzionale digitale

💡 Tipo pressione e ripetizioni Stesso schema della tastiera: Press (↓↑), Down (↓), Up (↑). Durata 0–5000 ms, ripetizioni 1–20.

Trigger analogici (LT / RT)

Simula la pressione analogica del grilletto sinistro (LT) o destro (RT). Il valore è una percentuale da 0 % (rilasciato) a 100 % (premuto a fondo).

Parametro	Valori	Esempio
Trigger	LT oppure RT	LT = freno; RT = acceleratore in un gioco di guida
Valore	0 – 100 %	100 = premuto a fondo; 0 = rilasciato
Tipo	Press (↓↑), Down (↓), Up (↑)	Down imposta il valore e lo mantiene; Up lo azzera

Joystick analogico (LS / RS)

Imposta la posizione di uno degli stick analogici del controller. Gli assi vanno da −100 (sinistra/su) a +100 (destra/giù).

Parametro	Valori	Note
Stick	LS (Left Stick) o RS (Right Stick)	—
Asse X	−100 (sinistra) … 0 (centro) … +100 (destra)	—
Asse Y	−100 (su) … 0 (centro) … +100 (giù)	Convenzione XInput: positivo = giù
Tipo	Press (↓↑), Down (↓), Up (↑)	Up riporta lo stick a 0,0

✅ Voice Joystick Overlay Quando Tracking o Gaze usano lo stesso joystick, i loro contributi vengono sommati frame per frame (~30 Hz). I comandi vocali non sovrascrivono il tracking: entrambi contribuiscono contemporaneamente allo stesso asse.

🔧 Azioni interne Seaclic

Controlla il programma stesso: avvia/arresta le modalità, ricalibra il tracking, esce dall'applicazione.

Azione	Descrizione
start	Avvia Seaclic (equivale a premere START)
stop	Ferma Seaclic (equivale a premere STOP)
toggle_trova	Attiva/disattiva la modalità Trova
toggle_mouse	Attiva/disattiva la modalità Mouse
toggle_comandi	Attiva/disattiva la modalità Comandi
toggle_tracking	Attiva/disattiva il Tracking facciale
toggle_gaze	Attiva/disattiva il Gaze tracking
recenter_tracking	Azzera la posizione neutra del tracking (utile dopo uno spostamento di postura)
quit	Chiude completamente Seaclic

💡 Uso tipico Associa toggle_tracking a un comando vocale come "pausa testa" per sospendere temporaneamente il tracking senza uscire dall'applicazione. Oppure associa recenter_tracking al pulsante dorsale del controller per ricalibrate on-the-fly durante il gioco.

📡 IR — Comandi infrarosso (Broadlink)

Invia segnali infrarossi tramite un dispositivo Broadlink RM4 Mini (o compatibile) collegato alla rete locale. Ideale per controllare TV, condizionatori, proiettori e qualsiasi dispositivo con telecomando IR.

Prerequisiti

Collega il Broadlink

Configura il dispositivo Broadlink sulla tua rete Wi-Fi tramite l'app ufficiale.

Inserisci l'IP nelle impostazioni

Nella scheda Domotica delle impostazioni Seaclic, inserisci l'indirizzo IP del Broadlink.

Acquisisci il segnale IR

Usa l'apposita funzione nell'editor comandi: premi Registra segnale IR, punta il telecomando fisico verso il Broadlink e premi il tasto che vuoi catturare. Seaclic salva il segnale codificato in Base64.

Parametro	Valori	Note
Segnale IR (Base64)	Stringa generata dalla registrazione	Acquisita automaticamente dalla funzione registra
Ripetizioni	1–10	Quante volte inviare il segnale (utile per volume +/−)

✅ Combinazione con Eye Button Crea un Eye Button "Volume Su" con azione IR associata: fissa il bottone a schermo per 0,5 s e il segnale IR viene inviato. Ideale per chi non può interagire con il telecomando fisico.

🔊 TTS — Sintesi vocale

Fa leggere ad alta voce un testo predefinito. Utile per annunci, conferme di azione o comunicazione aumentativa.

Parametro	Valori	Note
Testo	Testo libero	Viene letto alla velocità e voce impostata nelle preferenze TTS
Backend	Sistema (pyttsx3) o ElevenLabs (cloud)	ElevenLabs richiede API key; produce voci molto naturali

💡 Privacy Con il backend di sistema (pyttsx3) il testo non lascia mai il dispositivo. ElevenLabs invia il testo ai server ElevenLabs Inc. Puoi scegliere il backend nella scheda TTS delle impostazioni.

🔍 Trova Macro

Esegue una ricerca visiva programmata con un testo predefinito, esattamente come se l'utente avesse pronunciato quella parola in modalità Trova — ma senza input vocale. Utile per creare sequenze automatizzate o hotkey di ricerca rapida.

Parametro	Valori	Note
Testo da cercare	Qualunque testo	Verrà cercato sullo schermo con il backend Trova attivo (locale, VLM o cloud)

✅ Esempio d'uso Crea un comando "chiudi" → Trova Macro con testo "✕" o "Chiudi". Seaclic troverà automaticamente il pulsante di chiusura della finestra in primo piano e ci cliccherà sopra.

📂 Esegui / Apri file

Apre un file con l'applicazione predefinita oppure esegue un file eseguibile (.exe).

Parametro	Valori	Note
Percorso file	Percorso assoluto o relativo	Es. `C:\Users\Mario\Documenti\documento.pdf`
Argomenti	Stringa opzionale	Solo per eseguibili: parametri da riga di comando

⚠️ Sicurezza Per motivi di sicurezza, sono supportate solo estensioni sicure: documenti, immagini, audio, video, PDF, e file eseguibili (.exe). I file script (.bat, .ps1, .vbs, .cmd) non sono supportati per evitare esecuzioni di codice non controllate.

🏠 Alexa

Invia un comando ad Alexa tramite Home Assistant con l'integrazione Alexa Media Player. Permette di dire "Ehi Alexa" senza usare la voce, attivando invece un comando Seaclic.

Prerequisiti

Home Assistant installato e accessibile in rete locale (IP configurato in impostazioni Seaclic).
Integrazione Alexa Media Player configurata in Home Assistant con account Amazon collegato.
Token di Long-Lived Access Token di Home Assistant inserito nelle impostazioni Seaclic.

Parametro	Valori	Note
Comando	Testo libero	Es. "Accendi la luce del salotto", "Riproduci musica jazz"
Entity ID	Es. `media_player.echo_salotto`	L'echo su cui eseguire il comando (facoltativo: usa il dispositivo di default)

🏡 Google Home

Invia un comando a Google Home tramite Home Assistant con l'integrazione Google Assistant SDK o Google Home community integration.

Prerequisiti

Home Assistant installato con integrazione Google Home o Google Assistant configurata.
Token di Long-Lived Access Token inserito nelle impostazioni Seaclic.

Parametro	Valori	Note
Comando	Testo libero	Es. "OK Google, accendi le luci del bagno"
Entity ID	Es. `media_player.google_home_salotto`	Il dispositivo Google Home su cui eseguire il comando

💡 Stessa configurazione per Alexa e Google Entrambe le integrazioni usano lo stesso server Home Assistant. Configura IP, porta e token una sola volta nella scheda Domotica delle impostazioni.