Aller au contenu principal

Photothèque Plugin Capacitor

Parcourir, enregistrer et gérer les photos et vidéos de la photothèque de l'appareil avec les permissions

Installer

bun add @capgo/capacitor-photo-library bunx cap sync
npm, pnpm ou yarn
  • npm install @capgo/capacitor-photo-library
  • pnpm add @capgo/capacitor-photo-library
  • yarn add @capgo/capacitor-photo-library

Guide

Comment utiliser Photo Library dans Capacitor

Utiliser @capgo/capacitor-photo-library

Le plugin Capacitor affiche la galerie photo comme une page web, ou comme un écran natif ennuyeux que vous ne pouvez pas modifier mais qui ne nécessite aucune autorisation.

Installer

bun add @capgo/capacitor-photo-library
bunx cap sync

bunx cap sync copie le code natif du plugin dans vos projets natifs. Relancez-l’après chaque mise à jour du plugin.

Importer

import { PhotoLibrary } from '@capgo/capacitor-photo-library';

Aperçu de API

Méthode Description
checkAuthorization Renvoie le statut d'autorisation actuel sans solliciter l'utilisateur.
requestAuthorization Demande l'accès à la photothèque si nécessaire.
getAlbums Récupère les albums disponibles.
getLibrary Récupère les assets de la bibliothèque ainsi que les URL affichables dans la WebView.
getPhotoUrl Récupère une URL affichable pour la version en pleine résolution de l'asset. Si vous avez déjà appelé getLibrary par includeFullResolutionData, vous n'avez généralement pas besoin de cette méthode.
getThumbnailUrl Récupère une URL affichable pour une miniature redimensionnée de l’asset.
pickMedia Ouvre le sélecteur système natif pour que l’utilisateur puisse choisir des médias sans accorder l’accès complet à la bibliothèque photo. Les fichiers sélectionnés sont copiés dans le cache de l’application et renvoyés avec des URLs portables.

Exemples

checkAuthorization()

Renvoie le statut d'autorisation actuel sans solliciter l'utilisateur.

import { PhotoLibrary } from '@capgo/capacitor-photo-library';

const result = await PhotoLibrary.checkAuthorization();
console.log(result);

requestAuthorization()

Demande l'accès à la photothèque si nécessaire.

import { PhotoLibrary } from '@capgo/capacitor-photo-library';

const result = await PhotoLibrary.requestAuthorization();
console.log(result);

getAlbums()

Récupère les albums disponibles.

import { PhotoLibrary } from '@capgo/capacitor-photo-library';

const result = await PhotoLibrary.getAlbums();
console.log(result);

getLibrary()

Récupère les assets de la bibliothèque ainsi que les URL affichables dans la WebView.

import { PhotoLibrary } from '@capgo/capacitor-photo-library';

const result = await PhotoLibrary.getLibrary();
console.log(result);

getPhotoUrl()

Récupère une URL affichable pour la version en pleine résolution de l'asset. Si vous avez déjà appelé getLibrary par includeFullResolutionData, vous n'avez généralement pas besoin de cette méthode.

import { PhotoLibrary } from '@capgo/capacitor-photo-library';

const result = await PhotoLibrary.getPhotoUrl({ id: 'id-123' });
console.log(result);

getThumbnailUrl()

Récupère une URL affichable pour une miniature redimensionnée de l’asset.

import { PhotoLibrary } from '@capgo/capacitor-photo-library';

const result = await PhotoLibrary.getThumbnailUrl({ id: 'id-123' });
console.log(result);

Le tableau ci-dessus liste les 7 méthodes principales. Les listeners, les helpers de version et le contrat complet de chaque méthode sont documentés dans la dépôt GitHub.

Référence complète

Continuer à partir de « Utiliser @capgo/capacitor-photo-library »

Si vous utilisez Utiliser @capgo/capacitor-photo-library pour planifier le comportement des médias et de l'interface natifs, connectez-l’à @capgo/capacitor-photo-library pour les détails d'implémentation dans @capgo/capacitor-photo-library, Prise en main pour les détails d'implémentation dans Getting Started Utiliser @capgo/capacitor-live-activities pour la capacité native dans Utiliser @capgo/capacitor-live-activities @capgo/capacitor-live-activities pour les détails d'implémentation dans @capgo/capacitor-live-activities, et Utiliser @capgo/capacitor-video-player pour la fonctionnalité native dans Utilisation de @capgo/capacitor-video-player.

FAQ

FAQ du plugin Photo Library

Comment installer le plugin Photo Library dans une application Capacitor ?

Exécutez « bun add @capgo/capacitor-photo-library » (ou « npm install @capgo/capacitor-photo-library »), puis lancez « bunx cap sync » pour que les projets iOS et Android récupèrent le code natif code. Importez-le depuis « @capgo/capacitor-photo-library » dans votre code applicatif code.

Le plugin @capgo/capacitor-photo-library fonctionne-t-il avec React, Vue et Angular ?

Oui. Photo Library est un package Capacitor, il fonctionne donc avec n’importe quel framework web exécuté dans Capacitor, y compris Ionic, React, Vue, Angular, Svelte et le JavaScript pur.

Quelle version de Capacitor prend en charge @capgo/capacitor-photo-library ?

Les plugins Capgo suivent la version majeure de Capacitor : utilisez la version majeure du plugin qui correspond à la version majeure de votre Capacitor (par exemple le plugin v8 avec Capacitor 8). Le tableau de compatibilité du README de GitHub recense les versions maintenues.

Est-ce que @capgo/capacitor-photo-library est gratuit et open source ?

Oui. Le code source est public sur GitHub à l’adresse https://github.com/Cap-go/capacitor-photo-library/ et le package est gratuit à installer depuis npm. Les signalements de bugs et les pull requests sont les bienvenus.

Puis-je mettre à jour code qui utilise Photo Library sans validation de l’App Store ?

L'installation ou la mise à jour du plugin modifie le code natif, ce qui impose un nouveau build pour les stores. Ensuite, les changements JavaScript, HTML et CSS qui appellent le plugin peuvent être livrés instantanément via les live updates de Capgo.

Déployez les modifications de Photo Library sans attendre la revue de l’application

Une fois le plugin intégré à votre build de store, Capgo live updates déploie vos changements JavaScript, HTML et CSS aux utilisateurs en quelques minutes.

Commencez avec Capgo