appareil.uploadFile
L'application envoie cette commande à la caméra pour lancer l'importation d'une image ou
vidéo directement de la caméra à un serveur. La caméra doit utiliser les
pour former une requête HTTP POST. Le fichier à importer est spécifié par
fileUrl
et doit être importé dans uploadUrl
avec le bon code
spécifiée par accessToken
. Cette commande a été ajoutée au niveau de l'API
2.1 et est pertinent pour
Importation directe
On pourrait le faire à partir d'une ligne de commande d'ordinateur comme:
curl -X post -H "Authorization: Bearer accessToken" -T fileUrl uploadUrl
Paramètres
fileUrl:
URL du fichier à importer sur le serveur.
uploadUrl:
Chaîne représentant l'emplacement d'importation du fichier.
accessToken:
: jeton contenant les informations d'authentification pour
mettre en ligne. Elles sont obtenues par l'application et envoyées à l'appareil photo.
Résultats
- Cette commande ne renvoie aucun résultat.
Erreurs
missingParameter:
Il manque un paramètre (fileUrl
, par exemple).
invalidParameterName:
Un ou plusieurs noms de paramètres d'entrée sont
non reconnues.
invalidParameterValue:
Noms des paramètres d'entrée reconnus
mais une ou plusieurs valeurs transmises ne sont pas valides. Par exemple, le fichier
spécifié par
fileUrl
n'existe pas.
uploadError:
Échec de l'importation de la caméra.
E/S de commande |
|
Saisie de la commande |
{ "parameters": { "fileUrl": "URL of the file.", "uploadUrl": "A string representing where to upload the file.", "accessToken": "A token containing the authentication information." } } |
Résultat de la commande |
none |
Résultat de la commande (erreur) |
{ "error": { "code": "uploadError", "message": "Camera failed to upload the file." } } |
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2024/08/21 (UTC).
[null,null,["Dernière mise à jour le 2024/08/21 (UTC)."],[[["This command, available in API level 2.1 and later, allows apps to instruct the camera to directly upload images or videos to a server."],["The camera uses provided parameters (`fileUrl`, `uploadUrl`, `accessToken`) to form and send an HTTP POST request to the specified server."],["Direct Upload requires obtaining an access token and providing the file's URL and the server's upload URL within the command parameters."],["While the command itself returns no result, potential errors during the upload process can be indicated by specific error codes like `uploadError` or `invalidParameterValue`."]]],["The app directs the camera to upload a file to a server using an HTTP POST request. Key parameters include `fileUrl` (the file's location), `uploadUrl` (the destination), and `accessToken` (authorization token). The camera utilizes these parameters to perform the upload. No direct result is returned upon command execution, but error messages such as `missingParameter`, `invalidParameterValue` or `uploadError` will be returned if the command is not correctly executed. This feature was introduced in API level 2.1.\n"]]