From 7ddb3dfbbe42053f398f62687ba20de3a5040445 Mon Sep 17 00:00:00 2001 From: jcesarmobile Date: Mon, 10 Dec 2018 00:52:39 +0100 Subject: [PATCH] Remove deprecated platforms from docs (#394) --- README.md | 84 +------------------------------------------------------ 1 file changed, 1 insertion(+), 83 deletions(-) diff --git a/README.md b/README.md index 6c55069..f3d04d5 100644 --- a/README.md +++ b/README.md @@ -168,14 +168,10 @@ than `DATA_URL`. __Supported Platforms__ - Android -- BlackBerry - Browser -- Firefox -- FireOS - iOS - Windows -- WP8 -- Ubuntu +- OSX 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: -#### Amazon Fire OS Quirks - -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 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. -#### Firefox OS Quirks - -Camera plugin is currently implemented using [Web Activities][web_activities]. - #### iOS Quirks 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) -#### Tizen Quirks - -Tizen only supports a `destinationType` of -`Camera.DestinationType.FILE_URI` and a `sourceType` of -`Camera.PictureSourceType.PHOTOLIBRARY`. - - ## `CameraOptions` Errata -#### 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 - 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. -#### 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 - 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. -#### 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 -[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