screenshot_capture

macOS

Scopo

Acquisisce un singolo fotogramma di uno schermo, una finestra o un’area in un file PNG. Restituisce {path, resolution (PIXELS), scale_factor, display_id}: scale_factor è il fattore di scala effettivo dello schermo che è stato DAVVERO acquisito (lo stesso valore che list_displays restituisce per quel display_id, per costruzione: entrambi leggono una sola funzione), quindi pixels = points x scale_factor quando si converte una coordinata dell’immagine per ui_click. Se non è stato possibile determinare lo schermo, viene restituito scale_factor_unknown invece di un valore ipotizzato; resolution è sempre presente, quindi puoi calcolare autonomamente il rapporto. Richiede l’autorizzazione Registrazione schermo; in sua assenza restituisce esplicitamente permission_required e mai un’immagine vuota.

Input obbligatori

• target

I nomi restano esattamente quelli richiesti dallo strumento. Le definizioni tecniche canoniche in inglese sono nello schema espandibile qui sotto.

Autorizzazioni e conferma

Lo schema non dichiara un parametro di conferma esplicito. Ciò non autorizza azioni senza permesso: controlla l’effetto e ottieni l’autorizzazione.

• Utilizza solo le app, gli account e le risorse autorizzate dall'utente su questa piattaforma. Consulta la descrizione specifica della piattaforma di questo strumento per i suoi requisiti di connessione e autorizzazione; questo catalogo non afferma ambiti OAuth aggiuntivi o diritti del 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"
}

Esempio documentale

Esempio di documentazione per screenshot_capture. Non eseguire questo esempio. Gli argomenti mostrati appartengono a un set di dati fittizio; individua gli identificatori reali e ottieni l’autorizzazione prima di una chiamata reale.

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