刷新会话超时设置。会话会在与相机发生任何互动时自动更新;例如,如果 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." } } |