Skip to main content

adaptive_media_picker 2.0.0 copy "adaptive_media_picker: ^2.0.0" to clipboard
adaptive_media_picker: ^2.0.0 copied to clipboard

Image & video picker with permissions, camera/gallery source sheet, cropping (incl. circle) on every platform, size/type validation, and no READ_MEDIA permission.

example/lib/main.dart

import 'package:flutter/material.dart';
import 'package:adaptive_media_picker/adaptive_media_picker.dart';

// This example demonstrates common usage patterns for AdaptiveMediaPicker:
// - An avatar flow: source sheet (camera / gallery / remove), circle crop,
//   front camera and a file size limit
// - Single / multiple images, single / multiple videos, mixed media
// - Typed errors and Android lost-data recovery
// Camera requests fall back to the gallery on web/desktop.

void main() {
  runApp(const ExampleApp());
}

class ExampleApp extends StatefulWidget {
  const ExampleApp({super.key});

  @override
  State<ExampleApp> createState() => _ExampleAppState();
}

class _ExampleAppState extends State<ExampleApp> {
  bool _darkMode = false;

  @override
  Widget build(BuildContext context) {
    ThemeData theme(Brightness brightness) => ThemeData(
      colorScheme: ColorScheme.fromSeed(
        seedColor: Colors.indigo,
        brightness: brightness,
      ),
      useMaterial3: true,
    );
    return MaterialApp(
      title: 'adaptive_media_picker example',
      theme: theme(Brightness.light),
      darkTheme: theme(Brightness.dark),
      themeMode: _darkMode ? ThemeMode.dark : ThemeMode.light,
      home: ExampleHomePage(
        darkMode: _darkMode,
        onToggleTheme: () => setState(() => _darkMode = !_darkMode),
      ),
      debugShowCheckedModeBanner: false,
    );
  }
}

class ExampleHomePage extends StatefulWidget {
  const ExampleHomePage({
    super.key,
    required this.darkMode,
    required this.onToggleTheme,
  });

  final bool darkMode;
  final VoidCallback onToggleTheme;

  @override
  State<ExampleHomePage> createState() => _ExampleHomePageState();
}

class _ExampleHomePageState extends State<ExampleHomePage> {
  final AdaptiveMediaPicker _picker = AdaptiveMediaPicker();
  List<PickedMedia> _items = const [];
  PickedMedia? _avatar;
  String _status = 'Ready';

  PickOptions get _baseOptions => PickOptions(
    imageQuality: 85,
    themeBrightness: widget.darkMode ? Brightness.dark : Brightness.light,
    settingsDialogTitle: 'Permission required',
    settingsDialogMessage: 'Please allow Photos/Camera to continue.',
    logTag: 'example',
  );

  @override
  void initState() {
    super.initState();
    // Android may kill the app while the camera is open; recover that pick.
    _picker.recoverLostData().then((result) {
      if (result != null && mounted) _show(result.items, result.error);
    });
  }

  void _show(List<PickedMedia> items, PickError? error) {
    setState(() {
      _items = items;
      _status = switch (error) {
        null => 'Picked ${items.length} item(s).',
        PickError.canceled => 'Canceled.',
        PickError.cropCanceled => 'Crop canceled; kept the original image.',
        PickError.permissionDenied => 'Permission denied.',
        PickError.fileTooLarge => 'That file is too large.',
        PickError.unsupportedType => 'That file type is not supported.',
        PickError.io || PickError.unknown => 'Picking failed (see log).',
      };
    });
  }

  Future<void> _single(
    Future<PickResultSingle> Function() pick, {
    bool avatar = false,
  }) async {
    final result = await pick();
    if (!mounted) return;
    if (avatar) {
      if (result.removeRequested) {
        setState(() {
          _avatar = null;
          _status = 'Avatar removed.';
        });
        return;
      }
      if (result.item != null) setState(() => _avatar = result.item);
    }
    _show([?result.item], result.error);
  }

  Future<void> _multiple(Future<PickResultMultiple> Function() pick) async {
    final result = await pick();
    if (!mounted) return;
    _show(result.items, result.error);
    if (result.rejected.isNotEmpty) {
      setState(() => _status += ' ${result.rejected.length} rejected.');
    }
  }

  Future<void> _pickAvatar() => _single(
    () => _picker.pickImage(
      context: context,
      sourceSheet: SourceSheetOptions(
        title: 'Profile photo',
        removeLabel: _avatar == null ? null : 'Remove photo',
      ),
      options: PickOptions(
        imageQuality: 85,
        wantToCrop: true,
        cropShape: CropShape.circle,
        preferredCameraDevice: CameraDevice.front,
        maxFileSizeBytes: 5 * 1024 * 1024,
        allowedMimeTypes: const ['image/*'],
        themeBrightness: widget.darkMode ? Brightness.dark : Brightness.light,
      ),
    ),
    avatar: true,
  );

  @override
  Widget build(BuildContext context) {
    final options = _baseOptions;
    final actions = <(String, VoidCallback)>[
      (
        'Pick image (gallery)',
        () => _single(
          () => _picker.pickImage(context: context, options: options),
        ),
      ),
      (
        'Pick image (choose source)',
        () => _single(
          () => _picker.pickImage(
            context: context,
            options: options,
            sourceSheet: const SourceSheetOptions(),
          ),
        ),
      ),
      (
        'Pick image (crop 16:9)',
        () => _single(
          () => _picker.pickImage(
            context: context,
            options: PickOptions(
              wantToCrop: true,
              cropAspectRatio: CropAspectRatioOption.ratio16x9,
              themeBrightness: options.themeBrightness,
            ),
          ),
        ),
      ),
      (
        'Pick multiple images (gallery)',
        () => _multiple(
          () => _picker.pickMultiImage(
            context: context,
            options: PickOptions(maxImages: 5, imageQuality: 85),
          ),
        ),
      ),
      (
        'Pick video (gallery)',
        () => _single(
          () => _picker.pickVideo(context: context, options: options),
        ),
      ),
      (
        'Pick video (choose source)',
        () => _single(
          () => _picker.pickVideo(
            context: context,
            sourceSheet: const SourceSheetOptions(),
            options: const PickOptions(maxVideoDuration: Duration(seconds: 10)),
          ),
        ),
      ),
      (
        'Pick multiple videos',
        () => _multiple(
          () => _picker.pickMultiVideo(
            context: context,
            options: const PickOptions(maxImages: 3),
          ),
        ),
      ),
      (
        'Pick photos & videos',
        () => _multiple(
          () => _picker.pickMultipleMedia(
            context: context,
            options: const PickOptions(maxImages: 10),
          ),
        ),
      ),
    ];

    return Scaffold(
      appBar: AppBar(
        title: const Text('Media Picker Demo'),
        actions: [
          IconButton(
            tooltip: 'Toggle theme',
            icon: Icon(widget.darkMode ? Icons.dark_mode : Icons.light_mode),
            onPressed: widget.onToggleTheme,
          ),
        ],
      ),
      body: ListView(
        padding: const EdgeInsets.all(16),
        children: [
          Center(
            child: GestureDetector(
              onTap: _pickAvatar,
              child: _Avatar(media: _avatar),
            ),
          ),
          const SizedBox(height: 8),
          const Center(child: Text('Tap the avatar to change it')),
          const SizedBox(height: 16),
          Wrap(
            spacing: 8,
            runSpacing: 8,
            children: [
              for (final (label, onPressed) in actions)
                FilledButton.tonal(onPressed: onPressed, child: Text(label)),
            ],
          ),
          const SizedBox(height: 16),
          Text(_status, style: Theme.of(context).textTheme.titleSmall),
          const SizedBox(height: 8),
          if (_items.isEmpty)
            const Padding(
              padding: EdgeInsets.all(24),
              child: Center(child: Text('No items')),
            )
          else
            for (final item in _items) _MediaTile(media: item),
        ],
      ),
    );
  }
}

class _Avatar extends StatelessWidget {
  const _Avatar({required this.media});

  final PickedMedia? media;

  @override
  Widget build(BuildContext context) {
    final scheme = Theme.of(context).colorScheme;
    final placeholder = CircleAvatar(
      radius: 48,
      backgroundColor: scheme.primaryContainer,
      child: Icon(Icons.person, size: 48, color: scheme.onPrimaryContainer),
    );
    if (media == null) return placeholder;
    return FutureBuilder(
      // readAsBytes works everywhere, including web blob URLs.
      future: media!.readAsBytes(),
      builder: (context, snapshot) => snapshot.hasData
          ? CircleAvatar(
              radius: 48,
              backgroundImage: MemoryImage(snapshot.data!),
            )
          : placeholder,
    );
  }
}

class _MediaTile extends StatelessWidget {
  const _MediaTile({required this.media});

  final PickedMedia media;

  @override
  Widget build(BuildContext context) {
    final size = media.sizeInBytes == null
        ? ''
        : '${(media.sizeInBytes! / 1024).toStringAsFixed(0)} KB';
    final dims = media.width == null ? '' : '${media.width}x${media.height}';
    return Card.filled(
      child: ListTile(
        leading: SizedBox.square(
          dimension: 48,
          child: media.isVideo
              ? const Icon(Icons.movie_outlined)
              : FutureBuilder(
                  future: media.readAsBytes(),
                  builder: (context, snapshot) => snapshot.hasData
                      ? ClipRRect(
                          borderRadius: BorderRadius.circular(6),
                          child: Image.memory(
                            snapshot.data!,
                            fit: BoxFit.cover,
                          ),
                        )
                      : const Icon(Icons.image_outlined),
                ),
        ),
        title: Text(media.name ?? media.path, overflow: TextOverflow.ellipsis),
        subtitle: Text(
          [
            media.mimeType ?? 'unknown type',
            dims,
            size,
          ].where((s) => s.isNotEmpty).join(' · '),
        ),
      ),
    );
  }
}
37
likes
150
points
530
downloads

Documentation

API reference

Publisher

unverified uploader

Weekly Downloads

Image & video picker with permissions, camera/gallery source sheet, cropping (incl. circle) on every platform, size/type validation, and no READ_MEDIA permission.

Repository (GitHub)
View/report issues

Topics

#image-picker #video-picker #camera #gallery #file-selection

License

MIT (license)

Dependencies

crop_your_image, flutter, image_cropper, image_picker, image_picker_android, image_picker_platform_interface, photo_manager, smart_permission

More

Packages that depend on adaptive_media_picker