video_reframe

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

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

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

macOS

用途

围绕焦点将视频裁剪为目标宽高比（例如 "9:16" 竖屏、"1:1" 方形、"4:5"）——用于社交媒体短片。取能容纳的该宽高比的最大裁剪区域，以 `focus` 为中心（源像素中的 x,y，原点在左上角；默认 = 中心），并限制在画面之内。音频原样保留。返回输出路径和新的尺寸。首次调用返回预览；confirm: true 才会写入文件。

必填输入

input
aspect

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

权限与确认

架构声明了明确的确认参数。请检查预览，并按此平台的契约授权实际操作。

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

英文规范技术架构 — macOS

{
  "properties": {
    "aspect": {
      "description": "Target aspect \"W:H\", e.g. 9:16, 1:1, 4:5, 16:9.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to write the output. Without it the call returns a preview and writes nothing.",
      "type": "boolean"
    },
    "focus": {
      "description": "{x,y} center of interest in source pixels (top-left). Default: frame center.",
      "type": "object"
    },
    "input": {
      "description": "Path to the source video file.",
      "type": "string"
    },
    "output": {
      "description": "Default: <input>_<aspect>.mov. Missing parent folders are created.",
      "type": "string"
    },
    "overwrite": {
      "description": "Replace an existing file at output. Without it an existing output is refused. The input is never overwritten.",
      "type": "boolean"
    }
  },
  "required": [
    "input",
    "aspect"
  ],
  "type": "object"
}

文档示例

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

{
  "aspect": "9:16",
  "confirm": false,
  "input": "/Users/demo/Documents/meeting.mov"
}

Windows

用途

围绕焦点将视频裁剪为目标宽高比（例如 "9:16" 竖屏、"1:1" 方形、"4:5"）——用于社交媒体短片。取能容纳的该宽高比的最大裁剪区域，以 `focus` 为中心（源像素中的 x,y，原点在左上角；默认 = 中心），并限制在画面之内。音频原样保留。返回输出路径和新的尺寸。首次调用返回预览，不写入任何内容；confirm=true 才会导出。