Panduan
Cara menggunakan File Picker di Capacitor
Menggunakan @capgo/capacitor-file-picker
Antarmuka plugin Capacitor File Picker untuk memilih file, gambar, video, dan direktori.
Instal
bun add @capgo/capacitor-file-picker
bunx cap sync
bunx cap sync menyalin code native plugin ke dalam proyek native Anda. Jalankan kembali setiap kali melakukan upgrade plugin.
Impor
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
Sekilas tentang API
| 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 |
Konversi gambar HEIC ke format JPEG. Hanya iOS. |
copyFile |
Salin file ke lokasi baru. |
checkPermissions |
Cek status izin media atau storage luas. Alur khusus Picker tidak boleh bergantung pickFiles(), pickImages(), pickVideos(), atau pickMedia() pada izin ini di Android 13+. Khusus Android. |
requestPermissions |
Minta izin media atau storage luas. Jangan meminta atau mendeklarasikan izin READ_MEDIA_IMAGES atau READ_MEDIA_VIDEO hanya untuk menggunakan API picker. Google Play hanya mengizinkan izin ini jika alternatif picker tidak cukup untuk fungsi utama aplikasi. Gunakan @capgo/capacitor-file-picker metode picker untuk akses file, gambar, atau video pilihan user. Khusus Android. |
Contoh
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. Khusus 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()
Pilih satu atau lebih video dari galeri. Khusus 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()
Pilih satu atau lebih gambar atau video dari galeri. Khusus 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 mencantumkan 9 metode inti. Listener, helper versi, dan kontrak lengkap setiap metode didokumentasikan di repositori GitHub.
Mendengarkan event
addListener mengembalikan sebuah handle. Panggil handle.remove() saat layar di-unmount, atau CapgoFilePicker.removeAllListeners() untuk menghapus semua listener.
Referensi lengkap
Lanjutkan dari bagian Menggunakan @capgo/capacitor-file-picker
Jika Anda menggunakan Menggunakan @capgo/capacitor-file-picker untuk merencanakan penyimpanan dan penanganan file, hubungkan dengan @capgo/capacitor-file-picker untuk detail implementasi di @capgo/capacitor-file-picker, Panduan Memulai untuk detail implementasi di Getting Started, @capgo/capacitor-data-storage-sqlite untuk detail implementasi di @capgo/capacitor-data-storage-sqlite, Menggunakan @capgo/capacitor-data-storage-sqlite untuk kemampuan native di bagian Menggunakan @capgo/capacitor-data-storage-sqlite, dan @capgo/capacitor-file untuk detail implementasi di @capgo/capacitor-file.