Guía
Cómo usar Photo Library en Capacitor
Usando @capgo/capacitor-photo-library
Plugin Capacitor Muestra la galería de fotos como página web o como pantalla nativa básica que no puedes modificar, pero que no requiere autorización.
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 pedir permiso al usuario. |
requestAuthorization |
Solicita acceso a la biblioteca de fotos si es necesario. |
getAlbums |
Recupera los álbumes disponibles. |
getLibrary |
Obtiene los recursos de la librería junto con las URLs para mostrarlos en la web view. |
getPhotoUrl |
Obtiene una URL visualizable para la versión del activo en resolución completa. Si ya llamaste a getLibrary con includeFullResolutionData, normalmente no necesitas este método. |
getThumbnailUrl |
Obtiene una URL para mostrar una miniatura redimensionada del recurso. |
pickMedia |
Abre el selector nativo del sistema para que el usuario elija contenido multimedia sin conceder acceso completo a la fototeca. Los archivos seleccionados se copian en la caché de la aplicación y se devuelven con URLs portables. |
Ejemplos
checkAuthorization()
Devuelve el estado de autorización actual sin pedir permiso al usuario.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.checkAuthorization();
console.log(result);
requestAuthorization()
Solicita acceso a la biblioteca de fotos si es necesario.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.requestAuthorization();
console.log(result);
getAlbums()
Recupera los álbumes disponibles.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.getAlbums();
console.log(result);
getLibrary()
Obtiene los recursos de la librería junto con las URLs para mostrarlos 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 necesitas 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 para mostrar una miniatura redimensionada del recurso.
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.