Odświeża limit czasu sesji. Sesja jest automatycznie aktualizowana po każdej interakcji z kamerą. Na przykład sesja rozpoczynająca się od 10-minutowego limitu czasu powinna być resetowana do pełnych 10 minut po wykonaniu polecenia takePicture
. To polecenie zostało wycofane w interfejsie API poziomu 2.
Parametry
- sessionId: unikalny identyfikator sesji ciągu znaków.
- timeout: (opcjonalnie) żądany limit czasu sesji (w sekundach). W przypadku jego pominięcia (żądanie HTTP nie ma treści), kamera powinna określić rozsądny czas oczekiwania.
Wyniki
- sessionId: potwierdzony ciąg identyfikatora sesji przekazany do polecenia.
- timeout:potwierdzony limit czasu sesji (w sekundach).
Błędy
- missingParameter: brakuje parametru
sessionId
, np. nie podanosessionId
. - ErrorParameterName: co najmniej 1 nazwa parametru wejściowego nie została rozpoznana.
- NieprawidłoweParametrValue: nazwy parametrów wejściowych są rozpoznawane, ale co najmniej 1 przekazana wartość jest nieprawidłowa, np.
sessionId
nie istnieje, jest już nieaktywny, jego typ danych jest nieprawidłowy lubtimeout
jest nieprawidłowy.
Command I/O | |
---|---|
Polecenie | { "parameters": { "sessionId": "12ABC3", "timeout": 50 } } |
Dane wyjściowe polecenia | { "results": { "sessionId": "12ABC3", "timeout": 50 } } |
Dane wyjściowe polecenia (błąd) | { "error": { "code": "missingParameter", "message": "Parameter sessionId is missing." } } |