Panduan
Cara menggunakan Picker File di Capacitor
Menggunakan @capgo/capacitor-picker-file
Antarmuka Plugin Picker File Capacitor untuk memilih file, gambar, video, dan direktori.
Instal
bun add @capgo/capacitor-file-picker
bunx cap sync
bunx cap sync Menggandakan plugin asli code ke dalam proyek-proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.
Import
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
API secara singkat
| Metode | Deskripsi |
|---|---|
pickFiles |
Pilih satu atau lebih file dari perangkat. |
pickImages |
Pilih satu atau lebih gambar dari galeri. Hanya Android/iOS. |
pickVideos |
Pilih satu atau lebih video dari galeri. Hanya Android/iOS. |
pickMedia |
Pilih satu atau lebih gambar atau video dari galeri. Hanya Android/iOS. |
pickDirectory |
Pilih direktori dari perangkat. Hanya Android/iOS. |
convertHeicToJpeg |
Mengonversi gambar HEIC ke format JPEG. Hanya iOS. |
copyFile |
Menggandakan file ke lokasi baru. |
checkPermissions |
Periksa status izin penyimpanan luas atau media. Aliran picker hanya tidak boleh mengunci pickFiles(), pickImages(), pickVideos()atau pickMedia() izin ini pada Android 13+. Hanya Android. |
requestPermissions |
Minta izin penyimpanan luas atau media. Jangan minta atau deklarasikan READ_MEDIA_IMAGES atau READ_MEDIA_VIDEO Hanya untuk menggunakan API pilihan. Google Play memungkinkan akses izin ini hanya ketika alternatif pilihan tidak cukup untuk fungsi aplikasi utama. Gunakan @capgo/capacitor-file-picker Menggunakan metode pemilih file, gambar, atau video yang dipilih pengguna. Hanya tersedia untuk Android. |
Examples
pickFiles()
Pilih satu atau lebih file dari perangkat.
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()
Pilih satu atau lebih gambar dari galeri. Hanya tersedia untuk Android dan iOS.
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickImages({
limit: 10,
readData: false
});
console.log('Picked images:', result.files);
pickVideos()
Pilih satu atau lebih video dari galeri. Hanya tersedia untuk Android dan iOS.
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickVideos({
limit: 3,
skipTranscoding: true
});
console.log('Picked videos:', result.files);
pickMedia()
Pilih satu atau lebih gambar dari galeri. Hanya 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()
Pilih direktori dari perangkat. Hanya Android/iOS.
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickDirectory();
console.log('Selected directory:', result.path);
convertHeicToJpeg()
Konversi gambar HEIC ke format JPEG. Hanya 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);
Tabel di atas menampilkan 9 metode inti. Bantuan listener dan versi, serta kontrak lengkap dari setiap metode, dapat ditemukan di repository GitHub.
Dengarkan event
addListener mengembalikan sebuah handle. Panggil handle.remove() ketika layar dihapus, atau CapgoFilePicker.removeAllListeners() untuk membersihkan setiap pemanggil.
Referensi lengkap
Lanjutkan dari Menggunakan @capgo/capacitor-file-picker
Jika Anda menggunakan Menggunakan @capgo/capacitor-file-picker untuk merencanakan penyimpanan dan pengelolaan file, hubungkannya dengan @capgo/capacitor-file-picker untuk detail implementasi di @capgo/capacitor-file-picker, Mulai Menggunakan untuk detail implementasi di Getting Started, @capgo/capacitor-penyimpanan-data-sqlite untuk detail implementasi di @capgo/capacitor-data-storage-sqlite, Menggunakan @capgo/capacitor-data-storage-sqlite untuk kemampuan native di Menggunakan @capgo/capacitor-data-storage-sqlite, dan @capgo/capacitor-file untuk detail implementasi di @capgo/capacitor-file.