Guía
Cómo usar la Biblioteca de Fotos en Capacitor
Usando @capgo/capacitor-biblioteca-de-fotos
Plugin de Capacitor Muestra la galería de fotos como página web, o pantalla nativa aburrida que no puedes modificar pero no requiere autorización.
Instalar
bun add @capgo/capacitor-photo-library
bunx cap sync
bunx cap sync Copia el plugin de code nativo en tus proyectos nativos. Ejecútalo de nuevo después de cada actualización del plugin.
Importar
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
Vista general de API
| Método | Ejemplo de uso |
|---|---|
checkAuthorization |
Devuelve el estado de autorización actual sin solicitar al usuario. |
requestAuthorization |
Solicita acceso a la biblioteca de fotos si es necesario. |
getAlbums |
Obtiene los álbumes disponibles. |
getLibrary |
Obtiene los activos de la biblioteca junto con las URL que se pueden mostrar en la vista web. |
getPhotoUrl |
Obtiene una URL para mostrar la versión de alta resolución del activo. Si ya llamaste a getLibrary con includeFullResolutionDatanormalmente no necesitas este método. |
getThumbnailUrl |
Obtiene una URL para mostrar una miniatura redimensionada del activo. |
pickMedia |
Abre el selector nativo del sistema para que el usuario pueda seleccionar medios sin conceder acceso completo a la biblioteca de fotos. Los archivos seleccionados se copian en la caché de la aplicación y se devuelven con URLs portátiles. |
Ejemplos
checkAuthorization()
Devuelve el estado de autorización actual sin solicitar al usuario.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.checkAuthorization();
console.log(result);
requestAuthorization()
Si es necesario, solicita acceso a la biblioteca de fotos.
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 activos de la biblioteca junto con URLs que se pueden mostrar en la vista de la web.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.getLibrary();
console.log(result);
getPhotoUrl()
Obtiene una URL para mostrar la versión de alta resolución del activo. Si ya llamaste a __CAPGO_KEEP_0__ getLibrary con includeFullResolutionDatanormalmente 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 activo.
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 básicos. Los ayudantes de escucha y versión, y la contrato completo de cada método, se documentan en el repositorio de GitHub.
Referencia completa
Continúa desde Uso de @capgo/capacitor-photo-library
Si estás utilizando Uso de @capgo/capacitor-photo-library para planificar el comportamiento de medios y interfaz nativa, conecta con @capgo/capacitor-photo-library para el detalle de implementación en @capgo/capacitor-photo-library, Getting Started para el detalle de implementación en Inicio, Uso de @capgo/capacitor-live-activities para la capacidad nativa en Uso de @capgo/capacitor-live-activities, @capgo/capacitor-actividades en vivo para los detalles de implementación en @capgo/capacitor-actividades-en-vivo, y Usando @capgo/capacitor-reproductor-de-videos para la capacidad nativa en Usando @capgo/capacitor-reproductor-de-videos.