ui_type

屏幕、窗口与界面 · macOS · Windows

效果: 执行. 状态: 受限可用.

“受限可用”表示工具可能取决于版本、平台、权限、账户或配置，并不表示它在所有安装中都已启用。

macOS

用途

向当前聚焦的控件输入文本（或先聚焦 element_ref，再输入）。它发送真实按键事件，因此会触发验证和处理程序。结果通过回读控件进行验证，而不是根据写入是否成功判断：{typed, verified:true} 表示其值确实发生变化；input_not_applied 是明确错误，表示事件已发出但值没有变化（什么也没输入，通常因为窗口不在最前面）；verified:false + verification:'unavailable' 表示目标未发布可读值，因此无法确认投递，你应自行回读。需要辅助功能权限。

必填输入

text

输入名称会严格保持工具要求的形式。下方可展开的架构中保留英文规范技术定义。

权限与确认

架构未声明明确的确认参数。这并不代表可以未经许可操作；请检查效果并取得授权。

仅使用用户在此平台上授权的应用、账户和资源。请查阅此工具针对平台的说明，以了解其连接和权限要求；本目录不声称需要额外的 OAuth 范围或操作系统授权。

英文规范技术架构 — macOS

{
  "properties": {
    "element_ref": {
      "description": "Optional; focus this element first.",
      "type": "string"
    },
    "text": {
      "description": "The text to type.",
      "type": "string"
    }
  },
  "required": [
    "text"
  ],
  "type": "object"
}

文档示例

ui_type 的文档示例。请勿执行此示例。所示参数属于虚构数据集；在实际调用前，请解析真实标识符并获得授权。

{
  "text": "Can we review the launch checklist on Tuesday?"
}

Windows

用途

向当前聚焦的控件输入文本（或先聚焦 element_ref，再输入）。它发送真实按键事件，因此会触发验证和处理程序。