camera.processPicture

Обработка изображений, которые были ранее захвачены, но еще не обработаны. Эта команда актуальна только в том случае, если вы поддерживаете delayProcessing , поскольку обработка занимает много времени. Если вы не поддерживаете delayProcessing , запрос этой команды должен завершиться неудачно с кодом ошибки DisableCommand. Эта команда была добавлена ​​на уровне API 2.

Параметры

  • PreviewFileUrls: список URL-адресов необработанных изображений. Если вы хотите обработать все необработанные изображения в камере, то это [«все»]. Оно не может быть пустым. Если у камеры возникают проблемы с обработкой какого-либо изображения, камера не отвечает с сообщением об ошибке, вместо этого она должна игнорировать этот URL-адрес и продолжить работу с другими, а в крайнем случае может быть previewToFinalFileUrls , возвращаемый как пустой JSONObject.

Результаты

  • Предварительный просмотрToFinalFileUrls: JSONObject из JSON пары, где каждый ключ представляет собой абсолютный URL-адрес изображения предварительного просмотра, а каждый ключ представляет собой соответствующее окончательно обработанное изображение и может использоваться для загрузки непосредственно с камеры. Обратите внимание, что эта команда похожа на camera.takePicture и не возвращает previewToFinalFileUrls немедленно (за исключением углового случая, описанного ниже в этом параграфе), поскольку обработка (включая сшивку в камере) обычно занимает некоторое время (варьируется от секунд до минут). ) для завершения. О ходе выполнения команды можно узнать путем периодического опроса камеры с помощью API /osc/commands/status , а previewToFinalFileUrls — это результат, возвращаемый после завершения команды. Если соединение с камерой потеряно до завершения команды, клиент может использовать listFiles для получения URL-адресов окончательных изображений при повторном подключении к камере или выполнить другую командуprocessPicture, которая должна немедленно вернуть previewToFinalFileUrls , если изображения уже были обработаны до завершения команды. повторное подключение.

Ошибки

  • DisableCommand: Если вы не поддерживаете обработку задержки.
  • validParameterName: имя входного параметра не распознано.
  • validParameterValue: имя входного параметра распознано, но его значение недопустимо; например, любой URL-адрес в previewFileUrls недействителен.

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

Ввод команды
{
    "parameters": {
        "previewFileUrls": [
            "previewFileUrl1",
            "previewFileUrl2",
            "previewFileUrl3",
            ...
            "previewFileUrln"
        ]
    }
}
Вывод команды
{
    "results": {
        "previewToFinalFileUrls":{
            "previewFileUrl1": "finalFileUrl1",
            "previewFileUrl2": "finalFileUrl2",
            "previewFileUrl3": "finalFileUrl3",
            ...
            "previewFileUrln": "finalFileUrln"
        }
    }
}
Вывод команды (ошибка)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}