メインコンテンツにジャンプ
@capgo/capacitor-ファイルピッカー ファイルとストレージ オープンソース

ファイルピッカー Capacitor プラグイン

iOS と Android 向けの完全なネイティブサポートを備えたファイル、画像、動画、ディレクトリの選択

インストール

bun add @capgo/capacitor-file-picker bunx cap sync
npm、pnpm または yarn
  • npm install @capgo/capacitor-file-picker
  • pnpm add @capgo/capacitor-file-picker
  • yarn add @capgo/capacitor-file-picker

ガイド

How to use File Picker in Capacitor

Using @capgo/capacitor-file-picker

Capacitor ファイルピッカー プラグイン ファイル、画像、動画、ディレクトリの選択に使用するインターフェイスです。

インストール

bun add @capgo/capacitor-file-picker
bunx cap sync

bunx cap sync プラグインのネイティブ code をプロジェクトのネイティブにコピーします。プラグインのアップグレード後は再度実行してください。

インポート

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

APIの概要

メソッド 説明
pickFiles デバイスから1つ以上のファイルを選択します。
pickImages デバイスから1つ以上の画像を選択します。Android/iOSのみ。
pickVideos デバイスから1つ以上の動画を選択します。Android/iOSのみ。
pickMedia デバイスから1つ以上の画像または動画を選択します。Android/iOSのみ。
pickDirectory デバイスからディレクトリを選択します。Android/iOSのみ。
convertHeicToJpeg iOSのみでHEIC画像をJPEG形式に変換します。
copyFile ファイルを新しい場所にコピーします。
checkPermissions ストレージまたはメディアの許可状態を確認してください。ピッカー専用フローはAndroid 13以降にこの許可をゲートしてはなりません。 pickFiles(), pickImages(), pickVideos()、または pickMedia() この許可をAndroid 13以降にゲートしてはなりません。Androidのみ。
requestPermissions ストレージまたはメディアの許可を要求してください。許可を要求したり宣言したりしてはなりません。 READ_MEDIA_IMAGES 、または READ_MEDIA_VIDEO APIを使用する場合のみ、ピッカーAPIを使用してください。Google Playでは、ピッカー代替がコアアプリ機能に不十分な場合にのみ、これらの許可を許可します。 @capgo/capacitor-file-picker ファイル、画像、または動画のユーザー選択されたアクセスに対してピッカーのメソッドを使用するのではなく、Androidのみ。

例

pickFiles()

デバイスから 1 つまたは複数のファイルを選択してください。

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickFiles({
  types: ['application/pdf', 'image/*'],
  limit: 5,
  readData: false
});
console.log('Picked files:', result.files);

pickImages()

ギャラリーから 1 つまたは複数の画像を選択してください。Android/iOSのみ。

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickImages({
  limit: 10,
  readData: false
});
console.log('Picked images:', result.files);

pickVideos()

ギャラリーから 1 つまたは複数の動画を選択してください。Android/iOSのみ。

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickVideos({
  limit: 3,
  skipTranscoding: true
});
console.log('Picked videos:', result.files);

pickMedia()

ギャラリーから 1 つまたは複数の画像または動画を選択してください。Android/iOSのみ。

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickMedia({
  limit: 5,
  readData: true
});
console.log('Picked media:', result.files);

pickDirectory()

デバイスからフォルダを選択してください。 Android/iOSのみ。

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.pickDirectory();
console.log('Selected directory:', result.path);

convertHeicToJpeg()

HEIC画像をJPEG形式に変換します。 iOSのみ。

import { CapgoFilePicker } from '@capgo/capacitor-file-picker';

const result = await CapgoFilePicker.convertHeicToJpeg({
  path: '/path/to/image.heic',
  quality: 0.9
});
console.log('Converted file:', result.path);

上の表にリストされている9つの基本メソッドが記載されています。リスナーとバージョンヘルパー、各メソッドのフルコントラクトは、以下の__CAPGO_KEEP_0__リポジトリに記載されています。 GitHub リポジトリ.

ハンドルを返します。画面がアンマウントされたとき、または

addListener すべてのリスナーをクリアするには handle.remove() フルリファレンス CapgoFilePicker.removeAllListeners() ドキュメント

__CAPGO_KEEP_0__リファレンス

@capgo/capacitor-ファイルピッカーから続けてください

Capacitorファイルピッカーを使用している場合 Using @capgo/capacitor-file-picker Capacitorファイルピッカーを接続して @capgo/capacitorファイルピッカー @capgo/capacitorファイルピッカーの実装詳細について CapacitorデータストレージSQLite CapacitorデータストレージSQLiteの実装詳細 @capgo/capacitor-データストレージ-SQLite @capgo/capacitorデータストレージ(SQLite) @capgo/capacitorデータストレージ(SQLite) for the native capability in capgo/capacitor-data-storage-sqliteを使用し、 @capgo/capacitorファイル @capgo/capacitorファイルの実装詳細のために

FAQ

ファイルピッカー プラグイン FAQ

Capacitorファイルピッカー プラグインを Capacitor アプリにインストールする方法は何ですか。

Run "bun add @capgo/capacitor-file-picker" (or "npm install @capgo/capacitor-file-picker"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-file-picker" in your app code.

@capgo/capacitor-file-picker は React、Vue、Angular とどのように動作しますか?

Yes. File Picker is a Capacitor package, so it works with any web framework that runs inside Capacitor, including Ionic, React, Vue, Angular, Svelte and plain JavaScript.

Which Capacitor version does @capgo/capacitor-file-picker support?

Capgo plugins follow Capacitor's major version: use the plugin major version that matches your Capacitor major version (for example plugin v8 with Capacitor 8). The compatibility table in the GitHub README lists the maintained versions.

@capgo/capacitor-file-picker は無料でオープンソースですか?

Yes. The source code is public on GitHub at https://github.com/Cap-go/capacitor-file-picker/ and the package is free to install from npm. Bug reports and pull requests are welcome.

アップデート code がファイル ピッカーを使用している場合、アプリ ストアのレビューなしでアップデートできますか。

Installing or upgrading the plugin changes native code, so it needs a new store build. After that, JavaScript, HTML and CSS changes that call the plugin can ship instantly with Capgo live updates.

アプリレビューの待たずにファイルピッカーの変更を配信

プラグインがストアビルドに追加されたら、Capgoライブアップデートは、ユーザーにJavaScript、HTML、CSSの変更を数分で反映します。

始めにCapgo