camera.startSession

启动在固定时间间隔后超时的会话。将相机锁定到发出请求的客户端,并确保相机保持唤醒状态。请注意,应始终允许启动新会话。如果存在现有会话,摄像头应在启动新会话之前自动关闭该会话。此命令在 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."
    }
}