@capgo/capacitor-compass

Ikhtisar

Baca heading kompas perangkat dalam derajat dengan update berkelanjutan dan penanganan izin

Mulai dengan getCurrentHeading() dan metode inti lainnya yang tercantum di bawah ini.

Dukungan platform

Platform	Dukungan	Catatan
iOS	Ya	Native
Android	Ya	Native
Web	Tidak	Lindungi dengan Capacitor.getPlatform()

Kemampuan Utama

• getCurrentHeading - Dapatkan heading kompas saat ini dalam derajat. Di iOS, heading diperbarui di background, dan nilai terbaru akan dikembalikan. Di Android, heading dihitung saat method dipanggil menggunakan sensor accelerometer dan magnetometer. Tidak diimplementasikan di Web.
• startListening - Mulai mendengarkan perubahan heading kompas melalui event. Ini akan mengaktifkan sensor kompas dan memancarkan event ‘headingChange’.
• stopListening - Berhenti mendengarkan perubahan heading kompas. Ini akan menonaktifkan sensor kompas dan menghentikan pengiriman event.
• checkPermissions - Periksa status izin saat ini untuk mengakses data kompas. Di iOS, ini memeriksa status izin lokasi. Di Android, ini selalu mengembalikan ‘granted’ karena tidak memerlukan izin apa pun.

API Publik

Metode	Deskripsi
getCurrentHeading	Dapatkan heading kompas saat ini dalam derajat. Di iOS, heading diperbarui di background dan nilai terbaru dikembalikan. Di Android, heading dihitung saat method dipanggil menggunakan sensor accelerometer dan magnetometer. Tidak diimplementasikan di Web.
getPluginVersion	Dapatkan versi plugin native Capacitor.
startListening	Mulai mendengarkan perubahan heading kompas melalui event. Ini akan mengaktifkan sensor kompas dan mengirim event ‘headingChange’.
stopListening	Berhenti mendengarkan perubahan heading kompas. Ini akan menonaktifkan sensor kompas dan menghentikan pengiriman event.
addListener	Tambahkan listener untuk event perubahan heading kompas.
addListener	Tambahkan listener untuk event perubahan akurasi kompas. Hanya didukung di Android. Di iOS dan Web, event tidak akan pernah dikirim.
removeAllListeners	Hapus semua listener plugin ini.
checkPermissions	Cek status permission saat ini untuk mengakses data kompas. Di iOS, ini mengecek status permission lokasi. Di Android, ini selalu mengembalikan ‘granted’ karena tidak ada permission yang diperlukan.
requestPermissions	Minta permission untuk mengakses data kompas. Di iOS, ini meminta permission lokasi (diperlukan untuk data heading). Di Android, ini langsung resolve karena tidak ada permission yang diperlukan.
watchAccuracy	Mulai memantau akurasi kompas. Di Android, ini memantau akurasi magnetometer dan mengirim event accuracyChange. Developer dapat mendengarkan event ini dan membuat UI sendiri untuk prompt kalibrasi. Di iOS dan Web, method ini tidak melakukan apa pun karena pemantauan akurasi kompas tidak tersedia.
unwatchAccuracy	Berhenti memantau akurasi kompas. Ini akan menghentikan pemantauan akurasi.
getAccuracy	Dapatkan level akurasi kompas saat ini. Di Android, mengembalikan akurasi sensor magnetometer saat ini. Di iOS dan Web, selalu mengembalikan CompassAccuracy.UNKNOWN karena pemantauan akurasi tidak tersedia.

Sumber Kebenaran

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

Lanjutkan dari @capgo/capacitor-compass

Jika Anda menggunakan @capgo/capacitor-compass untuk merencanakan pekerjaan plugin native, hubungkan dengan Menggunakan @capgo/capacitor-compass untuk kapabilitas native di Using @capgo/capacitor-compass, Direktori Plugin Capgo untuk alur kerja produk di Direktori Plugin Capgo, Plugin Capacitor oleh Capgo untuk detail implementasi pada Capacitor Plugins oleh Capgo Menambahkan atau Memperbarui Plugin untuk detail implementasi di Menambahkan atau Memperbarui Plugin, dan Alternatif Plugin Ionic Enterprise untuk alur kerja produk dalam Alternatif Plugin Ionic Enterprise.