traiter des images qui ont déjà été capturées, mais qui n'ont pas encore été 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 pour 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 souhaitez traiter toutes les images non traitées dans la caméra, il s'agit de "[all]".
Cette colonne ne peut pas être vide. Si l'appareil photo ne parvient pas à traiter une image, il ne répond pas avec erreur. Il doit ignorer cette URL et continuer avec d'autres, et le cas extrême peut être
previewToFinalFileUrls
est renvoyé en tant qu'objet JSONObject vide.
Résultats
- previewToFinalFileUrls:un objet JSON comportant des paires &clé; clé, valeur, "> JSON, où chaque clé correspond à l'URL absolue de l'image d'aperçu et chaque clé correspond à l'image finale traitée correspondante. Vous pouvez l'utiliser pour télécharger directement l'image à partir de celle-ci. Notez 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 de la caméra) 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, etpreviewToFinalFileUrls
est le résultat renvoyé à la fin de la commande. Si la connexion à la caméra est perdue avant la fin de la commande, le client peut utiliserlistFiles
pour obtenir les URL des images finales lorsqu'il est à nouveau connecté à la caméra, ou envoyer une autre commande processPicture, qui doit renvoyer la valeurpreviewToFinalFileUrls
immédiatement si les images ont déjà été traitées avant la reconnexion.</key,>
Erreurs
- disabledCommand : si le traitement par retard n'est pas compatible.
- 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 de commande | |
---|---|
Saisie 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." } } |