list_windows

Экран, окна и интерфейс · macOS · Windows

Эффект: чтение. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Перечисляет видимые на экране окна любого приложения с window_id, идентификатором пакета и именем приложения-владельца, заголовком, границами в глобальном пространстве (начало слева сверху, единицы — точки), display_id (CGDirectDisplayID, совпадающий с list_displays, поэтому можно определить дисплей окна) и is_focused. Для ЗАГОЛОВКОВ окон требуется разрешение на запись экрана; без него возвращается явная ошибка permission_required, а не результат без заголовков. Доступен фильтр app_bundle_id; учтите, что приложения на Electron часто создают окна через ВСПОМОГАТЕЛЬНЫЙ процесс с другим идентификатором пакета, поэтому фильтр может вернуть пусто, хотя приложение видно на экране. on_screen_only ПО УМОЛЧАНИЮ РАВЕН TRUE и исключает свернутые, скрытые окна и окна в других Spaces; передайте false, чтобы увидеть их. При пустом результате инструмент возвращает `note` с объяснением, какой фильтр его опустошил и что передать вместо него; прочитайте это пояснение, прежде чем заключать, что у приложения нет окон. window_id стабилен в течение сеанса для последующего выбора цели.

Обязательные входные данные

Схема этой платформы не объявляет обязательных входных данных. Необязательные селекторы или требования среды всё же могут применяться.

Разрешения и подтверждение

Схема не объявляет явного параметра подтверждения. Это не разрешает действовать без согласия: проверьте эффект и получите разрешение.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
}

Пример для документации

Пример документации для list_windows. Не выполняйте этот пример. Показанные аргументы относятся к вымышленному набору данных; перед реальным вызовом найдите настоящие идентификаторы и получите разрешение.

{}

Windows

Назначение

Перечисляет открытые окна на этом компьютере: идентификатор окна, приложение-владелец (имя exe), pid, заголовок, границы {x,y,w,h} и идентификатор дисплея. Только для Windows, использует Win32 API окон. Фильтруйте по приложению через app_bundle_id — в Windows это поиск подстроки в имени exe.

Обязательные входные данные

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
}

Пример для документации

{}