ui_keystroke

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

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

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

macOS

Назначение

Отправляет сочетание клавиш, например "cmd+shift+5", "return", "cmd+,", "escape". Модификаторы: cmd, shift, alt/option, ctrl, fn. Последний токен — клавиша. Возвращает {sent, delivery:"posted_not_confirmed"} — `sent` означает, что события клавиш были ОТПРАВЛЕНЫ, а НЕ то, что приложение их обработало: CGEvent не подтверждает доставку, а произвольный эффект нажатия невозможно считать обратно для доказательства. Подтвердите эффект с помощью ui_get_element / ui_read_tree, а не доверяйте `sent`. После сочетания модификаторы отпускаются, поэтому следующий ui_type не будет поглощен. unknown_key, если клавиша не распознана. Требуется разрешение Accessibility.

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

keys

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

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

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

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

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

{
  "properties": {
    "keys": {
      "description": "e.g. cmd+shift+5, return, cmd+,",
      "type": "string"
    }
  },
  "required": [
    "keys"
  ],
  "type": "object"
}

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

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

{
  "keys": "escape"
}

Windows

Назначение

Отправляет сочетание клавиш в активное приложение, например "ctrl+s", "ctrl+shift+n", "return", "alt+f4", "escape". Модификаторы: ctrl, shift, alt, win (cmd принимается как псевдоним ctrl). Последний токен — клавиша. unknown_key, если клавиша не распознана.

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

keys

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

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

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

{
  "properties": {
    "keys": {
      "description": "e.g. ctrl+s, return, ctrl+shift+n",
      "type": "string"
    }
  },
  "required": [
    "keys"
  ],
  "type": "object"
}

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

{
  "keys": "escape"
}