media_gallery

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

Das media_gallery-Paket ist ein Flutter-Plugin, das den Zugriff auf native Geräte-Galerie-Elemente ermöglicht, sodass Benutzer Bilder und Videos aus dem lokalen Medienspeicher ihres Geräts durchsuchen und auswählen können. Es bietet eine einfache Schnittstelle zum Abrufen von Mediendateien mit Metadaten wie Dateipfaden, Zeitstempeln und Abmessungen. Für eine nahtlose Integration in Flutter-Anwendungen wurde es entwickelt und unterstützt plattformspezifische Implementierungen unter Android und iOS. Das Plugin eignet sich ideal für Anwendungen, die Media-Auswahl-Funktionen erfordern, wie beispielsweise Foto-Sharing, Profilbild-Upload oder Content-Erstellungstools. Es basiert auf nativen APIs für Leistung und Kompatibilität.

Anwendungsfälle

Bild- und Videowahl aus der Gerätegalerie
Workflows zum Hochladen von Profilbildern
Medienreiche App-Inhaltserstellung
Fotoalbum-Browsing in Flutter-Apps
Integration des nativen Medienpickers in die Flutter-Oberfläche

Hauptmerkmale

Zugriff auf native Gerätedateien
Unterstützt sowohl Bilder als auch Videos
Ruft Medienmetadaten (Pfad, Zeitstempel, Größe) ab
Plattformübergreifende Kompatibilität (Android/iOS)
Einfache API zum Auflisten und Filtern von Medien

Geeignet für

Flutter-Anwendungen, die Medienauswahl benötigen
Soziale Medien- oder Fototeilungsplattformen
Inhaltserstellungswerkzeuge
Apps mit Benutzermedien-Uploads
Entwickler, die benutzerdefinierte Medienauswahlkomponenten erstellen

Hinweise

Erfordert geeignete Berechtigungen (Kamera und Speicher)
Beschränkt auf native Galerie; keine Cloud-Medienunterstützung
Plattformspezifisches Verhalten kann variieren
Keine eingebauten Benutzeroberflächenkomponenten; erfordert benutzerdefinierte Implementierung
Kann zusätzliche Behandlung für große Medienbibliotheken erfordern

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

Media Gallery plugin for Flutter

A Flutter plugin that lists native gallery items.

Installation

First, add media_gallery as a dependency in your pubspec.yaml file.

iOS

Add the following keys to your Info.plist file, located in <project root>/ios/Runner/Info.plist:

<key>NSPhotoLibraryUsageDescription</key>
<string>Example usage description</string>

Android

Add the following permissions to your AndroidManifest.xml, located in <project root>/android/app/src/main/AndroidManifest.xml:

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

You should also manage those permissions (for example thanks to the permission_handler plugin). You can see an example for more details.

Usage

Listing media collections

final List<MediaCollection> collections = await MediaGallery.listMediaCollections(
    mediaTypes: [MediaType.image, MediaType.video],
);

Listing medias in a collection

final MediaPage imagePage = await collection.getMedias(
    mediaType: MediaType.image,
    take: 500,
);
final MediaPage videoPage = await collection.getMedias(
    mediaType: MediaType.video,
    take: 500,
);
final List<Media> allMedias = [
    ...imageRange.items,
    ...videoRange.items,
]
..sort((x, y) => y.creationDate.compareTo(x.creationDate));

Loading more medias in a collection

if (!imagePage.isLast) {
    final nextImagePage = await imagePage.nextPage();
    // ...
}

Getting a file

final File file = await media.getFile();

Getting thumbnail data

final List<int> data = await media.getThumbnail();

Displaying thumbnails

MediaThumbnailProvider, MediaCollectionThumbnailProvider are available to display thumbnail images (here with the help of transparent_image) :

FadeInImage(
    fit: BoxFit.cover,
    placeholder: MemoryImage(kTransparentImage),
    image: MediaThumbnailProvider(
        media: media,
    ),
)

Displaying medias

You can use MediaImageProvider to display an image (here with the help of transparent_image):

FadeInImage(
    fit: BoxFit.cover,
    placeholder: MemoryImage(kTransparentImage),
    image: MediaImageProvider(
        media: media,
    ),
)

To display a video, you can use video_player.

Image/Video picker

picker

You can build a gallery picker easily with this package.

See the example for more details.

Pakete, Repositories und App-Kategorien suchen

Paket installieren