Saltar al contenido principal
@capgo/capacitor-biblioteca-de-fotos Multimedia Fuente abierta

Biblioteca de fotos plugin de Capacitor

Explora, guarda y administra fotos y videos en la biblioteca de fotos 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 la Biblioteca de Fotos en Capacitor

Probar en dispositivo

Descargue la aplicación Capgo, luego escane el código QR code.

Vista previa del plugin de biblioteca de fotos code

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.

FAQ

FAQ de la biblioteca de fotos del plugin

¿Cómo instalo la biblioteca de fotos del plugin en una aplicación Capacitor?

Ejecuta "bun add @capgo/capacitor-photo-library" (o "npm install @capgo/capacitor-photo-library"), luego ejecuta "bunx cap sync" para que los proyectos iOS y Android capturen la code nativa. Importa desde "@capgo/capacitor-photo-library" en tu aplicación code.

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

Sí. La biblioteca de fotos es un paquete 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?

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

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

Sí. El código fuente de code está público en GitHub en https://github.com/Cap-go/capacitor-photo-library/ y el paquete es gratuito para instalar desde npm. Se aceptan informes de errores y solicitudes de cambios.

Puedo actualizar code que utiliza la biblioteca de fotos sin una revisión de la Tienda de Aplicaciones?

Instalar o actualizar el plugin cambia la code nativa, por lo que necesita una nueva compilación de la tienda. Después de eso, los cambios en JavaScript, HTML y CSS que llaman al plugin pueden enviar directamente con Capgo actualizaciones en vivo.

Envía cambios de la biblioteca de fotos sin esperar a la revisión del app.

Una vez que el plugin esté en tu tienda de construcción, Capgo actualizaciones en vivo envían cambios en JavaScript, HTML y CSS a los usuarios en minutos.

Inicia con Capgo