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, ortimeout
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." } } |