camera.processPicture

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

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, et previewToFinalFileUrls 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 utiliser listFiles 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 valeur previewToFinalFileUrls 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."
    }
}