すべてのツール

ui_read_tree

画面、ウインドウ、UI · macOS · Windows

効果: 読み取り. 状態: 条件付き提供.

「条件付き提供」は、バージョン、プラットフォーム、権限、アカウント、設定に依存する可能性を示し、すべての環境で有効という意味ではありません。

macOS

目的

実行中ネイティブアプリのラベル付き要素と操作可能要素（ボタン、リンク、テキスト欄、チェックボックス、メニューなど）を簡潔なアクセシビリティツリーで返します。web_read の a11y モードに相当します。未知のアプリで role/label が分からないとき、ui_find_element の前に対象を発見するため使います。操作可能ノードの `ref` はそのまま ui_click に渡せます。実行中アプリの app_bundle_id（例: com.apple.finder。list_windows を参照）を渡してください。ツリーは重要なノードに絞られ、max_depth（既定12）とノード予算があるため巨大なウィンドウは部分結果になります。macOS メニューバーは通常省略され、必要な場合だけ include_menu_bar=true を指定します。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

英語の正規技術スキーマ — macOS
{
  "properties": {
    "app_bundle_id": {
      "description": "Bundle id of a RUNNING app (e.g. com.apple.finder)",
      "type": "string"
    },
    "include_menu_bar": {
      "description": "Include the app's macOS menu bar (hundreds of menu-item nodes). Default false.",
      "type": "boolean"
    },
    "max_depth": {
      "description": "Max tree depth to descend (default 12, max 20)",
      "type": "integer"
    },
    "window_id": {
      "description": "Alternative to app_bundle_id: a window id from list_windows (targets that window's app)",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

ui_read_tree のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{}

Windows

目的

実行中 Windows アプリのラベル付き要素と操作可能要素を簡潔な UI Automation ツリーで返します。web_read の a11y モードに相当します。未知のアプリで role/label が分からないとき、ui_find_element の前に対象を発見するため使います。操作可能ノードの `ref` はそのまま ui_click に渡せます。実行中アプリのプロセス名を `app` に渡してください。ツリーは重要なノードに絞られ、max_depth（既定12）とノード予算があるため巨大なウィンドウは部分結果になります。

必須入力

このプラットフォームのスキーマには必須入力が宣言されていません。任意の選択項目や実行要件が存在する場合があります。

権限と確認

スキーマには明示的な確認パラメータがありません。これは無許可の操作を認めるものではありません。効果を確認し、承認を得てください。

英語の正規技術スキーマ — Windows
{
  "properties": {
    "app": {
      "description": "Process name of a RUNNING app (e.g. notepad).",
      "type": "string"
    },
    "max_depth": {
      "description": "Max tree depth to descend (default 12, max 20).",
      "type": "integer"
    }
  },
  "required": [],
  "type": "object"
}

ドキュメント例

ui_read_tree のドキュメント例です。この例は実行しないでください。表示される引数は架空のデータセットに属します。実際に呼び出す前に実在する識別子を確認し、承認を得てください。

{}