Zum Hauptinhalt springen

Bildbibliothek Capacitor-Plugin

Browse, save and manage photos and videos in the device photo library with permissions

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

Verwendung von Photo Library in Capacitor

Testen auf Gerät

Laden Sie die Capgo-App herunter, dann scannen Sie die QR-code.

Vorschau-QR-code für das Photo Library-Plugin

Mit @capgo/capacitor-photo-library

Capacitor-Plugin: Anzeigt eine Fotogalerie als Web-Seite oder eine langweilige native Anzeige, die Sie nicht ändern können, aber keine Autorisierung erfordern.

Installieren

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

bunx cap sync kopiert die native code des Plugins in Ihre native Projekte. Führen Sie es erneut aus, nachdem Sie jedes Plugin aktualisiert haben.

Importieren

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

API im Überblick

Methode Beschreibung
checkAuthorization Gibt den aktuellen Autorisierungsstatus ohne das Benachrichtigen des Benutzers zurück.
requestAuthorization Bittet um Zugriff auf die Fotobibliothek, wenn erforderlich.
getAlbums Holt die verfügbaren Alben ab.
getLibrary Holt Bibliotheksassets zusammen mit URLs ab, die in der Webansicht angezeigt werden können.
getPhotoUrl Holt eine anzeigbare URL für die volle Auflösung der Asset ab. Wenn Sie bereits getLibrary mit includeFullResolutionDataSie benötigen diese Methode normalerweise nicht.
getThumbnailUrl Holt eine anzeigbare URL für ein angepasstes Thumbnail des Assets ab.
pickMedia Öffnet den nativen Systempicker, damit der Benutzer Medien auswählen kann, ohne den vollständigen Zugriff auf die Fotobibliothek zu gewähren. Die ausgewählten Dateien werden in die Anwendungs-Cache kopiert und mit portablen URLs zurückgegeben.

Beispiele

checkAuthorization()

Gibt den aktuellen Autorisierungsstatus ohne das Benachrichtigen des Benutzers zurück.

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

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

requestAuthorization()

Anforderung des Zugriffs auf die Fotobibliothek, wenn erforderlich.

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 Bibliotheksassets zusammen mit URLs ab, die in der Webansicht 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 volle Auflösung der Asset ab. Wenn Sie bereits die Methode aufgerufen haben getLibrary mit includeFullResolutionData, benötigen Sie normalerweise diese Methode nicht.

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 abgerundetes Thumbnail des Assets ab.

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

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

Die Tabelle oben listet die 7 Kernmethoden auf. Helfer für Listener und Versionen sowie die vollständige Vertragsvereinbarung jeder Methode sind im GitHub-Repository.

Vollständige Referenz

Mit @capgo/capacitor-photo-library weitermachen

Wenn Sie @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-photo-library verwenden Mit @capgo/capacitor-photo-library verbinden um native Medien und Schnittstellenverhalten zu planen, verbinden Sie es mit @capgo/capacitor-photo-library für die Implementierungsdetails in @capgo/capacitor-Foto-Bibliothek Mit @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-live-activities für die Implementierungsdetails im Getting Started @capgo/capacitor-live-activities für die native Fähigkeit im @capgo/capacitor-live-Aktivitäten Using @capgo/capacitor-live-activities Für die Implementierungsdetails in @capgo/capacitor-live-aktivitäten, und Mit @capgo/capacitor-video-player Für die native Fähigkeit in Mit @capgo/capacitor-video-player.

FAQ

Foto-Bibliothek-Plugin FAQ

Wie installiere ich die Photo-Bibliothek-Plugin in einer Capacitor-App?

Führen Sie "bun add @capgo/capacitor-photo-library" (oder "npm install @capgo/capacitor-photo-library"), dann führen Sie "bunx cap sync" aus, damit die iOS- und Android-Projekte die native code-Datei aufnehmen. Importieren Sie sie aus "@capgo/capacitor-photo-library" in Ihrer code-Anwendung.

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

Ja. Die Foto-Bibliothek ist ein Capacitor-Paket, daher funktioniert sie mit jedem Web-Framework, das innerhalb von Capacitor läuft, einschließlich Ionic, React, Vue, Angular, Svelte und plain JavaScript.

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

Capgo-Plugins folgen der Capacitor-Version: verwenden Sie die Plugin-Version, die Ihrem Capacitor-Version entspricht (z.B. Plugin v8 mit Capacitor 8). Die Kompatibilitäts-Tabelle im GitHub-README enthält die unterstützten Versionen.

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

Ja. Die Quellcode-code ist öffentlich auf GitHub unter https://github.com/Cap-go/capacitor-photo-library/ verfügbar und das Paket kann kostenlos installiert werden von npm. Bug-Reports und Pull-Requests sind willkommen.

Kann ich code aktualisieren, das Photo Library verwendet, ohne eine App-Store-Bewertung?

Die Installation oder das Upgrade des Plugins ändert die native code, daher benötigt es eine neue Store-Build. Anschließend können JavaScript-, HTML- und CSS-Änderungen, die den Plugin aufrufen, sofort mit Capgo-Live-Updates verschickt werden.

Foto-Bibliotheksänderungen ohne Wartezeit auf die App-Überprüfung verschicken

Einmal das Plugin in Ihrem Store-Build installiert, Capgo Live-Updates drücken Ihre JavaScript-, HTML- und CSS-Änderungen an die Benutzer in Minuten.

Mit Capgo beginnen