Beranda __CAPGO_KEEP_0__
Capgo updater, OTA, autoupdate, __CAPGO_KEEP_1__
Kembali ke plugin

Panduan

Tutorial tentang Compass

Uji coba di perangkat

Unduh aplikasi Capgo terlebih dahulu, kemudian scan kode QR code.

App Store Google Play
Pratinjau tautan QR plugin kompas code

Menggunakan @capgo/capacitor-kompas

Capacitor Antarmuka Plugin Kompas untuk membaca arah kompas perangkat.

Install

bun add @capgo/capacitor-compass
bunx cap sync

Apa yang Dibuka oleh Plugin Ini

  • getCurrentHeading - Dapatkan arah kompas saat ini dalam derajat. Pada iOS, arahnya diperbarui di latar belakang, dan nilai terbaru dikembalikan. Pada Android, arahnya dihitung ketika metode dipanggil menggunakan sensor accelerometer dan magnetometer. Belum diimplementasikan pada Web.
  • startListening - Mulai mendengarkan perubahan arah kompas melalui acara. Ini memulai sensor kompas dan mengirimkan acara 'headingChange'.
  • stopListening - Berhenti mendengarkan perubahan arah kompas. Ini menghentikan sensor kompas dan menghentikan pengiriman acara.
  • 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, arahnya diperbarui di latar belakang, dan nilai terbaru dikembalikan. Pada Android, arahnya 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

Hentikan 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-kompas

Jika Anda menggunakan Menggunakan @capgo/capacitor-kompas untuk merencanakan dashboard dan API operasi, hubungkannya dengan @capgo/capacitor-kompas untuk detail implementasi di @capgo/capacitor-compass, Mulai untuk detail implementasi di Mulai, Ringkasan API untuk detail implementasi di Ringkasan API, dan Kunci __CAPGO_KEEP_0__ untuk detail implementasi di Kunci __CAPGO_KEEP_0__. API Keys Menggerakkan aplikasi API Anda dengan