Saltare al contenuto principale

Libreria delle foto plugin Capacitor

Esplora, salva e gestisci foto e video nella libreria di foto del dispositivo con le autorizzazioni

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 utilizzare la libreria di foto in Capacitor

Testa sul dispositivo

Scarica l'app Capgo, poi scansa il codice QR code.

Anteprima del plugin Photo Library QR code

Utilizza @capgo/capacitor-photo-library

Capacitor plugin Mostra la galleria di foto come pagina web, o schermo nativo noioso che non puoi modificare ma richiede nessuna autorizzazione.

Installa

bun add @capgo/capacitor-photo-library
bunx cap sync

bunx cap sync Copia il plugin nativo code nei tuoi progetti nativi. Esegui nuovamente dopo ogni aggiornamento del plugin.

Importa

import { PhotoLibrary } from '@capgo/capacitor-photo-library';

Vista d'insieme di API

Metodo Description
checkAuthorization Restituisce lo stato di autorizzazione corrente senza sollecitare l'utente.
requestAuthorization Richiede l'accesso alla libreria delle foto se necessario.
getAlbums Recupera gli album disponibili.
getLibrary Recupera gli asset della libreria insieme alle URL che possono essere visualizzate nella vista web.
getPhotoUrl Recupera una URL visualizzabile per la versione a risoluzione completa dell'asset. Se hai già chiamato getLibrary con includeFullResolutionDatanormalmente non hai bisogno di questo metodo.
getThumbnailUrl Recupera una URL visualizzabile per una miniatura ridimensionata dell'asset.
pickMedia Apre il picker di sistema nativo in modo che l'utente possa selezionare i media senza concedere l'accesso completo alla libreria delle foto. I file selezionati vengono copiati nella cache dell'applicazione e restituiti con URL portabili.

Esempi

checkAuthorization()

Restituisce lo stato di autorizzazione corrente senza sollecitare l'utente.

import { PhotoLibrary } from '@capgo/capacitor-photo-library';

const result = await PhotoLibrary.checkAuthorization();
console.log(result);

requestAuthorization()

Richiede l'accesso alla libreria delle 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 alle URL che possono essere visualizzate nella vista web.

import { PhotoLibrary } from '@capgo/capacitor-photo-library';

const result = await PhotoLibrary.getLibrary();
console.log(result);

getPhotoUrl()

Recupera una URL visualizzabile per la versione a risoluzione completa dell'asset. Se hai già chiamato getLibrary con includeFullResolutionDatanormalmente 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 una 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 di base. Gli ascoltatori e gli aiuti di versione, e il contratto completo di ogni metodo, sono documentati nel repository GitHub.

Riferimento completo

Continua da Utilizzare @capgo/capacitor-photo-library

Se stai utilizzando Utilizzare @capgo/capacitor-photo-library per pianificare il comportamento dei media e dell'interfaccia nativa, collega a @capgo/capacitor-photo-library per i dettagli di implementazione in @capgo/capacitor-photo-library Guida per l'uso per i dettagli di implementazione in Guida per l'uso Utilizzare @capgo/capacitor-live-activities per la capacità nativa in Utilizzare @capgo/capacitor-live-activities @capgo/capacitor-attività-in-vivo per i dettagli di implementazione in @capgo/capacitor-live-attività, e Utilizzando @capgo/capacitor-video-player per la capacità nativa in Utilizzando @capgo/capacitor-video-player.

FAQ

FAQ della libreria di foto

Come posso installare la libreria di foto in un'app Capacitor?

Esegui "bun add @capgo/capacitor-photo-library" (o "npm install @capgo/capacitor-photo-library"), quindi esegui "bunx cap sync" affinché i progetti iOS e Android recuperino la code nativa. Importalo da "@capgo/capacitor-photo-library" nella tua app code.

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

Sì. La libreria di foto è un pacchetto Capacitor, quindi funziona con qualsiasi framework web che esegue all'interno di Capacitor, compresi Ionic, React, Vue, Angular, Svelte e JavaScript puro.

Qual è la versione di Capacitor supportata da @capgo/capacitor-photo-library?

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

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

Sì. Il codice sorgente di code è pubblico su GitHub all'indirizzo https://github.com/Cap-go/capacitor-photo-library/ e il pacchetto è gratuito da installare su npm. Sono accetti i rapporti di bug e le richieste di pull.

Posso aggiornare code che utilizza la libreria di foto senza una revisione dell'App Store?

L'installazione o l'aggiornamento del plugin modifica la code nativa, quindi richiede una nuova costruzione del store. Dopo di che, le modifiche JavaScript, HTML e CSS che chiamano il plugin possono essere distribuite immediatamente con Capgo live updates.

Consegna modifiche alla libreria di foto senza attendere la revisione dell'app

Una volta che il plugin è nel tuo store di build, Capgo aggiornamenti in tempo reale inviano le tue modifiche JavaScript, HTML e CSS agli utenti in pochi minuti.

Inizia con Capgo