камера.startCapture

Запускает захват видео или интервальный захват изображения в зависимости от значения captureMode в Options . Эта команда была добавлена ​​на уровне API 2.

Параметры

  • Эта команда не имеет параметров в теле запроса. Будет ли это интервальный захват изображения или захват видео, определяется опцией captureMode . Для интервального захвата, является ли это открытый захват или нет, зависит от того, равно ли captureNumber 0 или больше него. captureMode , captureInterval и captureNumber необходимо установить до интервального захвата. Только captureMode необходимо установить значение «video» перед захватом видео, который можно остановить только с помощью команды camera.stopCapture .

Результаты

  • Открытый захват (когда captureMode == "video" или captureNumber == 0)
    • Никаких результатов.
  • Захват неоткрытого интервала:
    • fileUrls: список абсолютных URL-адресов, указывающих на файлы изображений для интервального захвата. Обратите внимание, что эта команда не возвращает fileUrls сразу, поскольку для завершения захвата требуется captureNumber . О ходе выполнения команды можно узнать, периодически опрашивая камеру. Например, опрос после предполагаемой продолжительности ( time = captureInterval * (captureNumber - 1) ) с использованием API /osc/commands/status и fileUrls — это результат, возвращаемый после завершения команды. Если команда не завершается успешно (например, было сделано только 3 изображения до того, как в камере разрядился аккумулятор) или камера отключается от клиентского телефона в середине, но команда завершается успешно, клиент должен иметь возможность чтобы получить изображения с помощью camera.listFiles позже, когда между клиентом и камерой будет установлено новое соединение.

Ошибки

  • DisabledCommand: Команда в настоящее время отключена; например, камера находится в процессе захвата видео или интервальной съемки.
  • validParameterName: имя параметра не распознано; например, sessionId не распознается.

Командный ввод/вывод

Ввод команды
none
Вывод команды
{
    "results": {
        "fileUrls":[
            "url1",
            "url2",
            "url3",
            ...
            "urln"
        ]
    }
}
Вывод команды (ошибка)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}