Lebih lanjut ke konten utama
@capgo/capacitor-kolom-foto Media Terbuka Sumber

Kolom Foto Plugin Capacitor

Muat, simpan, dan kelola foto dan video di perpustakaan foto perangkat dengan izin

Install

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

Panduan

Cara menggunakan Library Foto di Capacitor

Uji di perangkat

Unduh aplikasi Capgo, kemudian scan kode QR code.

Pratinjau Plugin Foto Perpustakaan QR code

Menggunakan @capgo/capacitor-photo-library

Plugin Capacitor Menampilkan galeri foto sebagai halaman web, atau layar native yang membosankan yang tidak dapat diedit tetapi tidak memerlukan otorisasi apa pun.

Pasang

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

bunx cap sync Menggandakan plugin code native ke proyek native Anda. Jalankan lagi setelah setiap pembaruan plugin.

Impor

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

Pandangan API

Metode Deskripsi
checkAuthorization Mengembalikan status otorisasi saat ini tanpa meminta pengguna.
requestAuthorization Mengajukan akses ke galeri foto jika diperlukan.
getAlbums Mengambil album yang tersedia.
getLibrary Mengambil asset galeri bersama dengan URL yang dapat ditampilkan di tampilan web.
getPhotoUrl Mengambil URL yang dapat ditampilkan untuk versi resolusi penuh dari asset. Jika Anda sudah memanggil getLibrary dan includeFullResolutionData, Anda biasanya tidak perlu metode ini.
getThumbnailUrl Mengambil URL yang dapat ditampilkan untuk thumbnail ukuran yang diresmikan dari asset.
pickMedia Membuka picker sistem native sehingga pengguna dapat memilih media tanpa memberikan akses penuh ke galeri foto. File yang dipilih disalin ke cache aplikasi dan dikembalikan dengan URL yang dapat dipindahkan.

Contoh

checkAuthorization()

Mengembalikan status otorisasi saat ini tanpa meminta pengguna.

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

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

requestAuthorization()

Meminta akses ke perpustakaan foto jika diperlukan.

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

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

getAlbums()

Mengambil album yang tersedia.

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

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

getLibrary()

Mengambil asset perpustakaan bersama dengan URL yang dapat ditampilkan di tampilan web.

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

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

getPhotoUrl()

Mengambil URL yang dapat ditampilkan untuk versi resolusi penuh dari asset. Jika Anda sudah memanggil getLibrary atau includeFullResolutionDatabiasanya Anda tidak perlu metode ini.

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

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

getThumbnailUrl()

Mengambil URL yang dapat ditampilkan untuk thumbnail ukuran kecil dari asset.

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

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

Daftar metode di atas mencantumkan 7 metode inti. Pembantu pendengar dan versi, serta kontrak lengkap dari setiap metode, dapat dilihat di Repositori GitHub.

Dokumentasi

Teruskan dari Menggunakan @capgo/capacitor-photo-library

Jika Anda menggunakan Menggunakan @capgo/capacitor-photo-library Untuk merencanakan perilaku media dan antarmuka native, hubungkannya dengan @capgo/capacitor-photo-library untuk detail implementasi di @capgo/capacitor-photo-library, Mulai Menggunakan untuk detail implementasi di Berikut, Menggunakan @capgo/capacitor-live-activities untuk kemampuan native di Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-aktivitas-hidup untuk detail implementasi di @capgo/capacitor-aktifitas-hidup, dan Menggunakan @capgo/capacitor-player-video untuk kemampuan asli di Menggunakan @capgo/capacitor-player-video.

FAQ

FAQ Foto Perpustakaan

Bagaimana cara menginstal plugin Foto Perpustakaan di sebuah aplikasi Capacitor?

Jalankan "bun add @capgo/capacitor-photo-library" (atau "npm install @capgo/capacitor-photo-library"), kemudian jalankan "bunx cap sync" agar projek iOS dan Android dapat menangkap native code. Import dari "@capgo/capacitor-photo-library" di aplikasi code.

Apakah @capgo/capacitor-photo-library dapat digunakan dengan React, Vue, dan Angular?

Ya. Foto Perpustakaan adalah paket Capacitor, sehingga dapat digunakan dengan framework web apa pun yang berjalan di dalam Capacitor, termasuk Ionic, React, Vue, Angular, Svelte, dan JavaScript biasa.

Versi Capacitor mana yang didukung oleh @capgo/capacitor-photo-library?

Capgo plugin mengikuti versi utama Capacitor: gunakan versi plugin utama yang sesuai dengan versi utama Capacitor (misalnya plugin v8 dengan Capacitor 8). Tabel kompatibilitas di README GitHub menyebutkan versi yang dipelihara.

Apakah @capgo/capacitor-photo-library gratis dan terbuka sumber?

Ya. Sumber code tersedia secara publik di GitHub di https://github.com/Cap-go/capacitor-photo-library/ dan paketnya dapat diinstal secara gratis dari npm. Laporan bug dan permintaan pull selalu welcome.

Dapatkah saya memperbarui code yang menggunakan Foto Perpustakaan tanpa melalui tinjauan App Store?

Menginstal atau mengupgrade plugin mengubah native code, sehingga memerlukan build toko baru. Setelah itu, perubahan JavaScript, HTML, dan CSS yang memanggil plugin dapat berlayar secara instan dengan Capgo live updates.

Kirim perubahan Library Foto tanpa menunggu tinjauan aplikasi

Setelah plugin masuk ke dalam toko aplikasi Anda, Capgo pembaruan hidup memasukkan perubahan JavaScript, HTML, dan CSS Anda ke pengguna dalam menit-menit.

Mulai dengan Capgo