camera.startCapture

根据 的值开始拍摄视频,或以间隔拍摄图片 选项中的 captureMode此命令是在 API 级别 2 中添加的。

参数

  • 此命令的请求正文中没有参数。是否为间隔图片 拍摄或视频拍摄由 captureMode 选项决定。 对于固定间隔拍摄,是否采用开放式拍摄取决于 captureNumber 是否等于或大于 0。 captureModecaptureInterval和 需要在间隔拍摄之前设置 captureNumber。 只有 captureMode 需要设置为“视频”视频播放前 捕获,只能通过 camera.stopCapture 命令停止。

结果

  • 开放式捕获(当 captureMode == "video"或 captureNumber == 0 时) <ph type="x-smartling-placeholder">
      </ph>
    • 无结果。
  • 非开放式间隔拍摄: <ph type="x-smartling-placeholder">
      </ph>
    • fileUrls::指向图片的绝对网址列表 用于间隔捕获的文件。请注意,此命令不会返回 fileUrls,因为拍摄 captureNumber即可完成。命令的进度可以是 获得的值。例如,在 预计用时(time = captureInterval * (captureNumber - 1)) 使用 /osc/commands/status API fileUrls 是命令完成后返回的结果。 如果命令未成功完成(例如,只有 3 张图片中的 或相机已断开连接) 但命令成功完成, 客户端应该能够使用 camera.listFiles 系统稍后会在客户端和相机之间建立新的连接时发送。

错误

  • disabledCommand:命令当前已停用;例如,相机 正在进行视频拍摄或间隔拍摄。
  • invalidParameterName:参数名称无法识别;例如 无法识别sessionId

命令 I/O

命令输入
none
命令输出
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
命令输出(错误)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}