screenshot_capture

macOS

Doel

Legt één frame van een beeldscherm, venster of gebied vast als PNG. Retourneert {path, resolution (PIXELS), scale_factor, display_id} — scale_factor is de backingschaal van het beeldscherm dat DAADWERKELIJK is vastgelegd (door constructie dezelfde waarde die list_displays voor die display_id rapporteert: beide lezen één functie), dus pixels = points x scale_factor bij het omzetten van een coördinaat uit de afbeelding voor ui_click. Als het beeldscherm niet kon worden vastgesteld, krijg je scale_factor_unknown in plaats van een gok; resolution is altijd aanwezig, zodat je de verhouding zelf kunt afleiden. Vereist de machtiging Schermopname; zonder die machtiging retourneert dit expliciet permission_required, nooit een lege afbeelding.

Vereiste invoer

• target

De namen blijven exact zoals het hulpmiddel ze vereist. De canonieke technische definities in het Engels staan in het uitklapbare schema hieronder.

Machtigingen en bevestiging

Het schema bevat geen expliciete bevestigingsparameter. Dit geeft geen toestemming om te handelen; controleer het effect en vraag autorisatie.

• Gebruik uitsluitend de apps, accounts en bronnen waarvoor de gebruiker op dit platform toestemming heeft gegeven. Raadpleeg de platformspecifieke beschrijving van deze tool voor de verbindings- en toestemmingsvereisten; deze catalogus veronderstelt geen aanvullende OAuth-bereiken of OS-rechten.

{
  "properties": {
    "output_path": {
      "description": "Where to write the PNG (default: temp file). Missing parent folders are created.",
      "type": "string"
    },
    "target": {
      "description": "What to capture. Required: {kind: \"display\"|\"window\"|\"window_title\"|\"region\"} plus display_id (see list_displays), window_id (see list_windows), title, or region {x,y,w,h} in global points.",
      "properties": {
        "display_id": {
          "type": "string"
        },
        "kind": {
          "enum": [
            "display",
            "window",
            "window_title",
            "region"
          ],
          "type": "string"
        },
        "region": {
          "description": "{x,y,w,h} global points.",
          "type": "object"
        },
        "title": {
          "description": "Exact window title to capture (kind:\"window_title\"). Enumerates ALL windows directly — including overlays/panels like Notification Center that list_windows hides unless include_overlays:true. If more than one window has this title, the frontmost one is captured and the response reports matched_windows > 1.",
          "type": "string"
        },
        "window_id": {
          "type": "string"
        }
      },
      "required": [
        "kind"
      ],
      "type": "object"
    }
  },
  "required": [
    "target"
  ],
  "type": "object"
}

Documentatievoorbeeld

Documentatievoorbeeld voor screenshot_capture. Voer dit voorbeeld niet uit. De getoonde argumenten verwijzen naar fictieve gegevens; zoek vóór een echte aanroep de werkelijke identificatoren op en vraag toestemming.

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