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

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