Uruchamia sesję, której limit czasu kończy się po ustalonym czasie. Łączy kamerę z klientem wysyłającym żądanie i pilnuje, aby była ona nieaktywna. Rozpoczęcie nowej sesji powinno być zawsze dozwolone. Jeśli trwa 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: (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: unikalny identyfikator sesji ciągu znaków.
- timeout:potwierdzony limit czasu sesji (w sekundach).
Błędy
- ErrorParameterName: nie udało się rozpoznać nazwy parametru wejściowego.
- ErrorParameterValue: zostaje rozpoznana nazwa parametru wejściowego, ale przekazana wartość jest nieprawidłowa, na przykład wartość jest poza zakresem lub jej typ danych jest nieprawidłowy.
Command I/O | |
|---|---|
| Polecenie | {
"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."
}
} |