aparat.startPrzechwytywanie

Rozpoczyna nagrywanie filmu lub robienie zdjęć z interwałami w zależności od wartości captureMode w Opcjach. To polecenie zostało dodane na poziomie interfejsu API 2.

Parametry

  • To polecenie nie ma parametru w treści żądania. Określa, czy jest to obraz interwału przechwytywanie lub nagrywanie filmu zależy od opcji captureMode. To, czy jest to zapis otwarty, czy nie, zależy od wskazuje, czy captureNumber jest równa lub większa od 0. captureMode, captureInterval i Ustawienie captureNumber musi być ustawione przed rozpoczęciem robienia zdjęć z interwałem. Tylko parametr captureMode musi mieć wartość „video” przed filmem , które można zatrzymać tylko za pomocą polecenia camera.stopCapture.

Wyniki

  • Przechwytywanie otwarte (gdy CapMode == "video" lub scanNumber == 0)
    • Brak wyników.
  • Robienie zdjęć z interwałami nieotwartymi:
    • fileUrls: lista bezwzględnych adresów URL prowadzących do obrazu. do robienia zdjęć z interwałami. Pamiętaj, że to polecenie nie zwraca fileUrls od razu po zakończeniu sesji captureNumber, aby zakończyć. Postępem wykonywania polecenia może być uzyskane dzięki okresowym odpytywaniu kamery. Na przykład przeprowadź ankietę po szacowany czas trwania (time = captureInterval * (captureNumber - 1)) przy użyciu interfejsu API /osc/commands/status. a fileUrls jest wynikiem zwracanym po zakończeniu wykonywania polecenia. Jeśli polecenie nie zakończy się powodzeniem (np. tylko 3 z obrazów zostały zrobione przed wyczerpaniem się baterii) lub kamera jest odłączona z telefonu klienta na środku, ale polecenie kończy się pomyślnie, klient powinien mieć możliwość pobrania zdjęć za pomocą camera.listFiles później, gdy nawiąże nowe połączenie między klientem a kamerą.

Błędy

  • disableCommand: polecenie jest obecnie wyłączone. na przykład kamera w trakcie nagrywania filmu lub nagrywania z interwałami.
  • invalidParametrName:nie udało się rozpoznać nazwy parametru. np. Nie rozpoznano pola sessionId.

Polecenie I/O
Dane wejściowe polecenia 
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."
    }
}