Lebih cepat ke konten utama
Capgo logo
Kembali ke plugin
@capgo/capacitor-compass
Tutorial
@capgo/capacitor-compass

Compass

Baca arah kompas perangkat dalam derajat dengan pembaruan terus-menerus dan pengaturan izin

Unduhan/bulan

6.7k

GitHub Bintang

6

Petunjuk

Tutorial tentang Kompas

Menggunakan @capgo/capacitor-kompas

Interface Plugin Kompas Capacitor untuk membaca arah kompas perangkat.

Install

bun add @capgo/capacitor-compass
bunx cap sync

Apa yang Dapat Diketahui oleh Plugin Ini

  • getCurrentHeading - Dapatkan arah kompas dalam derajat. Pada iOS, arah kompas diperbarui di latar belakang, dan nilai terbaru dikembalikan. Pada Android, arah kompas dihitung ketika metode dipanggil menggunakan sensor accelerometer dan magnetometer. Belum diimplementasikan pada Web.
  • startListening - Mulai mendengarkan perubahan arah kompas melalui event. Ini memulai sensor kompas dan mengirimkan event 'headingChange'.
  • stopListening - Berhenti mendengarkan perubahan arah kompas. Ini menghentikan sensor kompas dan menghentikan pengiriman event.
  • checkPermissions - Periksa status izin saat ini untuk mengakses data kompas. Pada iOS, ini memeriksa status izin lokasi. Pada Android, ini selalu mengembalikan 'granted' karena tidak ada izin yang diperlukan.

Contoh Penggunaan

getCurrentHeading

Dapatkan arah kompas saat ini dalam derajat. Pada iOS, arah kompas diperbarui di latar belakang, dan nilai terbaru dikembalikan. Pada Android, arah kompas dihitung ketika metode dipanggil menggunakan sensor accelerometer dan magnetometer. Belum diimplementasikan pada Web.

import { CapgoCompass } from '@capgo/capacitor-compass';

const { value } = await CapgoCompass.getCurrentHeading();
console.log('Compass heading:', value, 'degrees');

startListening

Mulai mendengarkan perubahan arah kompas melalui event. Ini memulai sensor kompas dan mengirimkan event 'headingChange'.

import { CapgoCompass } from '@capgo/capacitor-compass';

// With default throttling (100ms interval, 2° minimum change)
await CapgoCompass.startListening();

// With custom throttling for high-frequency updates
await CapgoCompass.startListening({
  minInterval: 50,      // 50ms between events
  minHeadingChange: 1.0 // 1° minimum change
});

CapgoCompass.addListener('headingChange', (event) => {
  console.log('Heading:', event.value);
});

stopListening

Berhenti mendengarkan perubahan arah kompas. Ini menghentikan sensor kompas dan menghentikan pengiriman event.

import { CapgoCompass } from '@capgo/capacitor-compass';

await CapgoCompass.stopListening();

checkPermissions

Periksa status izin saat ini untuk mengakses data kompas. Pada iOS, ini memeriksa status izin lokasi. Pada Android, ini selalu mengembalikan 'granted' karena tidak ada izin yang diperlukan.

import { CapgoCompass } from '@capgo/capacitor-compass';

const status = await CapgoCompass.checkPermissions();
console.log('Compass permission:', status.compass);

Referensi Lengkap

Teruskan dari Menggunakan @capgo/capacitor-compass

Jika Anda menggunakan Menggunakan @capgo/capacitor-compass untuk merencanakan dashboard dan operasi API, hubungkannya dengan @capgo/capacitor-compass untuk detail implementasi di @capgo/capacitor-compass, Pengenalan untuk detail implementasi di Pengenalan, Ringkasan API untuk detail implementasi di API Ringkasan, Pendahuluan untuk detail implementasi di Pendahuluan, dan API Kunci untuk detail implementasi di API Kunci.