Guida
Come utilizzare File Picker in Capacitor
Utilizzo di @capgo/capacitor-file-picker
Interfaccia del plugin Capacitor File Picker per la selezione di file, immagini, video e directory.
Installa
bun add @capgo/capacitor-file-picker
bunx cap sync
bunx cap sync copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.
Importa
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
API in un colpo d'occhio
| Metodo | Descrizione |
|---|---|
pickFiles |
Scegli uno o più file dal dispositivo. |
pickImages |
Scegli uno o più immagini dalla galleria. Disponibile solo per Android e iOS. |
pickVideos |
Scegli uno o più video dalla galleria. Disponibile solo per Android e iOS. |
pickMedia |
Scegli uno o più immagini o video dalla galleria. Disponibile solo per Android e iOS. |
pickDirectory |
Scegli una directory dal dispositivo. Disponibile solo per Android e iOS. |
convertHeicToJpeg |
Converti un'immagine HEIC in formato JPEG. Disponibile solo per iOS. |
copyFile |
Copia un file in una nuova posizione. |
checkPermissions |
Controlla lo stato delle autorizzazioni di archiviazione o media. Le flussi di picker non dovrebbero bloccare l'accesso. pickFiles(), pickImages(), pickVideos(), or pickMedia() Sulla autorizzazione di questo permesso su Android 13+. Solo Android. |
requestPermissions |
Richiedi le autorizzazioni di archiviazione o media. Non richiedere o dichiarare READ_MEDIA_IMAGES Scegliere READ_MEDIA_VIDEO Usa solo le API del picker. Google Play consente queste autorizzazioni solo quando le alternative del picker non sono sufficienti per la funzionalità di base dell'app. @capgo/capacitor-file-picker Metodi del picker per l'accesso a file, immagini o video selezionati dall'utente. Disponibile solo per Android. |
Esempi
pickFiles()
Scegli uno o più file dal dispositivo.
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()
Scegli uno o più immagini dalla galleria. Solo 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()
Scegli uno o più video dalla galleria. Solo 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()
Scegli uno o più immagini o video dalla galleria. Solo 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()
Scegli un directory dal dispositivo. Solo Android/iOS.
import { CapgoFilePicker } from '@capgo/capacitor-file-picker';
const result = await CapgoFilePicker.pickDirectory();
console.log('Selected directory:', result.path);
convertHeicToJpeg()
Converti un'immagine HEIC in formato JPEG. Solo per 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);
La tabella sopra elenca le 9 metodi di base. I listener e gli aiuti di versione, e il contratto completo di ogni metodo, sono documentati nel repository di GitHub.
Ascolta gli eventi
addListener ritorna un handle. Chiama handle.remove() quando lo schermo viene smontato, o CapgoFilePicker.removeAllListeners() per cancellare ogni listener.
Riferimento completo
Continua da Utilizza @capgo/capacitor-file-picker
If stai utilizzando Utilizzando @capgo/capacitor-file-picker per pianificare lo storage e la gestione dei file, collega @capgo/capacitor-file-picker per i dettagli di implementazione in @capgo/capacitor-file-picker, Getting Started per i dettagli di implementazione in Avvio, @capgo/capacitor-archiviazione-dati-sqlite per i dettagli di implementazione in @capgo/capacitor-data-storage-sqlite, Utilizzando @capgo/capacitor-data-storage-sqlite per la capacità nativa in Utilizzando @capgo/capacitor-data-storage-sqlite, e @capgo/capacitor-file per la dettagliata implementazione in @capgo/capacitor-file.