camera.updateSession

刷新会话超时。会话会与相机的任何互动自动更新;例如,以 10 分钟超时开头的会话执行 takePicture 命令时,应重置为完整的 10 分钟。此命令在 API 级别 2 中已弃用。

参数

  • sessionId:字符串的唯一会话标识符。
  • timeout:(可选)所请求的会话超时(以秒为单位)。 如果省略(HTTP 请求没有正文),相机应确定合理的超时时间。

成效

  • sessionId:传递给命令的已确认会话标识符字符串。
  • 超时:已确认的会话超时(以秒为单位)。

错误

  • missingParameter:缺少 sessionId;例如,未指定 sessionId
  • invalidParameterName:一个或多个输入参数名称无法识别。
  • invalidParameterValue:输入参数名称已被识别,但一个或多个传递的值无效;例如,sessionId 不存在、其不再有效、其数据类型不正确,或者 timeout 是错误的数据类型。

命令 I/O

命令输入
{
    "parameters": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
命令输出
{
    "results": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
命令输出(错误)
{
    "error": {
        "code": "missingParameter",
        "message": "Parameter sessionId is missing."
    }
}