camera.takePicture

Снимает равноугольное изображение, сохраняя координаты широты и долготы в EXIF ​​(если ваша камера оснащена собственным GPS или GPS включен на подключенных мобильных телефонах). При необходимости вызовите camera.setOptions перед вызовом этой команды. Эта команда была изменена на уровне API 2.

Параметры

  • sessionId: уникальный идентификатор сеанса, полученный с помощью команды camera.startSession . Это поле устарело на уровне API 2.

Полученные результаты

  • API уровня 1
    • fileUri: URI захваченного изображения. Производители решают, использовать ли абсолютные или относительные URI; например, « http://android.com/robots.txt » — это абсолютный URI, а «robots.txt» — относительный URI. Клиенты могут рассматривать это как непрозрачный идентификатор.
  • API уровня 2
    • fileUrl: абсолютный URL-адрес захваченного изображения, который можно использовать для загрузки непосредственно с HTTP-сервера камеры. Обратите внимание, что эта команда не возвращает fileUrl сразу, поскольку захват (включая сшивку в камере) обычно занимает некоторое время (от секунд до минут). Ход выполнения команды определяется путем периодического опроса камеры с помощью API /osc/commands/status, а fileUrl — это результат, возвращаемый после завершения команды. Если для delayProcessing установлено значение true, это абсолютный URL-адрес изображения предварительного просмотра, который можно использовать в качестве входных данных в ProcessPicture для обработки изображения; в противном случае это абсолютный URL-адрес окончательно обработанного изображения.

Ошибки

  • MissingParameter: sessionId отсутствует. Этот код ошибки устарел на уровне API 2.
  • validParameterName: имя параметра не распознано, например sessionId не распознается на уровне API 2.
  • validParameterValue: имя входного параметра распознано, но его значение недопустимо; например, sessionId не существует, больше не активен или его тип данных неверен. Этот код ошибки устарел на уровне API 2.
  • DisabledCommand: Команда в настоящее время отключена; например, камера находится в режиме видеосъемки. Этот код ошибки был добавлен на уровне API 2.

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

Ввод команды (уровень API 1)
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
Вывод команды (уровень API 1)
{
    "results": {
        "fileUri": "file URI"
    }
}
Вывод команды (ошибка) (уровень API 1)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
Ввод команды (уровень API 2)
none
Вывод команды (уровень API 2)
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
Вывод команды (ошибка) (уровень API 2)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}