ui_keystroke
Schermo, finestre e interfaccia · macOS · Windows
Effetto: esecuzione. Stato: disponibilità condizionata.
«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.
macOS
Scopo
Invia una combinazione di tasti, per esempio "cmd+shift+5", "return", "cmd+,", "escape". Modificatori: cmd, shift, alt/option, ctrl, fn. L’ultimo token è il tasto. Restituisce {sent, delivery:"posted_not_confirmed"}: `sent` significa che gli eventi di tastiera sono stati PUBBLICATI, NON che l’app abbia agito di conseguenza; CGEvent non fornisce alcuna conferma della consegna e l’effetto di una pressione di tasto è arbitrario, quindi non è possibile rileggere nulla che lo dimostri. Conferma l’effetto con ui_get_element / ui_read_tree invece di fidarti di `sent`. I modificatori vengono rilasciati dopo la combinazione, così un successivo ui_type non viene assorbito. unknown_key indica che il tasto non è riconosciuto. Richiede l’autorizzazione Accessibilità.
Input obbligatori
keys
I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.
Autorizzazioni e conferma
Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.
- Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.
Schema tecnico canonico in inglese — macOS
{
"properties": {
"keys": {
"description": "e.g. cmd+shift+5, return, cmd+,",
"type": "string"
}
},
"required": [
"keys"
],
"type": "object"
}Esempio documentale
Esempio di documentazione per ui_keystroke. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.
{
"keys": "escape"
}Windows
Scopo
Esegue interfaccia utente e restituisce un risultato strutturato per l’uso nelle chiamate successive. Parametri, valori e forme tecniche da mantenere invariati: unknown_key, escape, "return", "ctrl+shift+n".
Input obbligatori
keys
I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.
Autorizzazioni e conferma
Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.
- Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del sistema operativo.
Schema tecnico canonico in inglese — Windows
{
"properties": {
"keys": {
"description": "e.g. ctrl+s, return, ctrl+shift+n",
"type": "string"
}
},
"required": [
"keys"
],
"type": "object"
}Esempio documentale
Esempio di documentazione per ui_keystroke. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.
{
"keys": "escape"
}