Flutter Image Picker Plugin
Android | iOS | |
---|---|---|
Support | SDK 21+ | 11.0+ |
Simplify media selection, cropping, and camera functionality in your Flutter app. Choose images/videos from the library, crop images, and capture new photos/videos with ease.
Installation
$ flutter pub add hl_image_picker
Note: If you are developing an application exclusively for eitherAndroid
oriOS
, you don’t need to installhl_image_picker
. Instead, you can choose one of the following packages based on your target platform:
- iOS – hl_image_picker_ios
- Android – hl_image_picker_android
Setup
To use the plugin, you need to perform the following setup steps:
iOS
Android
Usage
Select images/videos from library
import 'package:hl_image_picker/hl_image_picker.dart';
final _picker = HLImagePicker();
List<HLPickerItem> _selectedImages = [];
_openPicker() async {
final images = await _picker.openPicker(
// Properties
);
setState(() {
_selectedImages = images;
});
}
Properties
Property | Description | Type |
---|---|---|
selectedIds | A list of string IDs representing the initially selected images or videos from the library. This allows users to pre-select items before opening the picker. | [String] |
pickerOptions | Additional options for the picker | HLPickerOptions |
cropping | Indicating whether or not cropping is enabled. Just work when mediaType = MediaType.image and maxSelectedAssets = 1 | bool |
cropOptions | Configuration options for the cropping functionality | HLCropOptions |
localized | Custom text displayed for the plugin | LocalizedImagePicker |
Take a photo or record a video
import 'package:hl_image_picker/hl_image_picker.dart';
final _picker = HLImagePicker();
HLPickerItem? _selectedImage;
_openCamera() async {
final image = await _picker.openCamera(
// Properties
);
setState(() {
_selectedImage = image;
});
}
Properties
Property | Description | Type |
---|---|---|
cameraOptions | Additional options for the camera functionality | HLCameraOptions |
cropping | Indicating whether or not cropping is enabled | bool |
cropOptions | Configuration options for the cropping functionality | HLCropOptions |
localized | Custom text displayed for the plugin | LocalizedImageCropper |
Open image cropper
import 'package:hl_image_picker/hl_image_picker.dart';
final _picker = HLImagePicker();
HLPickerItem? _selectedImage;
_openCropper_() async {
final image = await _picker.openCropper("image_path_to_crop",
// Properties
);
setState(() {
_selectedImage = image;
});
}
Properties
Property | Description | Type |
---|---|---|
imagePath | Path of the image that needs to be cropped | String |
cropping | Indicating whether or not cropping is enabled | bool |
cropOptions | Configuration options for the cropping functionality | HLCropOptions |
localized | Custom text displayed for the plugin | LocalizedImageCropper |
HLPickerOptions
Property | Description | Default |
---|---|---|
mediaType | Type of media you want to select: MediaType.image , MediaType.video ,MediaType.all . | MediaType.all |
maxSelectedAssets | The maximum number of items that can be selected. | 1 |
minSelectedAssets | The minimum number of items that must be selected. | |
maxFileSize | The maximum allowed file size for selected items. | |
minFileSize | The minimum allowed file size for selected items. | |
enablePreview | Enables or disables the preview feature. (Press on Android and Long Press on iOS) | false |
convertHeicToJPG | Converts HEIC format images to JPEG format when selected. (iOS Only) | false |
convertLivePhotosToJPG | Converts Live Photos to JPEG format when selected. (iOS Only) | true |
recordVideoMaxSecond | The maximum duration (in seconds) for recorded video. | 60 |
isExportThumbnail | Determines whether to export thumbnail for selected videos. | false |
thumbnailCompressQuality | The compression quality (0.1-1) for exported thumbnails. | 0.9 |
thumbnailCompressFormat | The image format for exported thumbnails: CompressFormat.jpg , CompressFormat.png . | CompressFormat.jpg |
maxDuration | The maximum duration (in seconds) for selected videos. | |
minDuration | The minimum duration (in seconds) for selected videos. | |
numberOfColumn | The number of items displayed per row in the picker list. | 3 |
usedCameraButton | Determines whether to show the camera button in the picker list. | true |
HLCropOptions
Property | Description | Default |
---|---|---|
aspectRatio | Specifies the desired aspect ratio for cropping. | |
aspectRatioPresets | Provides a set of predefined aspect ratio options for cropping. | |
compressQuality | Determines the compression quality (0.1-1) for the exported image. | 0.9 |
compressFormat | Specifies the image format for the exported image: CompressFormat.jpg , CompressFormat.png . | CompressFormat.jpg |
croppingStyle | Cropping style: CroppingStyle.normal , CroppingStyle.circular . | CroppingStyle.normal |
maxSizeOutput | Sets the maximum width and maximum height for the exported image. |
HLCameraOptions
Property | Description | Default |
---|---|---|
cameraType | Specifies the type of camera to be used: CameraType.video , CameraType.image | CameraType.image |
recordVideoMaxSecond | The maximum duration (in seconds) for recorded video. | 60 |
isExportThumbnail | Determines whether to export thumbnail for recorded video. | false |
thumbnailCompressQuality | The compression quality (0.1-1) for exported thumbnail. | 0.9 |
thumbnailCompressFormat | The image format for exported thumbnail: CompressFormat.jpg , CompressFormat.png . | CompressFormat.jpg |
HLPickerItem (Response)
Property | Description | Type |
---|---|---|
path | The path of the item. | String |
id | The unique identifier of the item. | String |
name | The filename of the item. | String |
mimeType | The MIME type of the item. | String |
size | The size of the item in kilobytes (KB). | int |
width | The width of the item | int |
height | The height of the item | int |
type | Indicates whether the item is an image or video . | String |
duration | The duration of the video | double? |
thumbnail | The path of the video thumbnail | String? |
LocalizedImagePicker
Property | Description | Default |
---|---|---|
maxDurationErrorText | The error message displayed when the selected video exceeds the maximum duration. | Exceeded maximum duration of the video |
minDurationErrorText | The error message displayed when the selected video is below the minimum duration. | The video is too short |
maxFileSizeErrorText | The error message displayed when the selected file exceeds the maximum file size. | Exceeded maximum file size |
minFileSizeErrorText | The error message displayed when the selected file is below the minimum file size. | The file size is too small |
noAlbumPermissionText | The error message displayed when the app doesn’t have permission to access the album. | No permission to access album |
noCameraPermissionText | The error message displayed when the app doesn’t have permission to access the camera. | No permission to access camera |
maxSelectedAssetsErrorText | The error message displayed when the maximum number of items is exceeded. | Exceeded maximum number of selected items |
minSelectedAssetsErrorText | The error message displayed when the minimum number of items is not met. | Need to select at least {minSelectedAssets} |
noRecordAudioPermissionText | The error message displayed when the app doesn’t have permission to record audio. | No permission to record audio |
doneText | The text displayed on the “Done” button. | Done |
cancelText | The text displayed on the “Cancel” button. | Cancel |
loadingText | The text displayed when the picker is in a loading state. | Loading |
defaultAlbumName | The name for default album. | Recents |
tapHereToChangeText | The text displayed below defaultAlbumName . (iOS Only) | Tap here to change |
okText | The text displayed on the “OK” button. | OK |
emptyMediaText | The text displayed when no media is available. (iOS Only) | No media available |
cropDoneText | The text displayed on the “Done” button. (iOS Only) | Done |
cropCancelText | The text displayed on the “Cancel” button. (iOS Only) | Cancel |
cropTitleText | The title displayed in the crop image screen. (iOS Only) |
LocalizedImageCropper
Property | Description | Default |
---|---|---|
cropDoneText | The text displayed on the “Done” button. (iOS Only) | Done |
cropCancelText | The text displayed on the “Cancel” button. (iOS Only) | Cancel |
cropTitleText | The title displayed in the crop image screen. (iOS Only) |
ProGuard
-keep class com.luck.picture.lib.** { *; }
-dontwarn com.yalantis.ucrop**
-keep class com.yalantis.ucrop** { *; }
-keep interface com.yalantis.ucrop** { *; }
Open-source library
iOS: TLPhotoPicker and TOCropViewController
Android: PictureSelector