Uruchamia nagrywanie filmu lub robienie zdjęć z interwałami w zależności od wartości captureMode
w opcjach.
To polecenie zostało dodane w interfejsie API na poziomie 2.
Parametry
- To polecenie nie ma parametru w treści żądania. To, czy wybierzesz robienie zdjęć z interwałami, czy nagrywanie filmów, określa opcja
captureMode
. W przypadku przechwytywania z interwałami to, czy jest to nagrywanie otwarte, czy nie, zależy od tego, czycaptureNumber
ma wartość równą 0 czy większą. Przed zrobieniem zdjęcia z interwałem należy ustawić wartościcaptureMode
,captureInterval
icaptureNumber
. Tylko parametrcaptureMode
musi mieć wartość „video” przed rozpoczęciem nagrywania filmu. Można to zatrzymać tylko za pomocą polecenia camera.stopCapture.
Wyniki
- Przechwytywanie otwarte (gdy CapMode == "video" lub CapNumber == 0)
- Brak wyników.
- Rejestrowanie interwałów bez przerw:
- fileUrls: lista bezwzględnych adresów URL wskazujących pliki obrazów na potrzeby przechwytywania interwałów. Pamiętaj, że to polecenie nie zwraca od razu
fileUrls
, ponieważ przechwytywanie trwacaptureNumber
. Postępy wykonywania polecenia można sprawdzić, okresowo przeprowadzając ankietę w kamerze. Na przykład sonda po szacowanym czasie trwania (time = captureInterval * (captureNumber - 1)
) przy użyciu interfejsu API /osc/commands/status, a wynikiem polecenia jestfileUrls
. Jeśli polecenie nie zostanie poprawnie ukończone (np. zrobiono tylko 3 zdjęcia, zanim bateria w kamerze zostanie rozładowana) lub gdy kamera zostanie odłączona od telefonu klienta w środku, ale polecenie zostanie wykonane, klient powinien być w stanie pobrać obrazy za pomocącamera.listFiles
później po nawiązaniu nowego połączenia między klientem a kamerą.
- fileUrls: lista bezwzględnych adresów URL wskazujących pliki obrazów na potrzeby przechwytywania interwałów. Pamiętaj, że to polecenie nie zwraca od razu
Błędy
- disableCommand: polecenie jest obecnie wyłączone, np. gdy kamera jest w trakcie nagrywania filmu lub nagrywania z interwałem.
- ErrorParameterName: nie rozpoznano nazwy parametru, np.
sessionId
.
Command I/O | |
---|---|
Polecenie | none |
Dane wyjściowe polecenia | { "results": { "fileUrls":[ "url1", "url2", "url3", ... "urln" ] } } |
Dane wyjściowe polecenia (błąd) | { "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |