screenshot_capture

屏幕、窗口与界面 · macOS

效果: 写入. 状态: 受限可用.

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

macOS

用途

将显示器、窗口或区域的单帧捕获为 PNG。返回 {path, resolution (PIXELS), scale_factor, display_id}——scale_factor 是实际捕获的显示器的后备缩放比例（按照设计，它与 list_displays 针对该 display_id 报告的值相同：二者读取同一个函数），因此将图像坐标转换为 ui_click 坐标时，pixels = points x scale_factor。如果无法确定显示器，则会返回 scale_factor_unknown，而不会猜测；resolution 始终存在，因此你可以自行推导比例。需要“屏幕录制”权限；若没有该权限，会返回明确的 permission_required，绝不会返回空白图像。

必填输入

target

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

权限与确认

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

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

英文规范技术架构 — macOS

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