Guide
Comment utiliser la bibliothèque Photo dans Capacitor
Tester sur appareil
Télécharger l'application Capgo, puis scannez le code QR code.
Utilisation de @capgo/capacitor-photo-library
Le plugin Capacitor affiche une galerie photo en tant que page web, ou une écran natif ennuyeux que vous ne pouvez pas modifier mais qui n'exige aucune autorisation.
Installer
bun add @capgo/capacitor-photo-library
bunx cap sync
bunx cap sync copie le plugin code natif dans vos projets natifs. Exécutez-l’à nouveau après chaque mise à jour du plugin.
Importer
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
API en un coup d'œil
| Méthode | Description |
|---|---|
checkAuthorization |
Renvoie le statut d'autorisation actuel sans solliciter l'utilisateur. |
requestAuthorization |
Demande l'accès à la bibliothèque de photos si nécessaire. |
getAlbums |
Récupère les albums disponibles. |
getLibrary |
Récupère les actifs de la bibliothèque ainsi que les URL qui peuvent être affichées dans la vue web. |
getPhotoUrl |
Récupère une URL affichable pour la version haute résolution de l'actif. Si vous avez déjà appelé getLibrary with includeFullResolutionData, vous n'avez généralement pas besoin de cette méthode. |
getThumbnailUrl |
Récupère une URL affichable pour une vignette réduite de l'actif. |
pickMedia |
Ouvre le sélecteur natif du système pour que l'utilisateur puisse sélectionner 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 URL 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()
Accède à la bibliothèque de photos 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 actifs de la bibliothèque ainsi que les URL qui peuvent être affichées dans la vue web.
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 haute résolution de l'actif. Si vous avez déjà appelé getLibrary avec includeFullResolutionDatavous 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 réduite de l'actif.
import { PhotoLibrary } from '@capgo/capacitor-photo-library';
const result = await PhotoLibrary.getThumbnailUrl({ id: 'id-123' });
console.log(result);
La table ci-dessus liste les 7 méthodes de base. Les écouteurs et les assistants de version, ainsi que la pleine convention de chaque méthode, sont documentés dans le le GitHub dépôt.
Documentation
Continuez à partir de l'utilisation de @capgo/capacitor-photo-library
Si vous utilisez L'utilisation de @capgo/capacitor-photo-library Pour planifier le comportement des médias et de l'interface native, connectez-l’avec @capgo/capacitor-bibliothèque-de-photos pour les détails d'implémentation dans @capgo/capacitor-photo-library Getting Started pour les détails d'implémentation dans Démarrage L'utilisation de @capgo/capacitor-live-activities pour la capacité native dans L'utilisation de @capgo/capacitor-live-activities @capgo/capacitor-activités en direct pour les détails d'implémentation dans @capgo/capacitor-activités en direct, et En utilisant @capgo/capacitor-joueur de vidéo pour la capacité native dans En utilisant @capgo/capacitor-joueur de vidéo.