screenshot_capture

macOS

Zweck

Erfasst einen einzelnen Frame einer Anzeige, eines Fensters oder eines Bereichs in einem PNG. Gibt {path, resolution (PIXELS), scale_factor, display_id} zurück – scale_factor ist die Hintergrundskala der Anzeige, die ACTUALLY erfasst wurde (derselbe Wert, den list_displays für diesen display_id meldet, konstruktionsbedingt: beide lesen eine Funktion), also Pixel = Punkte x scale_factor beim Konvertieren einer Koordinate aus dem Bild in ui_click. Wenn die Anzeige nicht ermittelt werden konnte, erhalten Sie scale_factor_unknown anstelle einer Schätzung; Die Auflösung ist immer vorhanden, sodass Sie das Verhältnis selbst ermitteln können. Erfordert die Erlaubnis zur Bildschirmaufzeichnung; Ohne gibt es ein explizites permission_required zurück, niemals ein leeres Bild.

Erforderliche Eingaben

• target

Die Namen bleiben exakt so erhalten, wie das Werkzeug sie verlangt. Die kanonischen technischen Definitionen auf Englisch stehen im ausklappbaren Schema unten.

Berechtigungen und Bestätigung

Das Schema deklariert keinen ausdrücklichen Bestätigungsparameter. Das erlaubt keine Handlung ohne Zustimmung; prüfen Sie die Wirkung und holen Sie eine Autorisierung ein.

• Verwenden Sie auf dieser Plattform nur die vom Benutzer autorisierten Apps, Konten und Ressourcen. Informationen zu den Verbindungs- und Berechtigungsanforderungen finden Sie in der plattformspezifischen Beschreibung dieses Tools. Dieser Katalog beansprucht keine zusätzlichen OAuth-Bereiche oder Betriebssystemberechtigungen.

{
  "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"
}

Dokumentationsbeispiel

Dokumentationsbeispiel für screenshot_capture. Führen Sie dieses Beispiel nicht aus. Die gezeigten Argumente gehören zu einem fiktiven Datensatz; ermitteln Sie reale Kennungen und holen Sie vor einem echten Aufruf die Genehmigung ein.

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