Zum Hauptinhalt springen

Fotomediathek Capacitor Plugin

Fotos und Videos in der Fotogalerie des Geräts mit Berechtigungen durchsuchen, speichern und verwalten

Installieren

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

Anleitung

So nutzt du die Photo Library in Capacitor

@capgo/capacitor-photo-library verwenden

Das Capacitor Plugin zeigt die Fotogalerie als Webseite – oder als langweiligen nativen Screen, den man nicht anpassen kann, der aber keine Autorisierung erfordert.

Installieren

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

bunx cap sync kopiert den nativen code des Plugins in deine nativen Projekte. Nach jedem Plugin-Upgrade erneut ausführen.

Importieren

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

API auf einen Blick

Methode Beschreibung
checkAuthorization Gibt den aktuellen Autorisierungsstatus zurück, ohne den User zu fragen.
requestAuthorization Fordert bei Bedarf den Zugriff auf die Fotomediathek an.
getAlbums Ruft die verfügbaren Alben ab.
getLibrary Ruft die Mediathek-Assets zusammen mit URLs ab, die in der WebView angezeigt werden können.
getPhotoUrl Ruft eine anzeigbare URL für die hochauflösende Version des Assets ab. Wenn du bereits getLibrary mit includeFullResolutionData, diese Methode wird normalerweise nicht benötigt.
getThumbnailUrl Ruft eine anzeigbare URL für ein skaliertes Thumbnail des Assets ab.
pickMedia Öffnet den nativen System-Picker, damit Nutzer Medien auswählen können, ohne vollen Zugriff auf die Fotomediathek zu gewähren. Die ausgewählten Dateien werden in den App-Cache kopiert und mit portablen URLs zurückgegeben.

Beispiele

checkAuthorization()

Gibt den aktuellen Autorisierungsstatus zurück, ohne den User zu fragen.

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

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

requestAuthorization()

Fordert bei Bedarf den Zugriff auf die Fotomediathek an.

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

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

getAlbums()

Ruft die verfügbaren Alben ab.

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

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

getLibrary()

Ruft die Mediathek-Assets zusammen mit URLs ab, die in der WebView angezeigt werden können.

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

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

getPhotoUrl()

Ruft eine anzeigbare URL für die hochauflösende Version des Assets ab. Wenn du bereits getLibrary mit includeFullResolutionData, diese Methode wird normalerweise nicht benötigt.

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

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

getThumbnailUrl()

Ruft eine anzeigbare URL für ein skaliertes Thumbnail des Assets ab.

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

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

Die obige Tabelle listet die 7 Kernmethoden auf. Listener, Version-Helper und der vollständige Contract jeder Methode sind in der GitHub Repository.

Vollständige Referenz

Weiterlesen unter Verwendung von @capgo/capacitor-photo-library

Wenn du es nutzt @capgo/capacitor-photo-library verwenden , um natives Media- und Interface-Verhalten zu planen, verbinde es mit @capgo/capacitor-photo-library für die Implementierungsdetails in @capgo/capacitor-photo-library, Erste Schritte für die Implementierungsdetails in Erste Schritte, @capgo/capacitor-live-activities verwenden für die native Funktion in „@capgo/capacitor-live-activities verwenden“, @capgo/capacitor-live-activities für die Implementierungsdetails in @capgo/capacitor-live-activities und Verwendung von @capgo/capacitor-video-player für die native Funktionalität in „Verwendung von @capgo/capacitor-video-player.“

FAQ

FAQ zum Photo Library Plugin

Wie installiere ich das Photo Library Plugin in einer Capacitor App?

Führe "bun add @capgo/capacitor-photo-library" (oder "npm install @capgo/capacitor-photo-library") aus und danach "bunx cap sync", damit die iOS- und Android-Projekte die nativen code übernehmen. Importiere es in deiner App code aus "@capgo/capacitor-photo-library".

Funktioniert @capgo/capacitor-photo-library mit React, Vue und Angular?

Ja. Photo Library ist ein Capacitor Package und funktioniert daher mit jedem Web-Framework, das in Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und reinem JavaScript.

Welche Capacitor Version wird von @capgo/capacitor-photo-library unterstützt?

Capgo Plugins folgen der Major-Version von Capacitor: Nutze die Plugin-Major-Version, die zu deiner Capacitor Major-Version passt (z. B. Plugin v8 bei Capacitor 8). Die Kompatibilitätstabelle im GitHub README listet die gepflegten Versionen auf.

Ist @capgo/capacitor-photo-library kostenlos und Open Source?

Ja. Der code-Code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-photo-library/ und das Paket lässt sich kostenlos über npm installieren. Bug-Reports und Pull Requests sind willkommen.

Kann ich code, das Photo Library nutzt, ohne App-Store-Review aktualisieren?

Die Installation oder ein Upgrade des Plugins ändert den nativen code, weshalb ein neuer Store-Build nötig ist. Danach können JavaScript-, HTML- und CSS-Änderungen, die das Plugin aufrufen, sofort per Capgo Live Updates ausgeliefert werden.

Photo Library Änderungen ohne App-Review ausrollen

Sobald das Plugin in deinem Store-Build ist, bringt Capgo mit Live-Updates deine JavaScript-, HTML- und CSS-Änderungen in Minuten zu den Nutzern.

Starte mit Capgo