Brújula

Usando @capgo/capacitor-compass

Capacitor Interfaz del plugin Compass para leer la dirección del compás del dispositivo.

Instalar

bun add @capgo/capacitor-compass
bunx cap sync

¿Qué se expone con este plugin?

• getCurrentHeading - Obtenga la dirección actual del compás en grados. En iOS, la dirección se actualiza en segundo plano y se devuelve el valor más reciente. En Android, la dirección se calcula cuando se llama al método utilizando sensores de acelerómetro y magnetómetro. No implementado en Web.
• startListening - Inicie la escucha de cambios en la dirección del compás mediante eventos. Esto inicia los sensores del compás y emite eventos de 'headingChange'.
• stopListening - Detenga la escucha de cambios en la dirección del compás. Esto detiene los sensores del compás y detiene la emisión de eventos.
• checkPermissions - Verifique el estado actual de permiso para acceder a datos de compás. En iOS, esto verifica el estado de permiso de ubicación. En Android, siempre devuelve 'concedido' ya que no se requieren permisos.

Uso de ejemplo

getCurrentHeading

- Obtenga la dirección actual del compás en grados. En iOS, la dirección se actualiza en segundo plano y se devuelve el valor más reciente. En Android, la dirección se calcula cuando se llama al método utilizando sensores de acelerómetro y magnetómetro. No implementado en Web.

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

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

startListening

Comienza a escuchar cambios en la dirección del compás mediante eventos. Esto inicia los sensores del compás y emite eventos de '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

Detén la escucha de cambios en la dirección del compás. Esto detiene los sensores del compás y detiene la emisión de eventos.

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

await CapgoCompass.stopListening();

checkPermissions

Verifica el estado de permiso actual para acceder a datos del compás. En iOS, esto verifica el estado de permiso de ubicación. En Android, siempre devuelve 'granted' ya que no se requieren permisos.

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

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

Referencia Completa

• GitHub: https://github.com/Cap-go/capacitor-compass/
• Documentación: /docs/plugins/compass/

Sigue adelante desde Usando @capgo/capacitor-compass

Si estás utilizando Usando @capgo/capacitor-compass para planificar la consola y las operaciones de API, conecta con @capgo/capacitor-compass para el detalle de implementación en @capgo/capacitor-compass Inicio para el detalle de implementación en Inicio Resumen de API para el detalle de implementación en Resumen de API Introducción para el detalle de implementación en Introducción, y Claves de API para el detalle de implementación en Claves de API