media_gallery

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

O pacote media_gallery é um plugin do Flutter que permite o acesso a itens da galeria nativa do dispositivo, permitindo que os usuários naveguem e selecionem imagens e vídeos do armazenamento local do dispositivo. Ele fornece uma interface simples para recuperar arquivos de mídia com metadados como caminhos de arquivos, marcas de tempo e dimensões. Projetado para integração perfeita com aplicativos Flutter, suporta implementações específicas da plataforma no Android e no iOS. O plugin é ideal para aplicações que exigem recursos de seleção de mídia, como compartilhamento de fotos, upload de fotos de perfil ou ferramentas de criação de conteúdo. Ele depende de APIs nativas para desempenho e compatibilidade.

Casos de uso

Seleção de imagem e vídeo da galeria do dispositivo
Fluxos de trabalho de upload de imagem de perfil
Criação de conteúdo de aplicativo rico em mídia
Navegação de álbum de fotos em aplicativos Flutter
Integrando o seletor de mídia nativo na interface do Flutter

Principais recursos

Acesso a arquivos de mídia do dispositivo nativo
Suporta tanto imagens quanto vídeos
Recupera metadados de mídia (caminho, carimbo de data/hora, tamanho)
Compatibilidade multiplataforma (Android/iOS)
API simples para listar e filtrar mídias

Indicado para

Aplicativos Flutter que precisam de seleção de mídia
plataformas de mídia social ou compartilhamento de fotos
Ferramentas de criação de conteúdo
Aplicativos com upload de mídia gerada pelo usuário
Desenvolvedores criando seletores de mídia personalizados

Considerações

Requer permissões apropriadas (câmera e armazenamento)
Limitado à galeria nativa; sem suporte a mídia em nuvem
O comportamento específico do plataforma pode variar
Sem componentes de interface do usuário embutidos; requer implementação personalizada
Pode exigir tratamento adicional para bibliotecas de mídia grandes

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

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.

Buscar pacotes, repositórios e categorias de apps

Instalar pacote