screenshot_capture

macOS

Propósito

Captura un solo fotograma de una pantalla, ventana o región en un PNG. Devuelve `{path, resolution (PIXELS), scale_factor, display_id}`: scale_factor es la escala de respaldo de la pantalla en la que realmente se hizo la captura (el mismo valor que informa list_displays para ese display_id, por construcción: ambos leen una función), por lo que píxeles = puntos x scale_factor al convertir una coordenada de la imagen a ui_click. Si no se pudo determinar la visualización, obtendrá scale_factor_unknown en lugar de una suposición; La resolución siempre está ahí, por lo que usted mismo puede calcular la proporción. Requiere permiso de grabación de pantalla; sin él, devuelve un permission_required explícito, nunca una imagen en blanco.

Entradas obligatorias

• target

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema no declara un parámetro explícito de confirmación. Esto no autoriza a actuar sin permiso: revisa el efecto y obtén autorización antes de una llamada real.

• Utilice únicamente las aplicaciones, cuentas y recursos autorizados por el usuario en esta plataforma. Consulte la descripción específica de la plataforma de esta herramienta para conocer sus requisitos de conexión y permisos. Este catálogo no afirma alcances OAuth adicionales ni derechos de sistema operativo.

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

Ejemplo documental

Ejemplo de documentación para screenshot_capture. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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