启动在固定时间间隔后超时的会话。将相机锁定到发出请求的客户端,并确保相机保持唤醒状态。请注意,应始终允许启动新会话。如果存在现有会话,摄像头应在启动新会话之前自动关闭该会话。此命令在 API 级别 2 中已废弃。
参数
- timeout:(可选)请求的会话超时时间(以秒为单位)。 如果省略(HTTP 请求没有正文),相机应确定合理的超时。
成果
- sessionId::字符串类型的唯一会话标识符。
- 超时:已确认的会话超时(以秒为单位)。
错误数
- invalidParameterName:输入参数名称无法识别。
- invalidParameterValue:可识别输入参数名称,但传递的值无效;例如,值超出范围或其数据类型不正确。
命令 I/O | |
---|---|
命令输入 | { "parameters": { "timeout": 50 } } |
命令输出 | { "results": { "sessionId": "12ABC3", "timeout": 50 } } |
命令输出(错误) | { "error": { "code": "cameraInExclusiveUse", "message": "Camera already in exclusive use, new session can't be started." } } |