Guida
Come usare Photo Library in Capacitor
Uso di @capgo/capacitor-photo-library
Il plugin Capacitor visualizza la galleria fotografica come una pagina web, evitando le noiose schermate native non modificabili che non richiedono autorizzazioni.
Installa
bun add @capgo/capacitor-photo-library
bunx cap sync
bunx cap sync copia i code nativi del plugin nei tuoi progetti nativi. Eseguilo di nuovo dopo ogni aggiornamento del plugin.
Importa
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
API in breve
| Metodo | Descrizione |
|---|---|
checkAuthorization |
Restituisce lo stato di autorizzazione attuale senza mostrare prompt all'utente. |
requestAuthorization |
Richiede l'accesso alla libreria foto, se necessario. |
getAlbums |
Recupera gli album disponibili. |
getLibrary |
Recupera gli asset della libreria insieme agli URL visualizzabili nella web view. |
getPhotoUrl |
Recupera un URL visualizzabile per la versione a piena risoluzione dell'asset. Se hai già chiamato getLibrary con includeFullResolutionData, di solito non hai bisogno di questo metodo. |
getThumbnailUrl |
Recupera un URL visualizzabile per una miniatura ridimensionata dell'asset. |
pickMedia |
Apre il selettore nativo del sistema, permettendo all'utente di selezionare i media senza dover concedere l'accesso completo alla libreria foto. I file selezionati vengono copiati nella cache dell'app e restituiti tramite URL portatili. |
Esempi
checkAuthorization()
Restituisce lo stato di autorizzazione attuale senza mostrare prompt all'utente.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.checkAuthorization();
console.log(result);
requestAuthorization()
Richiede l'accesso alla libreria foto, se necessario.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.requestAuthorization();
console.log(result);
getAlbums()
Recupera gli album disponibili.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.getAlbums();
console.log(result);
getLibrary()
Recupera gli asset della libreria insieme agli URL visualizzabili nella web view.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.getLibrary();
console.log(result);
getPhotoUrl()
Recupera un URL visualizzabile per la versione a piena risoluzione dell'asset. Se hai già chiamato getLibrary con includeFullResolutionData, di solito non hai bisogno di questo metodo.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.getPhotoUrl({ id: 'id-123' });
console.log(result);
getThumbnailUrl()
Recupera un URL visualizzabile per una miniatura ridimensionata dell'asset.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.getThumbnailUrl({ id: 'id-123' });
console.log(result);
La tabella sopra elenca i 7 metodi core. Gli helper per listener e versione e il contratto completo di ogni metodo sono documentati in repository GitHub.
Riferimento completo
Continua da Usare @capgo/capacitor-photo-library
Se stai usando Uso di @capgo/capacitor-photo-library per pianificare il comportamento dei media nativi e dell'interfaccia, collegalo a @capgo/capacitor-photo-library per i dettagli di implementazione in @capgo/capacitor-photo-library, Per iniziare per i dettagli di implementazione nella guida introduttiva, Uso di @capgo/capacitor-live-activities per la funzionalità nativa nella pagina Uso di @capgo/capacitor-live-activities, @capgo/capacitor-live-activities per i dettagli di implementazione in @capgo/capacitor-live-activities, e Uso di @capgo/capacitor-video-player per la funzionalità nativa in Usare @capgo/capacitor-video-player.