screenshot_capture

macOS

Finalidade

Captura um único quadro de uma tela, janela ou região em um PNG. Retorna {path,resolution(PIXELS),scale_factor,display_id} — scale_factor é a escala de fundo da tela que foi capturada por ACTUALLY (o mesmo valor que list_displays relata para aquele display_id, por construção: ambos leem uma função), então pixels = pontos x scale_factor quando convertendo uma coordenada da imagem para ui_click. Se a exibição não puder ser determinada, você obterá scale_factor_unknown em vez de uma estimativa; a resolução está sempre presente, então você mesmo pode derivar a proporção. Requer permissão de gravação de tela; sem ele retorna um permission_required explícito, nunca uma imagem em branco.

Entradas obrigatórias

• target

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema não declara um parâmetro explícito de confirmação. Isto não autoriza qualquer ação sem permissão; reveja o efeito e obtenha autorização.

• Utilize apenas os aplicativos, contas e recursos autorizados pelo usuário nesta plataforma. Consulte a descrição específica da plataforma desta ferramenta para saber os requisitos de conexão e permissão; este catálogo não reivindica escopos OAuth adicionais ou direitos de sistema operacional.

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

Exemplo documental

Exemplo de documentação para screenshot_capture. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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