camera.uploadFile
Приложение передает эту команду камере, чтобы инициировать загрузку изображения или видео непосредственно с камеры на сервер. Камера должна использовать включенные параметры для формирования запроса HTTP POST. Файл, который нужно загрузить, указан в fileUrl
, и его следует загрузить в uploadUrl
с правильной авторизацией, указанной в accessToken
. Эта команда была добавлена на уровне API 2.1 и относится к прямой загрузке.
Это можно сделать из командной строки компьютера следующим образом:
curl -X post -H "Authorization: Bearer accessToken" -T fileUrl uploadUrl
Параметры
-
fileUrl:
URL-адрес файла, который будет загружен на сервер. -
uploadUrl:
строка, указывающая, куда загрузить файл. -
accessToken:
токен, включающий информацию аутентификации для загрузки. Приложение получает его и отправляет на камеру.
Результаты
- Эта команда не возвращает результата.
Ошибки
-
missingParameter:
отсутствует какой-либо параметр, например fileUrl
. -
invalidParameterName:
одно или несколько имен входных параметров не распознаны. -
invalidParameterValue:
имена входных параметров распознаются, но одно или несколько переданных значений недействительны. Например, файл, указанный в fileUrl
не существует. -
uploadError:
Не удалось загрузить камеру.
Командный ввод/вывод | |
---|
Ввод команды | { "parameters": { "fileUrl": "URL of the file.", "uploadUrl": "A string representing where to upload the file.", "accessToken": "A token containing the authentication information." } } |
Вывод команды | none |
Вывод команды (ошибка) | { "error": { "code": "uploadError", "message": "Camera failed to upload the file." } } |
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2024-11-08 UTC.
[null,null,["Последнее обновление: 2024-11-08 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"]]