ガイド
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ファイルの実装詳細のために