camera.processPicture

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Procesar imágenes que se hayan capturado anteriormente, pero que todavía no se hayan procesado Este comando es relevante solo si admites delayProcessing, ya que el procesamiento lleva mucho tiempo. Si no admites delayProcessing, la solicitud de este comando debería fallar con el código de error disabledCommand. Este comando se agregó en el nivel de API 2.

Parámetros

  • previewFileUrls: Una lista de las URL de las imágenes no procesadas. Si quieres procesar todas las imágenes sin procesar de la cámara, el valor es [“all”]. No puede estar vacío. Si la cámara tiene problemas para procesar alguna imagen, no responderá con error; en su lugar, debe ignorar esa URL y continuar con las otras, y el caso extremo puede ser previewToFinalFileUrls. Se muestra como un objeto JSON vacío.

Resultados

  • previewToFinalFileUrls: un JSONObject de pares de claves <value="> donde cada clave es la URL absoluta de la imagen de vista previa y cada clave es la imagen final procesada correspondiente y se puede usar para descargar directamente desde la cámara. Ten en cuenta que este comando es similar a camera.takePicture y no muestra previewToFinalFileUrls de inmediato (excepto en el caso de una esquina que se explica más adelante en este párrafo), ya que el procesamiento (incluida la unión de la cámara) suele tardar un poco (varía de segundos a minutos). El progreso del comando se obtiene mediante un sondeo periódico de la cámara con la API de /osc/commands/status, y previewToFinalFileUrls es el resultado que se muestra cuando finaliza el comando. Si se pierde la conexión con la cámara antes de que finalice el comando, el cliente puede usar listFiles para obtener las URL de las imágenes finales cuando vuelva a conectarse a la cámara o emitir otro comando processPicture, que debería mostrar previewToFinalFileUrls de inmediato si las imágenes ya se habían procesado antes de la reconexión.</key>

Errores

  • disabledCommand: Si no admites el retraso del procesamiento
  • invalidParameterName: no se reconoce el nombre del parámetro de entrada.
  • invalidParameterValue: Se reconoce el nombre del parámetro de entrada, pero su valor no es válido; por ejemplo, cualquier URL en previewFileUrls no es válida.

E/S de comando
Entrada de comando 
{
    "parameters": {
        "previewFileUrls": [
            "previewFileUrl1",
            "previewFileUrl2",
            "previewFileUrl3",
            ...
            "previewFileUrln"
        ]
    }
}
Resultado del comando 
{
    "results": {
        "previewToFinalFileUrls":{
            "previewFileUrl1": "finalFileUrl1",
            "previewFileUrl2": "finalFileUrl2",
            "previewFileUrl3": "finalFileUrl3",
            ...
            "previewFileUrln": "finalFileUrln"
        }
    }
}
Resultado del comando (error) 
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}