screenshot_capture

macOS

목적

디스플레이, 창 또는 영역의 단일 프레임을 PNG로 캡처합니다. {path, resolution (PIXELS), scale_factor, display_id}를 반환합니다. scale_factor는 실제로 캡처된 디스플레이의 backing scale이며, 구조상 list_displays가 해당 display_id에 보고하는 값과 같습니다(둘 다 같은 함수를 읽음). 따라서 이미지 좌표를 ui_click으로 변환할 때 pixels = points x scale_factor입니다. 디스플레이를 확인할 수 없으면 추측값 대신 scale_factor_unknown을 반환합니다. resolution은 항상 있으므로 비율을 직접 계산할 수 있습니다. 화면 기록 권한이 필요하며, 권한이 없으면 빈 이미지 대신 명시적인 permission_required를 반환합니다.

필수 입력

• target

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 없습니다. 이는 무단 작업을 허용하지 않습니다. 효과를 검토하고 승인을 받으세요.

• 이 플랫폼에서는 사용자가 승인한 앱, 계정 및 리소스만 사용하세요. 연결 및 권한 요구 사항은 이 도구의 플랫폼별 설명을 참조하세요. 이 카탈로그는 추가 OAuth 범위나 OS 권한이 있다고 주장하지 않습니다.

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

문서 예시

screenshot_capture 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

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