@capgo/capacitor-compass

Resumen

Lee la orientación de la brújula en grados con actualizaciones continuas y gestión de permisos

Comienza con getCurrentHeading() y los demás métodos principales detallados abajo.

Soporte de plataformas

Plataforma	Soporte	Notas
iOS	Sí	Nativo
Android	Sí	Nativo
Web	No	Protege con Capacitor.getPlatform()

Funcionalidades principales

• getCurrentHeading - Obtén la orientación actual de la brújula en grados. En iOS, la orientación se actualiza en segundo plano y se devuelve el último valor. En Android, la orientación se calcula al llamar al método usando los sensores del acelerómetro y magnetómetro. No implementado en Web.
• startListening - Empieza a escuchar los cambios de orientación de la brújula mediante eventos. Esto activa los sensores de la brújula y emite eventos ‘headingChange’.
• stopListening - Deja de escuchar los cambios de orientación de la brújula. Esto detiene los sensores y deja de emitir eventos.
• checkPermissions - Comprueba el estado actual de los permisos para acceder a los datos de la brújula. En iOS, esto verifica el estado de los permisos de ubicación. En Android, siempre devuelve ‘granted’ ya que no se requieren permisos.

Público API

Método	Descripción
getCurrentHeading	Obtén el rumbo actual de la brújula en grados. En iOS, el rumbo se actualiza en segundo plano y se devuelve el último valor. En Android, el rumbo se calcula al llamar al método usando los sensores de acelerómetro y magnetómetro. No implementado en Web.
getPluginVersion	Obtén la versión del plugin nativo Capacitor.
startListening	Empieza a escuchar cambios de rumbo de la brújula mediante eventos. Esto activa los sensores de la brújula y emite eventos 'headingChange'.
stopListening	Deja de escuchar los cambios de orientación de la brújula. Esto detiene los sensores y deja de emitir eventos.
addListener	Añade un listener para eventos de cambio de rumbo de la brújula.
addListener	Añade un listener para eventos de cambio de precisión de la brújula. Solo compatible con Android. En iOS y Web, nunca emitirá eventos.
removeAllListeners	Elimina todos los listeners de este plugin.
checkPermissions	Comprueba el estado actual del permiso para acceder a datos de la brújula. En iOS, esto verifica el estado del permiso de ubicación. En Android, siempre devuelve 'granted' ya que no se requieren permisos.
requestPermissions	Solicita permiso para acceder a los datos de la brújula. En iOS, esto solicita el permiso de ubicación (necesario para los datos de rumbo). En Android, se resuelve de inmediato, ya que no se requieren permisos.
watchAccuracy	Empieza a monitorear la precisión de la brújula. En Android, monitorea la precisión del magnetómetro y emite eventos accuracyChange. Los desarrolladores pueden escuchar estos eventos e implementar su propia UI para los prompts de calibración. En iOS y Web, este método no hace nada, ya que el monitoreo de la precisión de la brújula no está disponible.
unwatchAccuracy	Detener el monitoreo de la precisión de la brújula. Esto detiene el monitoreo de precisión.
getAccuracy	Obtener el nivel de precisión actual de la brújula. En Android, devuelve la precisión actual del sensor magnetómetro. En iOS y Web, siempre devuelve CompassAccuracy.UNKNOWN, ya que el monitoreo de precisión no está disponible.

Fuente de verdad

Esta referencia se sincroniza desde src/definitions.ts en capacitor-compass.

Continuar desde @capgo/capacitor-compass

Si estás usando @capgo/capacitor-compass para planificar el trabajo con plugins nativos, conéctalo con Usando @capgo/capacitor-compass para la capacidad nativa en Usando @capgo/capacitor-compass, Directorio de plugins de Capgo para el flujo de trabajo del producto en Capgo Plugin Directory, Plugins de Capacitor por Capgo para el detalle de implementación en los Plugins de Capacitor por Capgo, Añadir o actualizar plugins para el detalle de implementación en Agregar o actualizar plugins, y Alternativas a plugins de Ionic Enterprise para el flujo de trabajo del producto en Alternativas a plugins de Ionic Enterprise.