Saltar al contenido principal
@capgo/capacitor-photo-library Multimedia Código abierto

Librería de fotos plugin Capacitor

Explora, guarda y gestiona fotos y vídeos en la galería del dispositivo con permisos

Instalar

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

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.

FAQ

Preguntas frecuentes del plugin Photo Library

¿Cómo instalo el plugin Photo Library en una app de Capacitor?

Run "bun add @capgo/capacitor-photo-library" (or "npm install @capgo/capacitor-photo-library"), then run "bunx cap sync" so the iOS and Android projects pick up the native code. Import it from "@capgo/capacitor-photo-library" in your app code.

¿Funciona @capgo/capacitor-photo-library con React, Vue y Angular?

Sí. Photo Library es un paquete de Capacitor, por lo que funciona con cualquier framework web que se ejecute dentro de Capacitor, incluyendo Ionic, React, Vue, Angular, Svelte y JavaScript puro.

¿Qué versión de Capacitor soporta @capgo/capacitor-photo-library?

Los plugins de Capgo siguen la versión mayor de Capacitor: usa la versión mayor del plugin que coincida con la versión mayor de tu Capacitor (por ejemplo, el plugin v8 con Capacitor 8). La tabla de compatibilidad del README de GitHub lista las versiones mantenidas.

¿Es @capgo/capacitor-photo-library gratuito y de código abierto?

Sí. El código fuente de code es público en GitHub: https://github.com/Cap-go/capacitor-photo-library/, y el paquete se puede instalar gratis desde npm. Se agradecen los reportes de bugs y los pull requests.

¿Puedo actualizar code que usa Photo Library sin pasar por la revisión de la App Store?

Instalar o actualizar el plugin cambia el code nativo, así que requiere un nuevo build para la tienda. Después, los cambios de JavaScript, HTML y CSS que llamen al plugin se pueden publicar al instante con las live updates de Capgo.

Publica cambios en Photo Library sin esperar la revisión de la app

Una vez que el plugin esté en tu store build, Capgo live updates envía tus cambios de JavaScript, HTML y CSS a los usuarios en minutos.

Empieza con Capgo