Capture une image équirectangulaire, en enregistrant les coordonnées de latitude et de longitude dans l'affichage EXIF (si votre appareil photo dispose de son propre GPS ou GPS 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 d'API 2.
Paramètres
- sessionId::identifiant de session unique obtenu à partir de la commande
camera.startSession
. Ce champ a été abandonné au 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 et "robots.txt" un URI relatif. Les clients peuvent traiter cet identifiant comme un identifiant opaque.
- Niveau d'API 2
- fileUrl:URL absolue de l'image capturée, qui peut être utilisée pour 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 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.fileUrl
est le résultat renvoyé à la fin de la commande. LorsquedelayProcessing
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.
- fileUrl:URL absolue de l'image capturée, qui peut être utilisée pour la télécharger directement à partir du serveur HTTP de l'appareil photo. Notez que cette commande ne renvoie pas immédiatement
Erreurs
- missingParameter:l'attribut
sessionId
est manquant. Ce code d'erreur a été abandonné au niveau d'API 2. - invalidParameterName:nom du paramètre non 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,
sessionId
n'existe pas, n'est plus actif ou son type de données est incorrect. Ce code d'erreur a été abandonné au 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 des commandes | |
---|---|
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." } } |
Entrée de commande (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." } } |