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 vignette redimensionnée de l'asset. |
pickMedia |
Ouvre le sélecteur natif du système pour permettre à l'utilisateur de choisir des médias sans accorder un accès complet à la bibliothèque de photos. 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 vignette 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 helpers de listener et de version, ainsi que 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.