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, epreviewToFinalFileUrls
é 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á usarlistFiles
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." } } |