Rozpoczyna sesję, której limit czasu wynosi ustalony. Blokuje kamerę na wysyłając do klienta żądanie i upewniając się, że kamera pozostaje aktywna. Uwaga: od nowa sesja powinna być zawsze dozwolona. Jeśli istnieje już sesja, powinna zostać automatycznie zamknięta przez kamerę przed rozpoczęciem nowej sesji. To polecenie zostało wycofane w interfejsie API poziomu 2.
Parametry
- timeout: (opcjonalny) limit czasu oczekiwania na sesję w sekundach. W przypadku pominięcia tego pola (żądanie HTTP nie ma treści), kamera powinna określić uzasadniony .
Wyniki
- sessionId: unikalny identyfikator sesji danego typu.
- timeout:potwierdzony limit czasu sesji w sekundach;
Błędy
- invalidParametrName:nie udało się rozpoznać nazwy parametru wejściowego.
- invalidParameterValue::nazwa parametru wejściowego jest rozpoznawana, ale parametr przekazywana wartość jest nieprawidłowa; np. wartość jest poza zakresem lub zawiera dane typ jest nieprawidłowy.
Polecenie I/O | |
|---|---|
| Dane wejściowe polecenia | {
"parameters": {
"timeout": 50
}
} |
| Dane wyjściowe polecenia | {
"results": {
"sessionId": "12ABC3",
"timeout": 50
}
} |
| Dane wyjściowe polecenia (błąd) | {
"error": {
"code": "cameraInExclusiveUse",
"message": "Camera already in exclusive use, new
session can't be started."
}
} |