add picke visual media api

CHANGELOG.md

@@ -1,3 +1,7 @@
+## [2.2.0](https://github.com/spoonconsulting/cordova-plugin-telerik-imagepicker/compare/2.1.1...2.2.0) (2025-02-28)
+
+* **Android:** Now using the recommended image picker by Android (PickVisualMedia) instead of file picker. However an option to revert to file picker has been added: `useFilePicker: true`
+
 ## [2.1.2](https://github.com/spoonconsulting/cordova-plugin-telerik-imagepicker/compare/2.1.1...2.1.2) (2024-05-27)
 
 * **ios:** Bug Fix.

README.md

@@ -77,13 +77,19 @@ window.imagePicker.getPictures(
         // available options are 
         // window.imagePicker.OutputType.FILE_URI (0) or 
         // window.imagePicker.OutputType.BASE64_STRING (1)
-        outputType: int
+        outputType: int,
+
+        // option to revert to file picker on android
+        useFilePicker: boolean
+
     };
 
 ### Note for Android Use
 
 The 'maximumImagesCount' option is currently the only option supported for Android
 
+The `useFilePicker` option is only used for Android as prior to the current version the file picker was being used.
+
 ## Android 6 (M) Permissions
 On Android 6 you need to request permission to read external storage at runtime when targeting API level 23+.
 Even if the `uses-permission` tags for the Calendar are present in `AndroidManifest.xml`.

package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spoonconsulting/cordova-plugin-telerik-imagepicker",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "cordova_name": "ImagePicker",
   "description": "This plugin allows selection of multiple images from the camera roll / gallery in a phonegap app",
   "license": "MIT",

plugin.xml

@@ -2,7 +2,7 @@
 <plugin xmlns="http://www.phonegap.com/ns/plugins/1.0"
   xmlns:android="http://schemas.android.com/apk/res/android"
   id="@spoonconsulting/cordova-plugin-telerik-imagepicker"
-  version="2.1.2">
+  version="2.2.0">
 
     <name>ImagePicker</name>
 

src/android/ImagePicker.java

@@ -13,6 +13,7 @@
 import android.net.Uri;
 import android.os.Build;
 import android.os.Bundle;
+import android.os.ext.SdkExtensions;
 import android.provider.MediaStore;
 import android.provider.OpenableColumns;
 import android.util.Log;
@@ -23,6 +24,8 @@
 import android.widget.ProgressBar;
 import android.widget.Toast;
 
+import androidx.activity.result.PickVisualMediaRequest;
+import androidx.activity.result.contract.ActivityResultContracts;
 import androidx.core.content.ContextCompat;
 
 import org.apache.cordova.CallbackContext;
@@ -64,12 +67,28 @@ public boolean execute(String action, final JSONArray args, final CallbackContex
         } else if (ACTION_GET_PICTURES.equals(action)) {
             final JSONObject params = args.getJSONObject(0);
             this.maxImageCount = params.has("maximumImagesCount") ? params.getInt("maximumImagesCount") : 20;
+            if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.R && SdkExtensions.getExtensionVersion(Build.VERSION_CODES.R) >= 2) {
+                int deviceMaxLimit = MediaStore.getPickImagesMaxLimit();
+               if (this.maxImageCount > deviceMaxLimit) {
+                   this.maxImageCount = deviceMaxLimit;
+                   this.showMaxLimitWarning(deviceMaxLimit);
+               };
+            }
+
+            boolean useFilePicker = params.has("useFilePicker") && params.getBoolean("useFilePicker");
+
+            Intent imagePickerIntent = null;
+            if (useFilePicker) {
+                imagePickerIntent = new Intent(Intent.ACTION_OPEN_DOCUMENT);
+                imagePickerIntent.setDataAndType(MediaStore.Images.Media.EXTERNAL_CONTENT_URI, "image/*");
+                imagePickerIntent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true);
+            } else {
+                PickVisualMediaRequest pickVisualMediaRequest = new PickVisualMediaRequest.Builder().setMediaType(ActivityResultContracts.PickVisualMedia.ImageOnly.INSTANCE).build();
+                imagePickerIntent = new ActivityResultContracts.PickMultipleVisualMedia(maxImageCount).createIntent(cordova.getContext(), pickVisualMediaRequest);
+            }
 
-            Intent imagePickerIntent = new Intent(Intent.ACTION_OPEN_DOCUMENT, MediaStore.Images.Media.EXTERNAL_CONTENT_URI);
-            imagePickerIntent.setType("image/*");
-            imagePickerIntent.putExtra(Intent.EXTRA_ALLOW_MULTIPLE, true);
             cordova.startActivityForResult(this, imagePickerIntent, SELECT_PICTURE);
-            this.showMaxLimitWarning();
+            this.showMaxLimitWarning(useFilePicker);
             return true;
         }
         return false;
@@ -266,8 +285,18 @@ private String copyFileToInternalStorage(Uri uri, String newDirName) {
         return output.getPath();
     }
 
-    private void showMaxLimitWarning() {
-        String toastMsg = "Only the first " + this.maxImageCount + " images selected will be taken.";
+    private void showMaxLimitWarning(boolean useFilePicker) {
+        String toastMsg = "You can only select up to " + this.maxImageCount + " image(s)";
+        if (useFilePicker) {
+            toastMsg = "Only the first " + this.maxImageCount + " image(s) selected will be taken.";
+        }
+        (Toast.makeText(cordova.getContext(), toastMsg, Toast.LENGTH_LONG)).show();
+    }
+    private void showMaxLimitWarning(int deviceMaxLimit) {
+        String toastMsg = "The maximumImagesCount:" + this.maxImageCount +
+                " is greater than the device's max limit of images that can be selected from the MediaStore: " + deviceMaxLimit +
+                ". Maximum number of images that can be selected is: " + deviceMaxLimit;
+
         (Toast.makeText(cordova.getContext(), toastMsg, Toast.LENGTH_LONG)).show();
     }
 }

www/imagepicker.js

@@ -59,6 +59,7 @@ ImagePicker.prototype.getPictures = function(success, fail, options) {
 
 	var params = {
 		maximumImagesCount: options.maximumImagesCount ? options.maximumImagesCount : 15,
+		useFilePicker: options.useFilePicker ? options.useFilePicker : false,
 		width: options.width ? options.width : 0,
 		height: options.height ? options.height : 0,
 		quality: options.quality ? options.quality : 100,