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, etfileUrl
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, permettant de la télécharger directement à partir du serveur HTTP de l'appareil photo. Notez que cette commande ne renvoie pas immédiatement
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." } } |