camera.updateSession

刷新会话超时设置。会话会在与相机发生任何互动时自动更新;例如,如果 takePicture 命令执行时,以 10 分钟超时开始的会话应重置为完整的 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."
    }
}