window_focus

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

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

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

macOS

Назначение

Выводит окно (по window_id из list_windows) на передний план и активирует его приложение. Возвращает window_not_found, если окно не удается определить. Требуется разрешение Accessibility.

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

window_id

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

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

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

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

Каноническая техническая схема на английском — macOS

{
  "properties": {
    "window_id": {
      "type": "string"
    }
  },
  "required": [
    "window_id"
  ],
  "type": "object"
}

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

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

{
  "window_id": "101"
}

Windows

Назначение

Выводит окно на передний план и передает ему фокус. Передайте window_id (значение HWND из list_windows). Только для Windows.

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

window_id

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

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

Каноническая техническая схема на английском — Windows

{
  "properties": {
    "window_id": {
      "description": "The window id (HWND as a decimal string) from list_windows.",
      "type": "string"
    }
  },
  "required": [
    "window_id"
  ],
  "type": "object"
}

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

{
  "window_id": "101"
}