Advanced Media Picker

Advanced Media Picker Package for Flutter

Getting Started

This plugin displays a gallery with user's Albums and Photos with ability to take photo and video.

Prepare for use

Configure native platforms

Minimum platform versions: Android 16, iOS 9.0, macOS 10.15.

• Android: Android config preparation.
• iOS: iOS config preparation.
• macOS: Pretty much the same with iOS.

Android config preparation

Kotlin, Gradle, AGP

We ship this plugin with Kotlin 1.7.22. If your projects use a lower version of Kotlin/Gradle/AGP, please upgrade them to a newer version.

More specifically:

• Upgrade your Gradle version (gradle-wrapper.properties) to 7.5.1 or the latest version.
• Upgrade your Kotlin version (ext.kotlin_version) to 1.7.22 or the latest version.
• Upgrade your AGP version (com.android.tools.build:gradle) to 7.2.2 or the latest version.

Android 10 (Q, 29)

If you're not setting your compileSdkVersion or targetSdkVersion to 29, you can skip this section.

On Android 10, Scoped Storage was introduced, which causes the origin resource file not directly inaccessible through it file path.

If your compileSdkVersion or targetSdkVersion is 29, you can consider adding android:requestLegacyExternalStorage="true" to your AndroidManifest.xml in order to obtain resources:

<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.example">

  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" android:maxSdkVersion="32" />
  <!-- Devices running Android 13 (API level 33) or higher -->
  <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
  <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
  <!-- To handle the reselection within the app on devices running Android 14
       or higher if your app targets Android 14 (API level 34) or higher.  -->
  <uses-permission android:name="android.permission.READ_MEDIA_VISUAL_USER_SELECTED" />


  <application android:label="example" android:icon="@mipmap/ic_launcher"
        android:requestLegacyExternalStorage="true"></application>
</manifest>

Note: Apps that are using the flag will be rejected from the Google Play.

iOS config preparation

Define the NSPhotoLibraryUsageDescription , NSCameraUsageDescription and NSMicrophoneUsageDescription key-value in the ios/Runner/Info.plist:

<key>NSPhotoLibraryUsageDescription</key>
<string>In order to access your photo library</string>
<key>NSCameraUsageDescription</key>
<string>your usage description here</string>
<key>NSMicrophoneUsageDescription</key>
<string>your usage description here</string>

Usage

Request for permission

This plugin requires the user's permission to access the media library and camera . You should handle cases where the user denies the permission request.

Limited entities access

Limited entities access on iOS

With iOS 14 released, Apple brought a "Limited Photos Library" permission (PermissionState.limited) to iOS.

To suppress the automatic prompting from the system when each time you access the media after the app has restarted, you can set the Prevent limited photos access alert key to YES in your app's Info.plist (or manually writing as below):

<key>PHPhotoLibraryPreventAutomaticLimitedAccessAlert</key>
<true/>

Limited entities access on Android

Android 14 (API 34) has also introduced the concept of limited assets similar to iOS.

However, there is a slight difference in behavior (based on the emulator): On Android, the access permission to a certain resource cannot be revoked once it is granted, even if it hasn't been selected when using presentLimited in future actions.

Usage

1. Add the plugin to your pubspec.yaml file:

dependencies:
  advanced_media_picker: ^0.0.1

2. Import the plugin in your Dart code:

import 'package:advanced_media_picker/advanced_media_picker.dart';

3. Use the plugin in your Dart code:

final List<XFile> result = 
        await AdvancedMediaPicker.openPicker(
                                    context: context,
                                    style: PickerStyle(),
                                    cameraStyle: CameraStyle(),
                                    allowedTypes: PickerAssetType.image,
                                    maxVideoDuration: 60,
                                    selectionLimit: 10,
                                    showCamera : true,
                                    videoCamera : true,
                                    );
///openAdvancedPicker method with ability to add different UI states depends on the camera and gallery permission status
///and with ability to get and display result on screen inside app 
final List<XFile> result =
        AdvancedMediaPicker.openAdvancedPicker(
                                    context: context,
                                    style: PickerStyle(),
                                    cameraStyle: CameraStyle(),
                                    allowedTypes: PickerAssetType.image,
                                    maxVideoDuration: 60,
                                    selectionLimit: 10,
                                    );

///openAssetsPicker method with ability to select assets from gallery and display previously added assets as already selected
final Future<List<AssetModel>> result =
        AdvancedMediaPicker.openAssetsPicker(
                                    context: context,
                                    style: PickerStyle(),
                                    cameraStyle: CameraStyle(),
                                    allowedTypes: PickerAssetType.image,
                                    maxVideoDuration: 60,
                                    selectionLimit: 10,
                                    ).listen((assets){

                                    });

Parameters

• context: The BuildContext of the widget.
• style: The PickerStyle object to customize the picker.

 BorderRadius borderRadius;
 BorderRadius itemsBorderRadius;
 Color backgroundColor;
 Color textColor;
 Color selectIconBackgroundColor;
 Border selectIconBorder;
 Widget selectIcon;
 Widget cameraIcon;
 bool isNeedDragIndicator;
 Color dragIndicatorColor;
 EdgeInsets mainPadding;
 Color shimmerBaseColor;
 Color shimmerHighlightColor;
 Color dividerColor;
 Alignment selectIconAlignment;
 BoxDecoration selectedFolderDecoration;
 BoxDecoration unselectedFolderDecoration;
 BoxDecoration cameraContainerDecoration;
 Color selectedFolderTextColor;
 Color unselectedFolderTextColor;
/// A function that returns a boolean value from your custom alert dialog.
 bool Function()? showCustomAlert;
 Widget? completeWidget;
 Widget? typeSelectionWidget;
 double bottomPadding;
 Widget cameraUnavailableContent;
 Widget galleryUnavailableContent;
 Widget cameraAndGalleryUnavailableContent;
 /// Result of permission request for camera 
 bool hasPermissionToCamera;
 /// Result of permission request for gallery
 bool hasPermissionToGallery;
 int crossAxisCount;
 double crossAxisSpacing;
 double mainAxisSpacing;
 /// Unselected asset mark icon
 Widget? unselectAssetIcon;
 /// Custom selected asset mark icon
 Widget? customSelectAssetIcon;
 /// Custom selected assets count style
 TextStyle? customSelectAssetCountStyle;

• cameraStyle: The CameraStyle object to customize the camera.

Widget cameraCloseIcon;
Widget takePictureIcon;
Widget chooseCameraIcon;
Widget cameraBackButton;
Widget cameraAddMediaButton;
Widget cameraDeleteMediaButton;
Widget cameraSelectedMediaButton;
Widget videoIcon;
Widget flipCameraIcon;
String finishButtonTitle;
TextStyle finishButtonStyle;
EdgeInsets finishButtonPadding;
double basicCameraViewBorderRadius;
double basicCameraCropContainerHeight;
double basicCameraCropContainerBorderRadius;
Color basicCameraCropContainerBorderColor;
Widget basicCameraFlashIcon;
Widget basicCameraFlashAutoIcon;
Widget basicCameraFlashOffIcon;
Widget? basicCameraTakePhotoButton;
bool showBasicCamera;

• allowedTypes: The PickerAssetType enum to allow the user to select.

enum PickerAssetType {
  other,
  all,
  image,
  imageAndVideo,
  video,
  audio;
}

bool isNeedToShowCamera = true,
bool isNeedVideoCamera = true,
int maxVideoDuration = -1,
List<String> fileSelectorAllowedTypes = const <String>['pdf', 'doc'],
/// The maximum number of files that can be selected in the picker.
/// If the value is -1, it means that there is no limit to the number of files that can be selected.
int selectionLimit = 3,
PickerController? controller,

Screenshots / Demo

https://youtu.be/E6lGKX7U2SQ

---

Plugins

This package is currently extended with the following plugins. Instructions on how to use them in your own application are linked below.

Plugin	README
photo_manager	https://pub.dev/packages/photo_manager
photo_manager_image_provider	https://pub.dev/packages/photo_manager_image_provider
flutter_sticky_header	https://pub.dev/packages/flutter_sticky_header
camerawesome	https://pub.dev/packages/camerawesome