screenshot_capture

macOS

Objectif

Capture une seule image d’un affichage, d’une fenêtre ou d’une région au format PNG. Renvoie {path,resolution(PIXELS),scale_factor,display_id} — scale_factor est l'échelle de support de l'affichage qui a été RÉELLEMENT capturée (la même valeur que list_displays rapporte pour ce display_id, par construction : les deux lisent une fonction), donc pixels = points x scale_factor lors de la conversion d'une coordonnée de l'image en ui_click. Si l'affichage n'a pas pu être déterminé, vous obtenez scale_factor_unknown au lieu d'une supposition ; la résolution est toujours là, vous pouvez donc dériver le rapport vous-même. Nécessite une autorisation d'enregistrement d'écran ; sans cela, il renvoie un permission_required explicite, jamais une image vierge.

Entrées requises

• target

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma ne déclare aucun paramètre de confirmation explicite. Cela n’autorise aucune action sans permission : vérifiez l’effet et obtenez une autorisation.

• Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

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

Exemple documentaire

Exemple de documentation pour screenshot_capture. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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