list_windows
Schermo, finestre e interfaccia · macOS · Windows
Effetto: lettura. Stato: disponibilità condizionata.
«Disponibilità condizionata» indica che lo strumento può dipendere da versione, piattaforma, autorizzazioni, account o configurazione. Non è necessariamente attivo ovunque.
macOS
Scopo
Elenca le finestre sullo schermo di qualsiasi app con window_id, che possiede ID bundle dell'app + nome, titolo, limiti (spazio globale, in alto a sinistra, punti), display_id (CGDirectDisplayID — corrisponde a list_displays, quindi puoi cercare su quale visualizzazione è attiva una finestra) e is_focused. La finestra TITLES richiede l'autorizzazione alla registrazione dello schermo: senza di essa viene restituito un errore permission_required esplicito anziché un risultato senza titolo. Filtro app_bundle_id opzionale: note che le app in stile Electron spesso possiedono le proprie finestre da un processo HELPER con un ID bundle diverso, quindi un filtro può tornare vuoto mentre l'app è chiaramente sullo schermo. on_screen_only DEFAULTS TO TRUE ed esclude finestre minimizzate, nascoste e di altro spazio; passare falso per vederli. Quando il risultato è vuoto, questo strumento restituisce un `note` che spiega quale filtro lo ha svuotato e cosa invece passare: leggilo invece di concludere che l'app non ha finestre. window_id è stabile all'interno della sessione per il targeting successivo.
Input obbligatori
Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.
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": {
"app_bundle_id": {
"description": "Only return windows owned by this app bundle id.",
"type": "string"
},
"on_screen_only": {
"description": "Only on-screen windows (default true).",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Esempio documentale
Esempio di documentazione per list_windows. 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.
{}Windows
Scopo
Elenca le finestre aperte su questo computer: ID finestra, app proprietaria (nome exe), pid, titolo, limiti {x,y,w,h} e ID di visualizzazione. Solo Windows (utilizza la finestra Win32 API). Filtra per app con app_bundle_id (una corrispondenza della sottostringa del nome exe su Windows).
Input obbligatori
Lo schema di questa piattaforma non dichiara input obbligatori. Possono comunque esistere selettori facoltativi o requisiti di esecuzione.
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": {
"app_bundle_id": {
"description": "Filter to windows owned by this app. On Windows, a case-insensitive substring of the exe name (e.g. 'chrome').",
"type": "string"
},
"on_screen_only": {
"description": "Only return visible, non-empty-title windows (default true).",
"type": "boolean"
}
},
"required": [],
"type": "object"
}Esempio documentale
Esempio di documentazione per list_windows. 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.
{}