forked from public/cordova-plugin-camera
CB-7249 cordova-plugin-camera documentation translation: cordova-plugin-camera
This commit is contained in:
committed by
Anis Kadri
parent
ae22820046
commit
e851960910
+74
-58
@@ -66,32 +66,39 @@
|
||||
* Windows Phone 7 и 8
|
||||
* Windows 8
|
||||
|
||||
### Особенности Amazon Fire OS
|
||||
### Предпочтения (iOS)
|
||||
|
||||
* **CameraUsesGeolocation** (логическое значение, по умолчанию false). Для захвата изображения JPEG, значение true, чтобы получить данные геопозиционирования в заголовке EXIF. Это вызовет запрос на разрешения геолокации, если задано значение true.
|
||||
|
||||
<preference name="CameraUsesGeolocation" value="false" />
|
||||
|
||||
|
||||
### Amazon Fire OS причуды
|
||||
|
||||
Amazon Fire OS используют намерения для запуска активности камеры на устройстве для съемки фотографий, и на устройствах с низким объемам памяти, активность Cordova может быть завершена. В этом случае изображение может не появиться при восстановлении активности Cordova.
|
||||
|
||||
### Особенности Android
|
||||
### Android причуды
|
||||
|
||||
Android использует намерения начать действие камеры на устройстве для захвата изображения, и на телефонах с низкой памяти, могут быть убиты Cordova деятельность. В этом случае изображение не может появиться, когда Кордова активность восстанавливается.
|
||||
|
||||
### Особенности Firefox OS
|
||||
### Firefox OS причуды
|
||||
|
||||
Модуль камеры в настоящее время реализуется с помощью [Веб деятельности][2].
|
||||
|
||||
[2]: https://hacks.mozilla.org/2013/01/introducing-web-activities/
|
||||
|
||||
### Особенности iOS
|
||||
### iOS причуды
|
||||
|
||||
Включая JavaScript `alert()` в любом из обратного вызова функции может вызвать проблемы. Оберните оповещение в `setTimeout()` выбора изображений iOS или пирог полностью закрыть прежде чем отображает оповещения:
|
||||
|
||||
setTimeout(function() {/ / ваши вещи!}, 0);
|
||||
|
||||
|
||||
### Особенности Windows Phone 7
|
||||
### Windows Phone 7 причуды
|
||||
|
||||
Вызов приложения родной камеры, в то время как устройство подключается через Zune не работает и инициирует обратный вызов для ошибки.
|
||||
|
||||
### Особенности Tizen
|
||||
### Причуды Tizen
|
||||
|
||||
Tizen поддерживает только `destinationType` из `Camera.DestinationType.FILE_URI` и `sourceType` из`Camera.PictureSourceType.PHOTOLIBRARY`.
|
||||
|
||||
@@ -145,69 +152,64 @@ Tizen поддерживает только `destinationType` из `Camera.Desti
|
||||
|
||||
### Параметры
|
||||
|
||||
* **quality**: качество сохраняемого изображения, выражается в виде числа в диапазоне от 0 до 100, где 100 является обычно полным изображением без потери качества при сжатии. Значение по умолчанию — 50. *(Число)* (Обратите внимание, что информация о разрешение камеры недоступна.)
|
||||
* **качество**: качество сохраняемого изображения, выражается в виде диапазона 0-100, где 100 является обычно полным разрешением без потери от сжатия файлов. Значение по умолчанию — 50. *(Число)* (Обратите внимание, что информация о разрешение камеры недоступна.)
|
||||
|
||||
* **параметр destinationType**: выберите формат возвращаемого значения. Значение по умолчанию — FILE_URI. Определяется в `navigator.camera.DestinationType` *(число)*
|
||||
|
||||
Camera.DestinationType = {
|
||||
DATA_URL: 0, / / возвращение изображения в base64-кодировке строки
|
||||
FILE_URI: 1, / / возврат файла изображения URI
|
||||
NATIVE_URI: 2 / / возвращение образа собственного URI (например, Библиотека активов: / / на iOS или содержание: / / на андроиде)
|
||||
DATA_URL : 0, // Return image as base64-encoded string
|
||||
FILE_URI : 1, // Return image file URI
|
||||
NATIVE_URI : 2 // Return image native URI (e.g., assets-library:// on iOS or content:// on Android)
|
||||
};
|
||||
|
||||
|
||||
* **тип источника**: установить источник рисунка. По умолчанию используется камера. Определяется в `navigator.camera.PictureSourceType` *(число)*
|
||||
|
||||
Camera.PictureSourceType = {
|
||||
PHOTOLIBRARY: 0,
|
||||
CAMERA: 1,
|
||||
SAVEDPHOTOALBUM: 2
|
||||
PHOTOLIBRARY : 0,
|
||||
CAMERA : 1,
|
||||
SAVEDPHOTOALBUM : 2
|
||||
};
|
||||
|
||||
|
||||
* **allowEdit**: позволит редактирование изображения средствами телефона перед окончательным выбором изображения. *(Логический)*
|
||||
* **allowEdit**: позволяют простое редактирование изображения перед выбором. *(Логическое)*
|
||||
|
||||
* **Тип_шифрования**: выберите возвращенный файл в кодировку. Значение по умолчанию — JPEG. Определяется в `navigator.camera.EncodingType` *(число)*
|
||||
|
||||
Camera.EncodingType = {
|
||||
JPEG: 0, // возвращает изображение в формате JPEG
|
||||
PNG: 1 // возвращает рисунок в формате PNG
|
||||
JPEG : 0, // Return JPEG encoded image
|
||||
PNG : 1 // Return PNG encoded image
|
||||
};
|
||||
|
||||
|
||||
* **targetWidth**: ширина изображения в пикселах к которой необходимо осуществить масштабирование. Это значение должно использоваться совместно с **targetHeight**. Пропорции изображения останутся неизменными. *(Число)*
|
||||
* **targetWidth**: ширина до масштаба изображения в пикселях. Должен использоваться с **targetHeight**. Соотношение остается неизменным. *(Число)*
|
||||
|
||||
* **targetHeight**: высота изображения в пикселах к которой необходимо осуществить масштабирование. Это значение должно использоваться совместно с **targetWidth**. Пропорции изображения останутся неизменными. *(Число)*
|
||||
* **targetHeight**: высота до масштаба изображения в пикселях. Должен использоваться с **targetWidth**. Соотношение остается неизменным. *(Число)*
|
||||
|
||||
* **mediaType**: Установите источник получения изображения, из которого надо выбрать изображение. Работает только если `PictureSourceType` равно `PHOTOLIBRARY` или `SAVEDPHOTOALBUM` . Определено в `nagivator.camera.MediaType` *(число)*
|
||||
* **тип носителя**: задать тип носителя, чтобы выбрать из. Работает только если `PictureSourceType` является `PHOTOLIBRARY` или `SAVEDPHOTOALBUM` . Определяется в `nagivator.camera.MediaType` *(число)*
|
||||
|
||||
Camera.MediaType = {
|
||||
PICTURE: 0, / / разрешить выбор только сохраненных изображений. DEFAULT. Will return format specified via DestinationType
|
||||
PICTURE: 0, // allow selection of still pictures only. ПО УМОЛЧАНИЮ. Will return format specified via DestinationType
|
||||
VIDEO: 1, // allow selection of video only, WILL ALWAYS RETURN FILE_URI
|
||||
ALLMEDIA : 2 // allow selection from all media types
|
||||
};
|
||||
|
||||
|
||||
* **correctOrientation**: вращает изображение, чтобы внести исправления к ориентации устройства во время захвата. *(Логический)*
|
||||
* **correctOrientation**: поворот изображения исправить для ориентации устройства во время захвата. *(Логическое)*
|
||||
|
||||
* **saveToPhotoAlbum**: сохранить изображение в фотоальбом на устройстве после захвата. *(Логический)*
|
||||
* **saveToPhotoAlbum**: сохранить изображение в фотоальбом на устройстве после захвата. *(Логическое)*
|
||||
|
||||
* **popoverOptions**: только для iOS параметры, которые определяют местоположение инструмента в iPad. Определены в`CameraPopoverOptions`.
|
||||
|
||||
* **cameraDirection**: выбрать камеру для использования (передней или задней стороне). Значение по умолчанию — обратно. Определяется в `navigator.camera.Direction` *(число)*
|
||||
|
||||
Camera.Direction = {обратно: 0, / / использовать обратно, стоящих перед камерой фронт: 1 / / использовать фронтальная камера};
|
||||
Camera.Direction = {
|
||||
BACK : 0, // Use the back-facing camera
|
||||
FRONT : 1 // Use the front-facing camera
|
||||
};
|
||||
|
||||
|
||||
### Особенности Amazon Fire OS
|
||||
|
||||
* Любое значение `cameraDirection` возвращает фотографию сделанную задней камерой.
|
||||
|
||||
* Игнорирует `allowEdit` параметр.
|
||||
|
||||
* `Camera.PictureSourceType.PHOTOLIBRARY`и `Camera.PictureSourceType.SAVEDPHOTOALBUM` оба отображения же фотоальбом.
|
||||
|
||||
### Android причуды
|
||||
### Amazon Fire OS причуды
|
||||
|
||||
* Любой `cameraDirection` значение результатов на задней стороне фотографии.
|
||||
|
||||
@@ -215,7 +217,15 @@ Tizen поддерживает только `destinationType` из `Camera.Desti
|
||||
|
||||
* Оба параметра `Camera.PictureSourceType.PHOTOLIBRARY` и `Camera.PictureSourceType.SAVEDPHOTOALBUM` отображают один и тот же фотоальбом.
|
||||
|
||||
### Особенности BlackBerry 10
|
||||
### Android причуды
|
||||
|
||||
* Любой `cameraDirection` значение результатов на задней стороне фотографии.
|
||||
|
||||
* Игнорирует `allowEdit` параметр.
|
||||
|
||||
* `Camera.PictureSourceType.PHOTOLIBRARY`и `Camera.PictureSourceType.SAVEDPHOTOALBUM` как отображение же фотоальбом.
|
||||
|
||||
### Причуды blackBerry 10
|
||||
|
||||
* Игнорирует `quality` параметр.
|
||||
|
||||
@@ -231,41 +241,41 @@ Tizen поддерживает только `destinationType` из `Camera.Desti
|
||||
|
||||
* Игнорирует `quality` параметр.
|
||||
|
||||
* Значение `Camera.DestinationType` игнорируется и равно `1` (URI для файла изображения)
|
||||
* `Camera.DestinationType`игнорируется и равен `1` (URI файла изображения)
|
||||
|
||||
* Игнорирует параметр `allowEdit`.
|
||||
* Игнорирует `allowEdit` параметр.
|
||||
|
||||
* Игнорирует параметр `PictureSourceType` (пользователь выбирает его в диалоговом окне)
|
||||
* Игнорирует `PictureSourceType` параметр (пользователь выбирает его в диалоговом окне)
|
||||
|
||||
* Игнорирует параметр `encodingType`
|
||||
* Игнорирует`encodingType`
|
||||
|
||||
* Игнорирует `targetWidth` и `targetHeight`
|
||||
* Игнорирует `targetWidth` и`targetHeight`
|
||||
|
||||
* `Camera.MediaType` не поддерживается.
|
||||
* `Camera.MediaType`не поддерживается.
|
||||
|
||||
* Игнорирует параметр `correctOrientation`.
|
||||
* Игнорирует `correctOrientation` параметр.
|
||||
|
||||
* Игнорирует параметр `cameraDirection`.
|
||||
* Игнорирует `cameraDirection` параметр.
|
||||
|
||||
### Особенности iOS
|
||||
### iOS причуды
|
||||
|
||||
* Установите `quality` ниже 50, для того чтобы избежать ошибок памяти на некоторых устройствах.
|
||||
* Задать `quality` ниже 50, чтобы избежать ошибок памяти на некоторых устройствах.
|
||||
|
||||
* При использовании `destinationType.FILE_URI` , фотографии сохраняются во временном каталоге приложения. Содержимое приложения временного каталога удаляется при завершении приложения.
|
||||
|
||||
### Особенности Tizen
|
||||
### Причуды Tizen
|
||||
|
||||
* options, не поддерживается
|
||||
* параметры, не поддерживаемые
|
||||
|
||||
* всегда возвращает URI файла
|
||||
|
||||
### Windows Phone 7 и 8 причуды
|
||||
|
||||
* Игнорирует параметр `allowEdit`.
|
||||
* Игнорирует `allowEdit` параметр.
|
||||
|
||||
* Игнорирует параметр `correctOrientation`.
|
||||
* Игнорирует `correctOrientation` параметр.
|
||||
|
||||
* Игнорирует параметр `cameraDirection`.
|
||||
* Игнорирует `cameraDirection` параметр.
|
||||
|
||||
* Игнорирует `saveToPhotoAlbum` параметр. Важно: Все изображения, снятые камерой wp7/8 cordova API всегда копируются в рулон камеры телефона. В зависимости от параметров пользователя это также может означать, что изображение автоматически загружены на их OneDrive. Потенциально это может означать, что этот образ доступен для более широкой аудитории, чем ваше приложение предназначено. Если этот блокатор для вашего приложения, вам нужно будет осуществить CameraCaptureTask, как описано на сайте msdn: <http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh394006.aspx> вы можете также комментарий или вверх голосование связанный с этим вопрос [отслеживания][3]
|
||||
|
||||
@@ -284,7 +294,7 @@ Tizen поддерживает только `destinationType` из `Camera.Desti
|
||||
|
||||
### Параметры
|
||||
|
||||
* **message**: сообщение об ошибке предоставляемое платформой устройства. *(Строка)*
|
||||
* **сообщение**: сообщение обеспечивается устройства машинного кода. *(Строка)*
|
||||
|
||||
## cameraSuccess
|
||||
|
||||
@@ -297,7 +307,7 @@ onSuccess обратного вызова функция, которая пре
|
||||
|
||||
### Параметры
|
||||
|
||||
* **imageData**: Данные изображения в Base64 кодировке, *или* URI, в зависимости от применяемых параметров `cameraOptions`. *(Строка)*
|
||||
* **imageData**: Base64 кодирование изображения данных, *или* файла изображения URI, в зависимости от `cameraOptions` в силу. *(Строка)*
|
||||
|
||||
### Пример
|
||||
|
||||
@@ -315,7 +325,7 @@ onSuccess обратного вызова функция, которая пре
|
||||
|
||||
### Методы
|
||||
|
||||
* **setPosition**: Задайте положение инструмента выбора изображения.
|
||||
* **setPosition**: установить положение инструмента.
|
||||
|
||||
### Поддерживаемые платформы
|
||||
|
||||
@@ -327,7 +337,7 @@ onSuccess обратного вызова функция, которая пре
|
||||
|
||||
**Параметры**:
|
||||
|
||||
* `cameraPopoverOptions`: Объект `CameraPopoverOptions`, определяющий новое положение
|
||||
* `cameraPopoverOptions`: `CameraPopoverOptions` , укажите новое положение
|
||||
|
||||
### Пример
|
||||
|
||||
@@ -353,17 +363,23 @@ onSuccess обратного вызова функция, которая пре
|
||||
|
||||
### CameraPopoverOptions
|
||||
|
||||
* **x**: x координата в пикселях элемента экрана, на котором закрепить инструмента. *(Число)*
|
||||
* **x**: x координата пикселя элемента экрана, на который для закрепления инструмента. *(Число)*
|
||||
|
||||
* **x**: y координата в пикселях элемента экрана, на котором закрепить инструмента. *(Число)*
|
||||
* **y**: y координата пикселя элемента экрана, на который для закрепления инструмента. *(Число)*
|
||||
|
||||
* **width**: ширина в пикселях элемента экрана, на котором закрепить инструмент выбора изображения. *(Число)*
|
||||
* **Ширина**: ширина в пикселях экрана элемента, на который для закрепления инструмента. *(Число)*
|
||||
|
||||
* **height**: высота в пикселях элемента экрана, на котором закрепить инструмент выбора изображения. *(Число)*
|
||||
* **рост**: высота в пикселях экрана элемента, на который для закрепления инструмента. *(Число)*
|
||||
|
||||
* **arrowDir**: Направление, куда должна указывать стрелка на инструменте. Определено в `Camera.PopoverArrowDirection` *(число)*
|
||||
* **arrowDir**: стрелка на пирог следует указывать направление. Определяется в `Camera.PopoverArrowDirection` *(число)*
|
||||
|
||||
Camera.PopoverArrowDirection = {ARROW_UP: 1, / / матчи iOS UIPopoverArrowDirection константы ARROW_DOWN: 2, ARROW_LEFT: 4, ARROW_RIGHT: 8, ARROW_ANY: 15};
|
||||
Camera.PopoverArrowDirection = {
|
||||
ARROW_UP : 1, // matches iOS UIPopoverArrowDirection constants
|
||||
ARROW_DOWN : 2,
|
||||
ARROW_LEFT : 4,
|
||||
ARROW_RIGHT : 8,
|
||||
ARROW_ANY : 15
|
||||
};
|
||||
|
||||
|
||||
Обратите внимание, что размер инструмента может измениться для регулировки в направлении стрелки и ориентации экрана. Убедитесь в том, что для учета изменения ориентации при указании расположения элемента привязки.
|
||||
|
||||
Reference in New Issue
Block a user