aparat.startPrzechwytywanie

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, czy captureNumber ma wartość równą 0 czy większą. Przed zrobieniem zdjęcia z interwałem należy ustawić wartości captureMode, captureInterval i captureNumber. Tylko parametr captureMode 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 trwa captureNumber. 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 jest fileUrls. 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ą.

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