list_windows
Ecrã, janelas e interface · macOS · Windows
Efeito: leitura. Estado: disponibilidade condicionada.
«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.
macOS
Finalidade
Lista janelas na tela de qualquer aplicativo com window_id, possuindo ID + nome do pacote de aplicativos, título, limites (espaço global, canto superior esquerdo, pontos), display_id (o CGDirectDisplayID - corresponde a list_displays, para que você possa procurar em qual exibição uma janela está ativada) e is_focused. A janela TITLES requer permissão de gravação de tela - sem ela, isso retorna um erro permission_required explícito em vez de um resultado sem título. Filtro app_bundle_id opcional – note em que os aplicativos estilo Electron geralmente possuem suas janelas a partir de um processo HELPER com um ID de pacote diferente, para que um filtro possa voltar vazio enquanto o aplicativo está claramente na tela. on_screen_only DEFAULTS TO TRUE e exclui janelas minimizadas, ocultas e outros espaços; passe falso para vê-los. Quando o resultado está vazio, esta ferramenta retorna um `note` explicando qual filtro o esvaziou e o que passar - leia-o em vez de concluir que o aplicativo não tem janelas. window_id é estável na sessão para direcionamento posterior.
Entradas obrigatórias
O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.
Permissões e confirmação
O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
Esquema técnico canónico em inglês — 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"
}Exemplo documental
Exemplo de documentação para list_windows. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.
{}Windows
Finalidade
Lista as janelas abertas nesta máquina: ID da janela, aplicativo proprietário (nome do exe), pid, título, limites {x,y,w,h} e ID de exibição. Somente Windows (usa janelas Win32 API). Filtre por aplicativo com app_bundle_id (uma correspondência de substring de nome de exe no Windows).
Entradas obrigatórias
O esquema desta plataforma não declara entradas obrigatórias. Ainda podem existir seletores opcionais ou requisitos de execução.
Permissões e confirmação
O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.
- Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.
Esquema técnico canónico em inglês — 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"
}Exemplo documental
Exemplo de documentação para list_windows. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.
{}