모든 도구

list_windows

화면, 윈도우 및 인터페이스 · macOS · Windows

효과: 읽기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

모든 앱의 화면에 표시된 창을 window_id, 소유 앱 번들 ID와 이름, 제목, 경계(전역 공간, 좌측 상단, 포인트), display_id(CGDirectDisplayID로 list_displays와 일치), is_focused와 함께 나열합니다. 창 TITLES를 보려면 화면 기록 권한이 필요합니다. 권한이 없으면 제목 없는 결과 대신 명시적인 permission_required 오류를 반환합니다. 선택적 app_bundle_id 필터를 사용할 수 있지만 Electron 계열 앱은 다른 번들 ID의 HELPER 프로세스가 창을 소유하는 경우가 많아 앱이 화면에 보여도 필터 결과가 비어 있을 수 있습니다. on_screen_only는 DEFAULTS TO TRUE이며 최소화, 숨김 및 다른 Space의 창을 제외합니다. 모두 보려면 false를 전달하세요. 결과가 비면 어떤 필터 때문에 비었고 무엇을 대신 전달해야 하는지 설명하는 `note`를 반환하므로 앱에 창이 없다고 결론 내리지 말고 읽으세요. window_id는 이후 대상을 지정할 수 있도록 세션 동안 안정적입니다.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

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

영문 정식 기술 스키마 — macOS
{
  "properties": {
    "app_bundle_id": {
      "description": "Only return windows owned by this app bundle id.",
      "type": "string"
    },
    "on_screen_only": {
      "description": "Only on-screen windows (default true).",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

문서 예시

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

{}

Windows

목적

이 머신에서 열린 창의 창 ID, 소유 앱(exe 이름), pid, 제목, 경계 {x,y,w,h}와 디스플레이 ID를 나열합니다. Win32 창 API를 사용하는 Windows 전용 도구입니다. app_bundle_id로 앱을 필터링할 수 있으며 Windows에서는 exe 이름 부분 일치로 처리됩니다.

필수 입력

이 플랫폼의 스키마에는 필수 입력이 선언되어 있지 않습니다. 선택 항목이나 실행 요구 사항은 여전히 있을 수 있습니다.

권한 및 확인

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

영문 정식 기술 스키마 — Windows
{
  "properties": {
    "app_bundle_id": {
      "description": "Filter to windows owned by this app. On Windows, a case-insensitive substring of the exe name (e.g. 'chrome').",
      "type": "string"
    },
    "on_screen_only": {
      "description": "Only return visible, non-empty-title windows (default true).",
      "type": "boolean"
    }
  },
  "required": [],
  "type": "object"
}

문서 예시

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

{}