video_trim

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

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

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

macOS

用途

将视频裁剪为一个或多个时间范围（毫秒），按顺序拼接成一个新文件——例如保留 [{start_ms:0,end_ms:6000},{start_ms:126000,end_ms:223000}] 以去掉无用片段。音频会一并保留。返回输出路径和时长。绝不会原地覆盖输入文件。首次调用返回预览；confirm: true 才会写入文件。

必填输入

input
ranges

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

权限与确认

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

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

英文规范技术架构 — macOS

{
  "properties": {
    "confirm": {
      "description": "Must be true to write the output. Without it the call returns a preview and writes nothing.",
      "type": "boolean"
    },
    "input": {
      "description": "Path to the source video.",
      "type": "string"
    },
    "output": {
      "description": "Output path (default: <input>_trimmed.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"
    },
    "ranges": {
      "description": "Ordered [{start_ms, end_ms}] to keep.",
      "items": {
        "type": "object"
      },
      "type": "array"
    }
  },
  "required": [
    "input",
    "ranges"
  ],
  "type": "object"
}

文档示例

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

{
  "confirm": false,
  "input": "/Users/demo/Documents/meeting.mov",
  "ranges": [
    {
      "end_ms": 5000,
      "start_ms": 0
    }
  ]
}

Windows

用途

将视频裁剪为一个或多个时间范围（毫秒），按顺序拼接成一个新文件——例如保留 [{start_ms:0,end_ms:6000},{start_ms:126000,end_ms:223000}] 以去掉无用片段。音频会一并保留。返回输出路径和时长。绝不会原地覆盖输入文件。首次调用返回预览，不写入任何内容；confirm=true 才会导出。