Guía
Cómo usar Photo Library en Capacitor
Usando @capgo/capacitor-photo-library
El plugin Capacitor muestra la galería de fotos como una web o una aburrida pantalla nativa sin personalización pero sin pedir permisos.
Instalar
bun add @capgo/capacitor-photo-library
bunx cap sync
bunx cap sync copia el code nativo del plugin en tus proyectos nativos. Ejecútalo de nuevo tras cada actualización del plugin.
Importar
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
API de un vistazo
| Método | Descripción |
|---|---|
checkAuthorization |
Devuelve el estado de autorización actual sin mostrar un prompt al usuario. |
requestAuthorization |
Solicita acceso a la biblioteca de fotos si es necesario. |
getAlbums |
Obtiene los álbumes disponibles. |
getLibrary |
Obtiene los assets de la biblioteca junto con las URLs para mostrar en la web view. |
getPhotoUrl |
Obtiene una URL visualizable de la versión en alta resolución del asset. Si ya llamaste a getLibrary con includeFullResolutionData, normalmente no necesitarás este método. |
getThumbnailUrl |
Obtiene una URL visualizable para una miniatura redimensionada del asset. |
pickMedia |
Abre el selector nativo del sistema para que el usuario elija archivos sin dar acceso total a su galería. Los archivos se copian al caché de la app y se devuelven con URLs portátiles. |
Ejemplos
checkAuthorization()
Devuelve el estado de autorización actual sin mostrar un prompt al usuario.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.checkAuthorization();
console.log(result);
requestAuthorization()
Solicita acceso a la librería de fotos si es necesario.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.requestAuthorization();
console.log(result);
getAlbums()
Obtiene los álbumes disponibles.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.getAlbums();
console.log(result);
getLibrary()
Obtiene los assets de la librería junto con URLs que pueden mostrarse en la web view.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.getLibrary();
console.log(result);
getPhotoUrl()
Obtiene una URL visualizable para la versión en resolución completa del asset. Si ya llamaste a getLibrary con includeFullResolutionData, normalmente no necesitarás este método.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.getPhotoUrl({ id: 'id-123' });
console.log(result);
getThumbnailUrl()
Obtiene una URL visualizable para una miniatura redimensionada del asset.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.getThumbnailUrl({ id: 'id-123' });
console.log(result);
La tabla anterior enumera los 7 métodos principales. Los helpers de versión y listeners, así como el contrato completo de cada método, están documentados en la repositorio GitHub.
Referencia completa
Continúa desde Uso de @capgo/capacitor-photo-library
Si estás usando Usando @capgo/capacitor-photo-library para planificar el comportamiento de los medios nativos y la interfaz, conéctalo con @capgo/capacitor-photo-library para el detalle de implementación en @capgo/capacitor-photo-library, Primeros pasos para los detalles de implementación en Primeros pasos, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-live-activities para el detalle de implementación en @capgo/capacitor-live-activities, y Uso de @capgo/capacitor-video-player para la capacidad nativa en Uso de @capgo/capacitor-video-player.