Salta al contenuto principale

Libreria foto Plugin Capacitor

Sfoglia, salva e gestisci foto e video nella libreria foto del dispositivo con i permessi

Installa

bun add @capgo/capacitor-photo-library bunx cap sync
npm, pnpm o yarn
  • npm install @capgo/capacitor-photo-library
  • pnpm add @capgo/capacitor-photo-library
  • yarn add @capgo/capacitor-photo-library

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 di sistema, consentendo all'utente di scegliere i media senza concedere l'accesso completo alla libreria foto. I file selezionati vengono copiati nella cache dell'applicazione e restituiti con URL portabili.

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 Using @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.

FAQ

FAQ del plugin Photo Library

Come installo il plugin Photo Library in un'app Capacitor?

Esegui "bun add @capgo/capacitor-photo-library" (oppure "npm install @capgo/capacitor-photo-library"), poi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino il codice nativo code. Importalo da "@capgo/capacitor-photo-library" nel tuo code dell'app.

@capgo/capacitor-photo-library funziona con React, Vue e Angular?

Sì. Photo Library è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che gira dentro Capacitor, incluso Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Quale versione di Capacitor supporta @capgo/capacitor-photo-library?

I plugin Capgo seguono la major version di Capacitor: usa la major version del plugin che corrisponde alla tua major version di Capacitor (ad esempio plugin v8 con Capacitor 8). La tabella di compatibilità nel README di GitHub elenca le versioni mantenute.

È @capgo/capacitor-photo-library gratuito e open source?

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-photo-library/ e il pacchetto si installa gratuitamente da npm. Bug report e pull request sono benvenuti.

Posso aggiornare code che usa Photo Library senza passare per la revisione dell'App Store?

Installare o aggiornare il plugin modifica il code nativo, quindi serve una nuova build per lo store. Dopo, le modifiche a JavaScript, HTML e CSS che chiamano il plugin possono essere rilasciate subito con le live updates di Capgo.

Rilascia le modifiche a Photo Library senza attendere la revisione dell'app

Una volta incluso il plugin nel tuo store build, Capgo invia le modifiche a JavaScript, HTML e CSS tramite live updates in pochi minuti.

Inizia con Capgo