list_windows
Écran, fenêtres et interface · macOS · Windows
Effet: lecture. État: disponibilité conditionnelle.
«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.
macOS
Objectif
Répertorie les fenêtres à l'écran de toute application avec window_id, possédant l'identifiant de l'ensemble d'applications + le nom, le titre, les limites (espace global, en haut à gauche, points), display_id (le CGDirectDisplayID — correspond à list_displays, afin que vous puissiez rechercher sur quel écran se trouve une fenêtre) et is_focused. La fenêtre TITLES nécessite une autorisation d'enregistrement d'écran - sans elle, cela renvoie une erreur permission_required explicite plutôt qu'un résultat sans titre. Filtre app_bundle_id en option — note que les applications de style Electron possèdent souvent leurs fenêtres à partir d'un processus HELPER avec un identifiant de bundle différent, de sorte qu'un filtre peut revenir vide pendant que l'application est clairement à l'écran. on_screen_only DEFAULTS À TRUE et exclut les fenêtres réduites, masquées et autres espaces ; passez false pour les voir. Lorsque le résultat est vide, cet outil renvoie un « note » expliquant quel filtre l'a vidé et quoi transmettre à la place – lisez-le au lieu de conclure que l'application n'a pas de fenêtre. window_id est stable au sein de la session pour un ciblage ultérieur.
Entrées requises
Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.
Autorisations et confirmation
Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.
- Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.
Schéma technique canonique en anglais — 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"
}Exemple documentaire
Exemple de documentation pour list_windows. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.
{}Windows
Objectif
Répertorie les fenêtres ouvertes sur cette machine : identifiant de fenêtre, application propriétaire (nom de l'exe), pid, titre, limites {x, y, w, h} et identifiant d'affichage. Windows uniquement (utilise le fenêtrage Win32 API). Filtrer par application avec app_bundle_id (une correspondance de sous-chaîne de nom d'exe sous Windows).
Entrées requises
Le schéma de cette plateforme ne déclare aucune entrée requise. Des sélecteurs facultatifs ou des conditions d’exécution peuvent néanmoins exister.
Autorisations et confirmation
Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.
- Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.
Schéma technique canonique en anglais — 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"
}Exemple documentaire
Exemple de documentation pour list_windows. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.
{}