screenshot_capture

macOS

Назначение

Захватывает один кадр дисплея, окна или области в PNG. Возвращает {path, resolution (PIXELS), scale_factor, display_id} — scale_factor представляет масштаб подложки ФАКТИЧЕСКИ захваченного дисплея (то же значение, которое list_displays сообщает для этого display_id, поскольку оба используют одну функцию), поэтому при преобразовании координаты изображения для ui_click pixels = points x scale_factor. Если определить дисплей не удалось, вместо предположения возвращается scale_factor_unknown; разрешение доступно всегда, поэтому соотношение можно вычислить самостоятельно. Требуется разрешение на запись экрана; без него возвращается явная ошибка permission_required, а не пустое изображение.

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

• target

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

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

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

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

{
  "properties": {
    "output_path": {
      "description": "Where to write the PNG (default: temp file). Missing parent folders are created.",
      "type": "string"
    },
    "target": {
      "properties": {
        "display_id": {
          "type": "string"
        },
        "kind": {
          "enum": [
            "display",
            "window",
            "region"
          ],
          "type": "string"
        },
        "region": {
          "description": "{x,y,w,h} global points.",
          "type": "object"
        },
        "window_id": {
          "type": "string"
        }
      },
      "required": [
        "kind"
      ],
      "type": "object"
    }
  },
  "required": [
    "target"
  ],
  "type": "object"
}

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

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

{
  "target": {
    "display_id": "1",
    "kind": "display"
  }
}