aparat.startsesja

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."

   
}
}