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