camera.takePicture

Permet de capturer une image équirectangulaire, en enregistrant les coordonnées de latitude et de longitude au format EXIF (si votre caméra est équipée de son propre GPS ou si le GPS est activé sur les téléphones mobiles connectés). Si nécessaire, appelez camera.setOptions avant cet appel de commande. Cette commande a été modifiée au niveau de l'API 2.

Paramètres

  • sessionId:identifiant de session unique obtenu à l'aide de la commande camera.startSession . Ce champ a été abandonné dans le niveau d'API 2.

Résultats

  • Niveau d'API 1
    • fileUri : URI de l'image capturée. Les fabricants décident d'utiliser des URI absolus ou relatifs. Par exemple, http://android.com/robots.txt est un URI absolu, tandis que le fichier robots.txt est un URI relatif. Les clients peuvent le considérer comme un identifiant opaque.
  • Niveau d'API 2
    • fileUrl : URL absolue de l'image capturée, permettant de la télécharger directement à partir du serveur HTTP de l'appareil photo. Notez que cette commande ne renvoie pas immédiatement fileUrl, car la capture (y compris l'assemblage dans la caméra) prend généralement un certain temps (varie 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 fileUrl est le résultat renvoyé à la fin de la commande. Lorsque delayProcessing est défini sur"true", il s'agit de l'URL absolue de l'image d'aperçu, qui peut être utilisée comme entrée dans processPicture pour traiter l'image. Sinon, il s'agit de l'URL absolue de l'image finale traitée.

Erreurs

  • missingParameter:il manque sessionId. Ce code d'erreur a été abandonné dans le niveau d'API 2.
  • invalidParameterName:le nom du paramètre n'est pas reconnu (par exemple, sessionId n'est pas reconnu au niveau d'API 2).
  • invalidParameterValue : Le nom du paramètre d'entrée est reconnu, mais sa valeur n'est pas valide. Par exemple, la valeur sessionId n'existe pas, n'est plus active ou son type de données est incorrect. Ce code d'erreur a été abandonné dans le niveau d'API 2.
  • disabledCommand:la commande est actuellement désactivée. Par exemple, la caméra est en mode de prise de vue vidéo. Ce code d'erreur a été ajouté au niveau d'API 2.

E/S de commande

Entrée de commande (niveau d'API 1)
{
    "parameters": {
        "sessionId": "12ABC3"
    }
}
Résultat de la commande (niveau d'API 1)
{
    "results": {
        "fileUri": "file URI"
    }
}
Résultat de la commande (erreur) (niveau d'API 1)
{
    "error": {
        "code": "invalidParameterValue",
        "message": "Parameter sessionId doesn't exist."
    }
}
Commande d'entrée (niveau d'API 2)
none
Résultat de la commande (niveau d'API 2)
{
    "results": {
        "fileUrl": "Absolute file URL"
    }
}
Résultat de la commande (erreur) (niveau d'API 2)
{
    "error": {
        "code": "disabledCommand",
        "message": "Command is currently disabled."
    }
}