zhaidi/cordova-plugin-camera-dev
1
0
Fork 0
forked from public/cordova-plugin-camera
Code Pull Requests Activity

CB-7700 cordova-plugin-camera documentation translation: cordova-plugin-camera

Browse Source
This commit is contained in:
Victor Sosa
2014-10-02 18:10:17 -05:00
parent 7413c1bcb2
commit 53e42fc97b
4 changed files with 165 additions and 165 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/ru/index.md
+75 -75
View File
@@ -57,7 +57,7 @@
### Поддерживаемые платформы
* Amazon Fire ОС
* Amazon Fire OS
* Android
* BlackBerry 10
* Обозреватель
@@ -74,42 +74,42 @@
<preference name="CameraUsesGeolocation" value="false" />
### Amazon Fire OS причуды
### Особенности Amazon Fire OS
Amazon Fire OS используют намерения для запуска активности камеры на устройстве для съемки фотографий, и на устройствах с низким объемам памяти, активность Cordova может быть завершена. В этом случае изображение может не появиться при восстановлении активности Cordova.
### Android причуды
### Особенности Android
Android использует намерения начать действие камеры на устройстве для захвата изображения, и на телефонах с низкой памяти, могут быть убиты Cordova деятельность. В этом случае изображение не может появиться, когда Кордова активность восстанавливается.
Android используют намерения для запуска активности камеры на устройстве для съемки фотографий, и на устройствах с низким объемам памяти, активность Cordova может быть завершена. В этом случае изображение может не появиться при восстановлении активности Cordova.
### Браузер причуды
Может возвращать только фотографии как изображения в кодировке base64.
### Firefox OS причуды
### Особенности Firefox OS
Модуль камеры в настоящее время реализуется с помощью [Веб деятельности][2].
Плагин Camera на данный момент реализован с использованием [Web Activities][2].
[2]: https://hacks.mozilla.org/2013/01/introducing-web-activities/
### iOS причуды
### Особенности iOS
Включая JavaScript `alert()` в любом из обратного вызова функции может вызвать проблемы. Оберните оповещение в `setTimeout()` выбора изображений iOS или пирог полностью закрыть прежде чем отображает оповещения:
Включение функции JavaScript `alert()` в любой из функций обратного вызова функции может вызвать проблемы. Оберните вызов alert в `setTimeout()` для позволения окну выбора изображений iOS полностью закрыться перед отображение оповещения:
setTimeout(function() {/ / ваши вещи!}, 0);
### Windows Phone 7 причуды
### Особенности Windows Phone 7
Вызов приложения родной камеры, в то время как устройство подключается через Zune не работает и инициирует обратный вызов для ошибки.
Вызов встроенного приложения камеры, в то время как устройство подключено к Zune не работает, и инициирует обратный вызов для ошибки.
### Причуды Tizen
### Особенности Tizen
Tizen поддерживает только `destinationType` из `Camera.DestinationType.FILE_URI` и `sourceType` из`Camera.PictureSourceType.PHOTOLIBRARY`.
Tizen поддерживает только значение `destinationType` равное `Camera.DestinationType.FILE_URI` и значение `sourceType` равное `Camera.PictureSourceType.PHOTOLIBRARY`.
### Пример
Сфотографироваться и получить его в виде изображения в кодировке base64:
Сделайте фотографию и получите его как изображение в base64-кодировке:
navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
destinationType: Camera.DestinationType.DATA_URL
@@ -125,7 +125,7 @@ Tizen поддерживает только `destinationType` из `Camera.Desti
}
Сфотографироваться и получить расположение файла изображения:
Сделайте фотографию и получить расположение файла с изображением:
navigator.camera.getPicture(onSuccess, onFail, { quality: 50,
destinationType: Camera.DestinationType.FILE_URI });
@@ -157,50 +157,50 @@ Tizen поддерживает только `destinationType` из `Camera.Desti
### Параметры
* **качество**: качество сохраняемого изображения, выражается в виде диапазона 0-100, где 100 является обычно полным разрешением без потери от сжатия файлов. Значение по умолчанию — 50. *(Число)* (Обратите внимание, что информация о разрешение камеры недоступна.)
* **quality**: качество сохраняемого изображения, выражается в виде числа в диапазоне от 0 до 100, где 100 является обычно полным изображением без потери качества при сжатии. Значение по умолчанию — 50. *(Число)* (Обратите внимание, что информация о разрешении камеры недоступна.)
* **параметр destinationType**: выберите формат возвращаемого значения. Значение по умолчанию — FILE_URI. Определяется в `navigator.camera.DestinationType` *(число)*
Camera.DestinationType = {
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)
DATA_URL: 0, / / возвращение изображения в base64-кодировке строки
FILE_URI: 1, / / возврат файла изображения URI
NATIVE_URI: 2 / / возвращение образа собственного URI (например, Библиотека активов: / / на iOS или содержание: / / на андроиде)
};
* **тип источника**: установить источник рисунка. По умолчанию используется камера. Определяется в `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, // Return JPEG encoded image
PNG : 1 // Return PNG encoded image
JPEG: 0, // возвращает изображение в формате JPEG
PNG: 1 // возвращает рисунок в формате PNG
};
* **targetWidth**: ширина до масштаба изображения в пикселях. Должен использоваться с **targetHeight**. Соотношение остается неизменным. *(Число)*
* **targetWidth**: ширина изображения в пикселах к которой необходимо осуществить масштабирование. Это значение должно использоваться совместно с **targetHeight**. Пропорции изображения останутся неизменными. *(Число)*
* **targetHeight**: высота до масштаба изображения в пикселях. Должен использоваться с **targetWidth**. Соотношение остается неизменным. *(Число)*
* **targetHeight**: высота изображения в пикселах к которой необходимо осуществить масштабирование. Это значение должно использоваться совместно с **targetWidth**. Пропорции изображения останутся неизменными. *(Число)*
* **тип носителя**: задать тип носителя, чтобы выбрать из. Работает только если `PictureSourceType` является `PHOTOLIBRARY` или `SAVEDPHOTOALBUM` . Определяется в `nagivator.camera.MediaType` *(число)*
* **тип носителя**: Установите источник получения изображения, из которого надо выбрать изображение. Работает только если `PictureSourceType` равно `PHOTOLIBRARY` или `SAVEDPHOTOALBUM` . Определяется в `nagivator.camera.MediaType` *(число)*
Camera.MediaType = {
PICTURE: 0, // allow selection of still pictures only. ПО УМОЛЧАНИЮ. Will return format specified via DestinationType
PICTURE: 0, / / разрешить выбор только сохраненных изображений. DEFAULT. 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**: сохранить изображение в фотоальбом на устройстве после захвата. *(Логическое)*
@@ -214,83 +214,83 @@ Tizen поддерживает только `destinationType` из `Camera.Desti
};
### Amazon Fire OS причуды
### Особенности Amazon Fire OS
* Любой `cameraDirection` значение результатов на задней стороне фотографии.
* Любое значение `cameraDirection` возвращает фотографию сделанную задней камерой.
* Игнорирует параметр `allowEdit`.
* Оба параметра `Camera.PictureSourceType.PHOTOLIBRARY` и `Camera.PictureSourceType.SAVEDPHOTOALBUM` отображают один и тот же фотоальбом.
### Android причуды
### Особенности Android
* Любой `cameraDirection` значение результатов на задней стороне фотографии.
* Любое значение `cameraDirection` возвращает фотографию сделанную задней камерой.
* Игнорирует `allowEdit` параметр.
* Игнорирует параметр `allowEdit`.
* `Camera.PictureSourceType.PHOTOLIBRARY`и `Camera.PictureSourceType.SAVEDPHOTOALBUM` как отображение же фотоальбом.
* Оба параметра `Camera.PictureSourceType.PHOTOLIBRARY` и `Camera.PictureSourceType.SAVEDPHOTOALBUM` отображают один и тот же фотоальбом.
### Причуды blackBerry 10
### Особенности BlackBerry 10
* Игнорирует `quality` параметр.
* Игнорирует `allowEdit` параметр.
* Игнорирует параметр `allowEdit`.
* `Camera.MediaType`не поддерживается.
* `Camera.MediaType` не поддерживается.
* Игнорирует `correctOrientation` параметр.
* Игнорирует параметр `correctOrientation`.
* Игнорирует `cameraDirection` параметр.
* Игнорирует параметр `cameraDirection`.
### Firefox OS причуды
### Особенности Firefox OS
* Игнорирует `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 причуды
### Особенности 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]
* Игнорирует `mediaType` свойство `cameraOptions` как Windows Phone SDK не обеспечивает способ выбора видео от PHOTOLIBRARY.
* Игнорирует свойство `mediaType` объекта `cameraOptions` так как Windows Phone SDK не предоставляет способ выбрать видео из PHOTOLIBRARY.
[3]: https://issues.apache.org/jira/browse/CB-2083
## CameraError
Функция обратного вызова onError, который предоставляет сообщение об ошибке.
Функция обратного вызова вызываемая в случае возникновения ошибки.
function(message) {
// Show a helpful message
@@ -299,11 +299,11 @@ Tizen поддерживает только `destinationType` из `Camera.Desti
### Параметры
* **сообщение**: сообщение обеспечивается устройства машинного кода. *(Строка)*
* **сообщение**: сообщение об ошибке предоставляемое платформой устройства. *(Строка)*
## cameraSuccess
onSuccess обратного вызова функция, которая предоставляет данные изображения.
Функция обратного вызова onSuccess, получающая данные изображения.
function(imageData) {
// Do something with the image
@@ -312,7 +312,7 @@ onSuccess обратного вызова функция, которая пре
### Параметры
* **imageData**: Base64 кодирование изображения данных, *или* файла изображения URI, в зависимости от `cameraOptions` в силу. *(Строка)*
* **imageData**: Данные изображения в Base64 кодировке, *или* URI, в зависимости от применяемых параметров `cameraOptions`. *(Строка)*
### Пример
@@ -326,11 +326,11 @@ onSuccess обратного вызова функция, которая пре
## CameraPopoverHandle
Дескриптор диалогового окна инструмента, созданного`navigator.camera.getPicture`.
Дескриптор диалогового окна инструмента, созданный `navigator.camera.getPicture`.
### Методы
* **setPosition**: установить положение инструмента.
* **setPosition**: Задайте положение инструмента выбора изображения.
### Поддерживаемые платформы
@@ -338,11 +338,11 @@ onSuccess обратного вызова функция, которая пре
### setPosition
Задайте положение инструмента.
Устанавливает положение инструмента выбора изображения.
**Параметры**:
* `cameraPopoverOptions`: `CameraPopoverOptions` , укажите новое положение
* `cameraPopoverOptions`: Объект `CameraPopoverOptions`, определяющий новое положение
### Пример
@@ -361,22 +361,22 @@ onSuccess обратного вызова функция, которая пре
## CameraPopoverOptions
только для iOS параметры, указывающие якорь элемент расположение и стрелкой направление инструмента при выборе изображений из библиотеки iPad или альбома.
Параметры только для iOS, которые определяют расположение элемента привязки и направление стрелки инструмента при выборе изображений из библиотеки изображений iPad или альбома.
{x: 0, y: 32, ширина: 320, высота: 480, arrowDir: Camera.PopoverArrowDirection.ARROW_ANY};
### CameraPopoverOptions
* **x**: x координата пикселя элемента экрана, на который для закрепления инструмента. *(Число)*
* **x**: x координата в пикселях элемента экрана, на котором закрепить инструмента. *(Число)*
* **y**: y координата пикселя элемента экрана, на который для закрепления инструмента. *(Число)*
* **x**: y координата в пикселях элемента экрана, на котором закрепить инструмента. *(Число)*
* **Ширина**: ширина в пикселях экрана элемента, на который для закрепления инструмента. *(Число)*
* **width**: ширина в пикселях элемента экрана, на котором закрепить инструмент выбора изображения. *(Число)*
* **рост**: высота в пикселях экрана элемента, на который для закрепления инструмента. *(Число)*
* **height**: высота в пикселях элемента экрана, на котором закрепить инструмент выбора изображения. *(Число)*
* **arrowDir**: стрелка на пирог следует указывать направление. Определяется в `Camera.PopoverArrowDirection` *(число)*
* **arrowDir**: Направление, куда должна указывать стрелка на инструменте. Определено в `Camera.PopoverArrowDirection` *(число)*
Camera.PopoverArrowDirection = {
ARROW_UP : 1, // matches iOS UIPopoverArrowDirection constants
@@ -387,18 +387,18 @@ onSuccess обратного вызова функция, которая пре
};
Обратите внимание, что размер инструмента может измениться для регулировки в направлении стрелки и ориентации экрана. Убедитесь в том, что для учета изменения ориентации при указании расположения элемента привязки.
Обратите внимание, что размер инструмента может изменяться для корректировки в зависимости направлении стрелки и ориентации экрана. Убедитесь, что учитываете возможные изменения ориентации при указании расположения элемента привязки.
## navigator.camera.cleanup
Удаляет промежуточные фотографии, снятые на камеру от временного хранения.
Удаляет промежуточные фотографии, сделанные камерой из временного хранилища.
navigator.camera.cleanup( cameraSuccess, cameraError );
### Описание
Удаляет промежуточные файлы изображений, которые хранятся в временного хранения после вызова метода `camera.getPicture` . Применяется только тогда, когда значение `Camera.sourceType` равно `Camera.PictureSourceType.CAMERA` и `Camera.destinationType` равно`Camera.DestinationType.FILE_URI`.
Удаляет промежуточные файлы изображений, которые хранятся во временном хранилище после вызова метода `camera.getPicture` . Применяется только тогда, когда значение `Camera.sourceType` равно `Camera.PictureSourceType.CAMERA` и `Camera.destinationType` равняется `Camera.DestinationType.FILE_URI`.
### Поддерживаемые платформы