Traiter les images capturées précédemment, mais pas encore traitées.
Cette commande n'est pertinente que si vous prenez en charge delayProcessing
, car le traitement prend beaucoup de temps. Si vous n'acceptez pas delayProcessing
, la requête de cette commande devrait échouer avec le code d'erreur disabledCommand.
Cette commande a été ajoutée au niveau d'API 2.
Paramètres
- previewFileUrls:liste des URL d'images non traitées.
Si vous voulez traiter toutes les images non traitées dans l'appareil photo, utilisez ["toutes"].
Le champ ne peut pas être vide. Si l'appareil photo rencontre des difficultés pour traiter une image, il ne répond pas avec une erreur. Il doit ignorer cette URL et en traiter d'autres. Dans les cas extrêmes,
previewToFinalFileUrls
est renvoyé sous la forme d'un JSONObject vide.
Résultats
- previewToFinalFileUrls:un JSONObject de paires <key, value=""> JSON, où chaque clé correspond à l'URL absolue de l'image d'aperçu, et chaque clé est l'image traitée finale correspondante et peut être utilisée pour la télécharger directement depuis l'appareil photo. Veuillez noter que cette commande est semblable à "camera.takePicture" et ne renvoie pas immédiatement
previewToFinalFileUrls
(sauf pour un cas d'angle expliqué plus loin dans ce paragraphe), car le traitement (y compris l'assemblage dans l'appareil photo) prend généralement un certain temps (de quelques secondes à quelques minutes). La progression de la commande est obtenue en interrogeant régulièrement la caméra à l'aide de l'API /osc/commands/status.previewToFinalFileUrls
est le résultat renvoyé à la fin de la commande. Si la connexion à l'appareil photo est perdue avant la fin de la commande, le client peut utiliserlistFiles
pour obtenir les URL des images finales lorsqu'il est de nouveau connecté à l'appareil photo ou émettre une autre commande processPicture, qui devrait renvoyer immédiatementpreviewToFinalFileUrls
si les images ont déjà été traitées avant la reconnexion.</key,>
Erreurs
- disabledCommand:si vous n'acceptez pas le traitement retardé.
- invalidParameterName:le nom du paramètre d'entrée n'est pas reconnu.
- invalidParameterValue:le nom du paramètre d'entrée est reconnu, mais sa valeur n'est pas valide. Par exemple, toute URL dans
previewFileUrls
n'est pas valide.
E/S des commandes | |
---|---|
Entrée de commande | { "parameters": { "previewFileUrls": [ "previewFileUrl1", "previewFileUrl2", "previewFileUrl3", ... "previewFileUrln" ] } } |
Résultat de la commande | { "results": { "previewToFinalFileUrls":{ "previewFileUrl1": "finalFileUrl1", "previewFileUrl2": "finalFileUrl2", "previewFileUrl3": "finalFileUrl3", ... "previewFileUrln": "finalFileUrln" } } } |
Résultat de la commande (erreur) | { "error": { "code": "disabledCommand", "message": "Command is currently disabled." } } |