mirror of
https://github.com/apache/cordova-plugin-camera.git
synced 2025-01-19 03:42:52 +08:00
Remove deprecated platforms from docs (#394)
This commit is contained in:
parent
60e779559e
commit
7ddb3dfbbe
84
README.md
84
README.md
@ -168,14 +168,10 @@ than `DATA_URL`.
|
|||||||
__Supported Platforms__
|
__Supported Platforms__
|
||||||
|
|
||||||
- Android
|
- Android
|
||||||
- BlackBerry
|
|
||||||
- Browser
|
- Browser
|
||||||
- Firefox
|
|
||||||
- FireOS
|
|
||||||
- iOS
|
- iOS
|
||||||
- Windows
|
- Windows
|
||||||
- WP8
|
- OSX
|
||||||
- Ubuntu
|
|
||||||
|
|
||||||
More examples [here](#camera-getPicture-examples). Quirks [here](#camera-getPicture-quirks).
|
More examples [here](#camera-getPicture-examples). Quirks [here](#camera-getPicture-quirks).
|
||||||
|
|
||||||
@ -460,12 +456,6 @@ Take a photo and retrieve it as a Base64-encoded image:
|
|||||||
|
|
||||||
<preference name="CameraUsesGeolocation" value="false" />
|
<preference name="CameraUsesGeolocation" value="false" />
|
||||||
|
|
||||||
#### Amazon Fire OS Quirks <a name="camera-getPicture-quirks"></a>
|
|
||||||
|
|
||||||
Amazon Fire OS uses intents to launch the camera activity on the device to capture
|
|
||||||
images, and on phones with low memory, the Cordova activity may be killed. In this
|
|
||||||
scenario, the image may not appear when the Cordova activity is restored.
|
|
||||||
|
|
||||||
#### Android Quirks
|
#### Android Quirks
|
||||||
|
|
||||||
Android uses intents to launch the camera activity on the device to capture
|
Android uses intents to launch the camera activity on the device to capture
|
||||||
@ -481,10 +471,6 @@ successful.
|
|||||||
|
|
||||||
Can only return photos as Base64-encoded image.
|
Can only return photos as Base64-encoded image.
|
||||||
|
|
||||||
#### Firefox OS Quirks
|
|
||||||
|
|
||||||
Camera plugin is currently implemented using [Web Activities][web_activities].
|
|
||||||
|
|
||||||
#### iOS Quirks
|
#### iOS Quirks
|
||||||
|
|
||||||
Including a JavaScript `alert()` in either of the callback functions
|
Including a JavaScript `alert()` in either of the callback functions
|
||||||
@ -511,23 +497,8 @@ To avoid this we suggest using SPA pattern or call `camera.getPicture` only from
|
|||||||
|
|
||||||
More information about Windows Phone 8.1 picker APIs is here: [How to continue your Windows Phone app after calling a file picker](https://msdn.microsoft.com/en-us/library/windows/apps/dn720490.aspx)
|
More information about Windows Phone 8.1 picker APIs is here: [How to continue your Windows Phone app after calling a file picker](https://msdn.microsoft.com/en-us/library/windows/apps/dn720490.aspx)
|
||||||
|
|
||||||
#### Tizen Quirks
|
|
||||||
|
|
||||||
Tizen only supports a `destinationType` of
|
|
||||||
`Camera.DestinationType.FILE_URI` and a `sourceType` of
|
|
||||||
`Camera.PictureSourceType.PHOTOLIBRARY`.
|
|
||||||
|
|
||||||
|
|
||||||
## `CameraOptions` Errata <a name="CameraOptions-quirks"></a>
|
## `CameraOptions` Errata <a name="CameraOptions-quirks"></a>
|
||||||
|
|
||||||
#### Amazon Fire OS Quirks
|
|
||||||
|
|
||||||
- Any `cameraDirection` value results in a back-facing photo.
|
|
||||||
|
|
||||||
- Ignores the `allowEdit` parameter.
|
|
||||||
|
|
||||||
- `Camera.PictureSourceType.PHOTOLIBRARY` and `Camera.PictureSourceType.SAVEDPHOTOALBUM` both display the same photo album.
|
|
||||||
|
|
||||||
#### Android Quirks
|
#### Android Quirks
|
||||||
|
|
||||||
- Any `cameraDirection` value results in a back-facing photo. (= You can only use the back camera)
|
- Any `cameraDirection` value results in a back-facing photo. (= You can only use the back camera)
|
||||||
@ -538,38 +509,6 @@ Tizen only supports a `destinationType` of
|
|||||||
|
|
||||||
- Ignores the `encodingType` parameter if the image is unedited (i.e. `quality` is 100, `correctOrientation` is false, and no `targetHeight` or `targetWidth` are specified). The `CAMERA` source will always return the JPEG file given by the native camera and the `PHOTOLIBRARY` and `SAVEDPHOTOALBUM` sources will return the selected file in its existing encoding.
|
- Ignores the `encodingType` parameter if the image is unedited (i.e. `quality` is 100, `correctOrientation` is false, and no `targetHeight` or `targetWidth` are specified). The `CAMERA` source will always return the JPEG file given by the native camera and the `PHOTOLIBRARY` and `SAVEDPHOTOALBUM` sources will return the selected file in its existing encoding.
|
||||||
|
|
||||||
#### BlackBerry 10 Quirks
|
|
||||||
|
|
||||||
- Ignores the `quality` parameter.
|
|
||||||
|
|
||||||
- Ignores the `allowEdit` parameter.
|
|
||||||
|
|
||||||
- `Camera.MediaType` is not supported.
|
|
||||||
|
|
||||||
- Ignores the `correctOrientation` parameter.
|
|
||||||
|
|
||||||
- Ignores the `cameraDirection` parameter.
|
|
||||||
|
|
||||||
#### Firefox OS Quirks
|
|
||||||
|
|
||||||
- Ignores the `quality` parameter.
|
|
||||||
|
|
||||||
- `Camera.DestinationType` is ignored and equals `1` (image file URI)
|
|
||||||
|
|
||||||
- Ignores the `allowEdit` parameter.
|
|
||||||
|
|
||||||
- Ignores the `PictureSourceType` parameter (user chooses it in a dialog window)
|
|
||||||
|
|
||||||
- Ignores the `encodingType`
|
|
||||||
|
|
||||||
- Ignores the `targetWidth` and `targetHeight`
|
|
||||||
|
|
||||||
- `Camera.MediaType` is not supported.
|
|
||||||
|
|
||||||
- Ignores the `correctOrientation` parameter.
|
|
||||||
|
|
||||||
- Ignores the `cameraDirection` parameter.
|
|
||||||
|
|
||||||
#### iOS Quirks
|
#### iOS Quirks
|
||||||
|
|
||||||
- When using `destinationType.FILE_URI`, photos are saved in the application's temporary directory. The contents of the application's temporary directory is deleted when the application ends.
|
- When using `destinationType.FILE_URI`, photos are saved in the application's temporary directory. The contents of the application's temporary directory is deleted when the application ends.
|
||||||
@ -578,28 +517,7 @@ Tizen only supports a `destinationType` of
|
|||||||
|
|
||||||
- When using `destinationType.NATIVE_URI` and `sourceType.PHOTOLIBRARY` or `sourceType.SAVEDPHOTOALBUM`, all editing options are ignored and link is returned to original picture.
|
- When using `destinationType.NATIVE_URI` and `sourceType.PHOTOLIBRARY` or `sourceType.SAVEDPHOTOALBUM`, all editing options are ignored and link is returned to original picture.
|
||||||
|
|
||||||
#### Tizen Quirks
|
|
||||||
|
|
||||||
- options not supported
|
|
||||||
|
|
||||||
- always returns a FILE URI
|
|
||||||
|
|
||||||
#### Windows Phone 7 and 8 Quirks
|
|
||||||
|
|
||||||
- Ignores the `allowEdit` parameter.
|
|
||||||
|
|
||||||
- Ignores the `correctOrientation` parameter.
|
|
||||||
|
|
||||||
- Ignores the `cameraDirection` parameter.
|
|
||||||
|
|
||||||
- Ignores the `saveToPhotoAlbum` parameter. IMPORTANT: All images taken with the WP8/8 Cordova camera API are always copied to the phone's camera roll. Depending on the user's settings, this could also mean the image is auto-uploaded to their OneDrive. This could potentially mean the image is available to a wider audience than your app intended. If this is a blocker for your application, you will need to implement the CameraCaptureTask as [documented on MSDN][msdn_wp8_docs]. You may also comment or up-vote the related issue in the [issue tracker][wp8_bug].
|
|
||||||
|
|
||||||
- Ignores the `mediaType` property of `cameraOptions` as the Windows Phone SDK does not provide a way to choose videos from PHOTOLIBRARY.
|
|
||||||
|
|
||||||
[android_lifecycle]: http://cordova.apache.org/docs/en/dev/guide/platforms/android/lifecycle.html
|
[android_lifecycle]: http://cordova.apache.org/docs/en/dev/guide/platforms/android/lifecycle.html
|
||||||
[web_activities]: https://hacks.mozilla.org/2013/01/introducing-web-activities/
|
|
||||||
[wp8_bug]: https://issues.apache.org/jira/browse/CB-2083
|
|
||||||
[msdn_wp8_docs]: http://msdn.microsoft.com/en-us/library/windowsphone/develop/hh394006.aspx
|
|
||||||
|
|
||||||
## Sample: Take Pictures, Select Pictures from the Picture Library, and Get Thumbnails <a name="sample"></a>
|
## Sample: Take Pictures, Select Pictures from the Picture Library, and Get Thumbnails <a name="sample"></a>
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user