camera.processPicture

Processar imagens que já foram capturadas, mas ainda não foram processadas. Esse comando só será relevante se você oferecer suporte a delayProcessing, já que o processamento demora muito. Se delayProcessing não for compatível, a solicitação desse comando falhará com o código de erroDisabledCommand. Esse comando foi adicionado no nível 2 da API.

Parâmetros

  • previewFileUrls:uma lista de URLs de imagens não processadas. Se você quiser processar todas as imagens não processadas na câmera, ele será [“todas”]. Ele não pode ficar vazio. Se a câmera tiver problemas para processar qualquer imagem, ela não responderá com erro. Em vez disso, ela precisará ignorar esse URL e prosseguir com outros. O caso extremo pode ser previewToFinalFileUrls, retornado como um JSONObject vazio.

Resultados

  • previewToFinalFileUrls: um JSONObject de pares JSON <key, value="">, em que cada chave é o URL absoluto da imagem de visualização, e cada chave é a imagem processada final correspondente e pode ser usada para fazer o download diretamente da câmera. Esse comando é semelhante a camera.takePicture e não retorna previewToFinalFileUrls imediatamente (exceto para um caso explicado mais adiante neste parágrafo), uma vez que o processamento (incluindo agrupamento na câmera) geralmente leva um tempo (varia de segundos para minutos) para ser concluído. O andamento do comando é obtido pesquisando a câmera periodicamente usando a API /osc/commands/status, e previewToFinalFileUrls é o resultado retornado quando o comando é concluído. Se a conexão com a câmera for perdida antes da conclusão do comando, o cliente poderá usar listFiles para acessar os URLs das imagens finais quando conectado à câmera novamente ou emitir outro comando processPicture, que retornará previewToFinalFileUrls imediatamente se as imagens já tiverem sido processadas antes da reconexão.</key,>

Erros

  • DisabledCommand:se não houver compatibilidade com o atraso do processamento.
  • invalidParameterName:o nome do parâmetro de entrada não foi reconhecido.
  • invalidParameterValue:o nome do parâmetro de entrada é reconhecido, mas o valor dele é inválido. Por exemplo, qualquer URL em previewFileUrls é inválido.

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