パッケージ、リポジトリ、アプリカテゴリを検索

パッケージ詳細v2.2.1

photo_gallery

モバイルネイティブギャラリーから画像と動画を取得するためのFlutterプラグインです。

AndroidiOS
30日間ダウンロード
1640
いいね数
162
Pub ポイント
150

パッケージをインストール

flutter pub add photo_gallery

パッケージ概要

公開情報に基づく選定ガイドです。参考としてご利用ください。

photo_gallery パッケージは、Android および iOS デバイスのネイティブギャラリーから画像や動画にアクセスするための Flutter プラグインです。メディアファイルを取得するためのシンプルなインターフェースを提供し、開発者がアプリ内にギャラリーブラウジングと選択機能を統合できるようにします。プラットフォーム固有の API を活用することで、両オペレーティングシステムで互換性とパフォーマンスを確保しています。写真共有、プロフィール画像のアップロード、コンテンツ作成ツールなど、メディア収集機能が必要なアプリケーションに最適です。pub add による最小限の設定で、既存の Flutter プロジェクトへのシームレスな統合が可能になります。

用途

  • デバイスギャラリーからの画像および動画の選択
  • プロフィール画像のアップロードワークフロー
  • メディア豊富なアプリコンテンツ作成
  • 写真共有アプリケーション開発
  • ユーザー生成コンテンツの収集

主な機能

  • Android および iOS 用のクロスプラットフォーム対応
  • ネイティブギャラリーのメディアにアクセスするためのシンプルな API
  • 画像と動画の両方をサポートしています
  • flutter pub add との簡単な統合
  • 信頼性を確保するためにネイティブプラットフォームAPIに依存しています

適している対象

  • メディア重視のFlutterアプリを開発する開発者
  • ユーザーのアップロードにギャラリーへのアクセスが必要なアプリ
  • ソーシャルメディアまたはコンテンツ作成プラットフォーム
  • 画像/動画ピッカー機能を必要とするモバイルアプリ
  • ネイティブギャラリー統合を優先するプロジェクト

注意事項

  • Android および iOS には適切な権限が必要です
  • メディアの取得に限定;編集やトリミングは不可
  • ネイティブギャラリーの利用可能性およびシステム権限に依存します
  • 大容量のメディアファイルに対して追加の処理が必要になる場合があります
  • 高度なメディア処理タスクには適していません

元の README

関連するソースリポジトリの README 原文のスナップショットです。最新の内容はリポジトリをご覧ください。

Photo Gallery

pub package

A Flutter plugin that retrieves images and videos from mobile native gallery.

Installation

First, add photo_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:

NSPhotoLibraryUsageDescription - describe why your app needs permission for the photo library. This is called Privacy - Photo Library Usage Description in the visual editor.

<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:

<manifest ...>
    <uses-permission
        android:name="android.permission.READ_EXTERNAL_STORAGE"
        android:maxSdkVersion="32" />
    <uses-permission android:name="android.permission.READ_MEDIA_IMAGES" />
    <uses-permission android:name="android.permission.READ_MEDIA_VIDEO" />
<manifest/>

Usage

  • Listing albums in the gallery
final List<Album> imageAlbums = await PhotoGallery.listAlbums();
final List<Album> videoAlbums = await PhotoGallery.listAlbums(
    mediumType: MediumType.video,
    newest: false,
    hideIfEmpty: false,
);
  • Listing media in an album
final MediaPage imagePage = await imageAlbum.listMedia();
final MediaPage videoPage = await imageAlbum.listMedia(
    skip: 5,
    take: 10,
);
final List<Medium> allMedia = [
    ...imagePage.items,
    ...videoPage.items,
];
  • Loading more media in a album
if (!imagePage.isLast) {
    final nextImagePage = await imagePage.nextPage();
    // ...
}
  • Getting a Medium
final Medium medium = await PhotoGallery.getMedium(
  mediumId: "10",
  mediumType: MediumType.image
);
  • Getting a file
final File file = await medium.getFile();
final File file = await PhotoGallery.getFile(mediumId: mediumId);
  • Getting thumbnail data
final List<int> data = await medium.getThumbnail();
final List<int> data = await PhotoGallery.getThumbnail(mediumId: mediumId);

You can also specify thumbnail width and height on Android API 29 or higher; You can also specify thumbnail width, height and whether provider high quality or not on iOS:

final List<int> data = await medium.getThumbnail(
    width: 128,
    height: 128,
    highQuality: true,
);
final List<int> data = await PhotoGallery.getThumbnail(
    mediumId: mediumId,
    mediumType: MediumType.image,
    width: 128,
    height: 128,
    highQuality: true,
);
  • Getting album thumbnail data
final List<int> data = await album.getThumbnail();
final List<int> data = await PhotoGallery.getAlbumThumbnail(albumId: albumId);

You can also specify thumbnail width and height on Android API 29 or higher; You can also specify thumbnail width, height and whether provider high quality or not on iOS:

final List<int> data = await album.getThumbnail(
    width: 128,
    height: 128,
    highQuality: true,
);
final List<int> data = await PhotoGallery.getAlbumThumbnail(
    albumId: albumId,
    mediumType: MediumType.image,
    newest: false,
    width: 128,
    height: 128,
    highQuality: true,
);
  • Displaying medium thumbnail

ThumbnailProvider are available to display thumbnail images (here with the help of dependency transparent_image):

FadeInImage(
    fit: BoxFit.cover,
    placeholder: MemoryImage(kTransparentImage),
    image: ThumbnailProvider(
        mediumId: mediumId,
        mediumType: MediumType.image,
        width: 128,
        height: 128,
        hightQuality: true,
    ),
)

Width and height is only available on Android API 29+ or iOS platform

  • Displaying album thumbnail

AlbumThumbnailProvider are available to display album thumbnail images (here with the help of dependency transparent_image):

FadeInImage(
    fit: BoxFit.cover,
    placeholder: MemoryImage(kTransparentImage),
    image: AlbumThumbnailProvider(
        album: album,
        width: 128,
        height: 128,
        hightQuality: true,
    ),
)

Width and height is only available on Android API 29+ or iOS platform. High quality is only available on iOS platform.

  • Displaying a full size image

You can use PhotoProvider to display the full size image (here with the help of dependency transparent_image):

FadeInImage(
    fit: BoxFit.cover,
    placeholder: MemoryImage(kTransparentImage),
    image: PhotoProvider(
        mediumId: mediumId,
    ),
)

カテゴリー

ソースリポジトリ

このパッケージを使用しているプロジェクト