@capgo/camera-preview

Ringkasan

Antarmuka Utama untuk Plugin CameraPreview.

Kemampuan Utama

• start - Membuka preview kamera.
• stop - Menghentikan preview kamera.
• capture - Mengambil gambar dari kamera.
• captureSample - Mengambil satu frame dari aliran preview kamera.

Publik API

Metode	Deskripsi
start	Mengaktifkan pratinjau kamera.
stop	Menghentikan pratinjau kamera.
capture	Mengambil gambar dari kamera.
captureSample	Mengambil satu frame dari aliran pratinjau kamera.
getSupportedFlashModes	Mendapatkan mode kilat yang didukung oleh kamera aktif.
setAspectRatio	Mengatur rasio aspek pratinjau kamera.
getAspectRatio	Mendapatkan rasio aspek saat ini dari pratinjau kamera.
setGridMode	Mengatur mode grid pratinjau overlay kamera.
getGridMode	Mendapatkan mode grid saat ini dari pratinjau overlay kamera.
checkPermissions	Mengecek status izin kamera (dan mikrofon) saat ini tanpa menampilkan dialog sistem.
requestPermissions	Mengajukan izin kamera (dan mikrofon opsional). Jika izin sudah diberikan atau ditolak, status saat ini akan dikembalikan tanpa meminta izin. Ketika showSettingsAlert Apabila nilai ini adalah true dan izin ditolak, akan ditampilkan peringatan spesifik platform untuk mengarahkan pengguna ke pengaturan aplikasi.
getHorizontalFov	Mengembalikan sudut pandang horizontal untuk kamera aktif. Perlu diingat: ini bisa menjadi perkiraan pada beberapa perangkat.
getSupportedPictureSizes	Mengembalikan ukuran gambar yang didukung untuk semua kamera.
setFlashMode	Mengatur mode kilat untuk kamera aktif.
flip	Mengganti antara kamera depan dan belakang.
setOpacity	Mengatur kejelasan kamera preview.
stopRecordVideo	Berhenti merekam video yang sedang berlangsung.
startRecordVideo	Mengaktifkan rekaman video.
isRunning	Mengcek apakah kamera preview sedang berjalan.
getAvailableDevices	Mengembalikan semua perangkat kamera yang tersedia.
getZoom	Mengembalikan status zoom saat ini, termasuk min/max dan informasi lensa saat ini.
getZoomButtonValues	Kembali nilai tombol zoom untuk perubahan cepat. - iOS/Android: termasuk 0,5 jika ultra-lebar tersedia; 1 dan 2 jika lebar tersedia; 3 jika telefoto tersedia - Web: tidak tersedia.
setZoom	Mengatur tingkat zoom kamera.
getFlashMode	Mengembalikan mode kilat saat ini.
removeAllListeners	Menghapus semua pendengar yang terdaftar.
setDeviceId	Mengganti kamera aktif ke satu dengan spesifikasi yang ditentukan. deviceId.
getDeviceId	Mengembalikan ID perangkat kamera yang saat ini terikat. Pada Android, jika permintaan lensa fisik jatuh kembali ke kamera logis, ini mengembalikan ID kamera logis yang terikat.
getPreviewSize	Mengembalikan ukuran dan posisi preview saat ini.
setPreviewSize	Mengatur ukuran dan posisi preview.
setFocus	Mengatur fokus kamera ke titik tertentu di preview.
addListener	Menambahkan pendengar untuk peristiwa perubahan ukuran layar.
addListener	Mengaktifkan pendengar untuk peristiwa perubahan orientasi.
deleteFile	Menghapus file di jalur absolut yang diberikan pada perangkat. Gunakan ini untuk membersihkan cepat gambar sementara yang dibuat dengan storeToFile. Pada web, fitur ini tidak tersedia dan akan menyebabkan kesalahan.
getSafeAreaInsets	Mengembalikan insets area aman perangkat. Mengembalikan inset orientasi-aware notch/kamera cutout dan orientasi saat ini. Pada mode potret: mengembalikan inset atas (notch di atas). Pada mode lanskap: mengembalikan inset kiri (notch dipindahkan ke samping). Ini secara spesifik mengarahkan ke area cutout (notch, lubang punch, dll.) yang dimiliki oleh semua ponsel modern.
getOrientation	Mengembalikan orientasi perangkat saat ini dalam format lintas-platform.
getExposureModes	Mengembalikan mode eksposur yang didukung oleh kamera aktif. Mode dapat mencakup: ‘terkunci’, ‘otomatis’, ‘terus-menerus’, ‘kustom’.
getExposureMode	Mengembalikan mode eksposur saat ini.
setExposureMode	Mengatur mode eksposur.
getExposureCompensationRange	Mengembalikan rentang nilai kompensasi eksposur (EV bias).
getExposureCompensation	Mengembalikan nilai kompensasi eksposur (EV bias) saat ini.
setExposureCompensation	Mengatur nilai kompensasi eksposur (EV bias). Nilai akan dikompresi ke rentang.
getPluginVersion	Mengembalikan versi plugin native Capacitor.

Nilai Referensi

Gunakan nilai-nilai dari CameraLens.deviceType atau LensInfo.deviceType Pilih lensa kamera fisik.

Jenis Perangkat

Nilai	Pengguna akan menemukan
ultraWide	Lensa kamera ultra-lebar.
wideAngle	Lensa kamera standar sudut lebar.
telephoto	Lensa kamera telefoto.
trueDepth	Kamera depan TrueDepth.
dual	Sistem kamera ganda.
dualWide	Sistem kamera lebar ganda.
triple	Sistem kamera tiga.

Sumber Kebenaran.

Referensi ini disinkronkan dari src/definitions.ts dalam capacitor-camera-preview.

Teruskan dari @capgo/camera-preview

Jika Anda menggunakan @capgo/camera-preview untuk merencanakan perilaku media asli dan antarmuka, hubungkannya dengan Menggunakan @capgo/camera-preview untuk kemampuan asli dalam Menggunakan @capgo/camera-preview, Menggunakan @capgo/capacitor-live-activities untuk kemampuan asli dalam Menggunakan @capgo/capacitor-live-activities, @capgo/capacitor-aktivitas-langsung untuk detail implementasi dalam @capgo/capacitor-live-activities, Menggunakan @capgo/capacitor-video-player untuk kemampuan asli dalam Menggunakan @capgo/capacitor-video-player, dan @capgo/capacitor-player-video untuk detail implementasi dalam @capgo/capacitor-video-player.