camera.updateSession

Refreshes the session timeout. A session automatically updates on any interaction with the camera; for example, a session that starts with a 10-minute timeout should reset to the full 10 minutes when a takePicture command executes. This command was deprecated in API level 2.

Parameters

  • sessionId: Unique session identifier of type string.
  • timeout: (Optional) Requested session timeout in seconds. If omitted (HTTP request has no body), the camera should determine a reasonable timeout.

Results

  • sessionId: Confirmed session identifier string that was passed to the command.
  • timeout: Confirmed session timeout in seconds.

Errors

  • missingParameter: sessionId is missing; for example, sessionId is not specified.
  • invalidParameterName: One or more input parameter names are unrecognized.
  • invalidParameterValue: Input parameter names are recognized, but one or more passed value are invalid; for example, the sessionId doesn't exist, it is no longer active, its data type is incorrect, or timeout is the wrong data type.

Command I/O

Command Input
{
    "parameters": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
Command Output
{
    "results": {
        "sessionId": "12ABC3",
        "timeout": 50
    }
}
Command Output (Error)
{
    "error": {
        "code": "missingParameter",
        "message": "Parameter sessionId is missing."
    }
}