camera.startCapture
根据 的值开始拍摄视频,或以间隔拍摄图片
选项中的 captureMode
。
此命令是在 API 级别 2 中添加的。
参数
- 此命令的请求正文中没有参数。是否为间隔图片
拍摄或视频拍摄由
captureMode
选项决定。
对于固定间隔拍摄,是否采用开放式拍摄取决于
captureNumber
是否等于或大于 0。
captureMode
、captureInterval
和
需要在间隔拍摄之前设置 captureNumber
。
只有 captureMode
需要设置为“视频”视频播放前
捕获,只能通过 camera.stopCapture 命令停止。
结果
- 开放式捕获(当 captureMode == "video"或 captureNumber == 0 时)
<ph type="x-smartling-placeholder">
- 非开放式间隔拍摄:
<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." } } |
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2024-08-21。
[null,null,["最后更新时间 (UTC):2024-08-21。"],[[["Initiates either video or interval image capture based on pre-set capture mode."],["For interval capture, `captureMode`, `captureInterval`, and `captureNumber` options must be configured beforehand."],["For video capture, only `captureMode` needs to be set to \"video\" and can be stopped using the `camera.stopCapture` command."],["The command results for non-open-ended interval capture include a list of image URLs accessible after capture completion, retrievable via polling or `camera.listFiles`."],["Errors like \"disabledCommand\" occur if the camera is already capturing or \"invalidParameterName\" if an unrecognized parameter is used."]]],["This command initiates video or interval image capture based on the `captureMode` setting. For interval capture, `captureNumber` determines if it's open-ended; `captureInterval` and `captureNumber` must be preset. Video capture, set by `captureMode`, is ended via `camera.stopCapture`. Open-ended capture has no immediate results. Non-open-ended interval capture eventually provides a `fileUrls` list, accessible after the completion time or if interrupted. Errors include `disabledCommand` and `invalidParameterName`. The command's input is null, and output results with file URLs.\n"]]