Lompat ke konten

@capgo/camera-preview

Antarmuka utama untuk plugin CameraPreview.

Antarmuka utama untuk plugin CameraPreview.

  • start - Mulai tampilan kamera.
  • stop - Berhenti tampilan kamera.
  • capture - Tangkap gambar dari kamera.
  • captureSample - Mengambil frame tunggal dari aliran preview kamera.
MetodeDeskripsi
startMengaktifkan preview kamera.
stopMenghentikan preview kamera.
captureMengambil gambar dari kamera.
captureSampleMengambil frame tunggal dari aliran preview kamera.
getSupportedFlashModesMendapatkan mode kilat yang didukung oleh kamera aktif.
setAspectRatioMengatur rasio aspek dari preview kamera.
getAspectRatioMendapatkan rasio aspek saat ini dari preview kamera.
setGridModeMengatur mode grid dari overlay preview kamera.
getGridModeMengambil mode grid saat ini dari overlay preview kamera.
checkPermissionsMengecek status izin kamera (dan mikrofon optional) saat ini tanpa menampilkan dialog sistem.
requestPermissionsMengajukan izin kamera (dan mikrofon optional). Jika izin sudah diberikan atau ditolak, status saat ini akan dikembalikan tanpa menampilkan dialog. Ketika showSettingsAlert benar dan izin ditolak, akan ditampilkan peringatan spesifik platform untuk mengarahkan pengguna ke pengaturan aplikasi.
getHorizontalFovMengambil sudut pandang horizontal untuk kamera aktif. Perlu diingat: Ini bisa menjadi perkiraan pada beberapa perangkat.
getSupportedPictureSizesMengambil ukuran gambar yang didukung untuk semua kamera.
setFlashModeMengatur mode kilasan untuk kamera aktif.
flipMengganti antara kamera depan dan belakang.
setOpacityMengatur kejelasan overlay preview kamera.
stopRecordVideoMenghentikan rekaman video yang sedang berlangsung.
startRecordVideoMengawali rekaman video.
isRunningMengecek apakah preview kamera sedang berjalan.
getAvailableDevicesMengambil semua perangkat kamera yang tersedia.
getZoomMengambil keadaan zoom saat ini, termasuk nilai minimum/maksimum dan informasi lens saat ini.
getZoomButtonValuesMengembalikan 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.
setZoomMengatur tingkat zoom kamera.
getFlashModeMengambil mode kilat saat ini.
removeAllListenersMenghapus semua pendengar yang terdaftar.
setDeviceIdMengganti kamera aktif ke kamera dengan spesifikasi yang ditentukan. deviceId.
getDeviceIdMengambil ID perangkat kamera yang saat ini terikat. Pada Android, jika permintaan lens fisik jatuh kembali ke kamera logis, ini mengembalikan ID kamera logis yang terikat.
getPreviewSizeMengambil ukuran dan posisi preview saat ini.
setPreviewSizeMengatur ukuran dan posisi preview.
setFocusMengatur fokus kamera ke titik tertentu di preview.
addListenerMengatur pengaturan untuk perubahan ukuran layar.
addListenerMengatur pengaturan untuk perubahan orientasi.
deleteFileMenghapus file di jalur absolut yang diberikan pada perangkat. Gunakan ini untuk membersihkan cepat gambar sementara yang dibuat dengan storeToFile Pada web, ini tidak didukung dan akan melemparkan.
getSafeAreaInsetsMengembalikan margin aman untuk perangkat. Mengembalikan notch/kamera potong yang sadar orientasi 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 potong (notch, lubang punch, dll.) yang semua ponsel modern memiliki.
getOrientationMengembalikan orientasi perangkat saat ini dalam format lintas platform.
getExposureModesMengembalikan mode eksposur yang didukung oleh kamera aktif. Mode dapat termasuk: ‘terkunci’, ‘otomatis’, ‘terus menerus’, ‘kustom’.
getExposureModeMengembalikan mode eksposur saat ini.
setExposureModeMengatur mode eksposur.
getExposureCompensationRangeMengembalikan rentang kompensasi eksposur (EV bias) yang didukung.
getExposureCompensationMengembalikan kompensasi eksposur (EV bias) saat ini.
setExposureCompensationMengatur kompensasi eksposur (EV bias). Nilai akan ditekan ke rentang.
getPluginVersionDapatkan versi plugin native Capacitor.

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

NilaiPengguna akan menemukan
ultraWideKamera lensa ultra-lebar.
wideAngleKamera lensa standar sudut lebar.
telephotoKamera lensa telephoto.
trueDepthKamera depan TrueDepth.
dualSistem kamera ganda.
dualWideSistem kamera lebar ganda.
tripleSistem kamera tiga.

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

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