Saltar al contenido

@capgo/capacitor-compass

Lea la dirección del compás del dispositivo en grados con actualizaciones continuas y manejo de permisos

Lee la dirección del compás del dispositivo en grados con actualizaciones continuas y manejo de permisos

Comienza con getCurrentHeading() y los otros métodos principales enumerados a continuación.

PlataformaAyudaNota
iOSSíNativo
AndroidSíNativo
WebNoProteger con Capacitor.getPlatform()
  • getCurrentHeading - Obten 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 Comience a escuchar cambios en la dirección del compás mediante eventos. Esto inicia los sensores del compás y emite eventos 'headingChange'.
  • stopListening Detener la escucha de cambios en la dirección del compás. Esto detiene los sensores del compás y deja de emitir eventos.
  • 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 ‘concedido’ ya que no se requieren permisos.
MétodoDescripción
getCurrentHeadingObten 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.
getPluginVersionObten la versión nativa del plugin Capacitor.
startListeningComience a escuchar cambios en la dirección del compás mediante eventos. Esto inicia los sensores del compás y emite eventos ‘headingChange’.
stopListeningDetener la escucha de cambios en la dirección del compás. Esto detiene los sensores del compás y deja de emitir eventos.
addListenerAgregue un oyente para eventos de cambio de dirección del compás.
addListenerAgregue un oyente para eventos de cambio de precisión del compás. Solo se admite en Android. En iOS y Web, nunca emite eventos.
removeAllListenersElimine todos los oyentes para este plugin.
checkPermissionsVerifique el estado actual de permiso para acceder a datos del compás. En iOS, esto verifica el estado de permiso de ubicación. En Android, esto siempre devuelve ‘granted’ ya que no se requieren permisos.
requestPermissionsSolicite permiso para acceder a datos del compás. En iOS, esto solicita permiso de ubicación (requerido para datos de dirección). En Android, esto resuelve inmediatamente ya que no se requieren permisos.
watchAccuracyComience a monitorear la precisión del compás. En Android, monitorea la precisión del sensor magnetómetro y emite eventos accuracyChange. Los desarrolladores pueden escuchar estos eventos y implementar su propia interfaz de usuario para solicitudes de calibración. En iOS y Web, este método no hace nada ya que la monitoreo de precisión del compás no está disponible.
unwatchAccuracyDetener la monitorización de la precisión del compás.
getAccuracyObtenga el nivel de precisión actual del compás. En Android, devuelve la precisión actual del sensor magnetómetro. En iOS y Web, siempre devuelve CompassAccuracy.UNKNOWN ya que la monitoreo de precisión del compás no está disponible.

Esta referencia está sincronizada desde src/definitions.ts en capacitor-compass.

Si estás utilizando @capgo/capacitor-compass para planificar el trabajo de plugin nativo, conecta con Usando @capgo/capacitor-compass para la capacidad nativa en Usando @capgo/capacitor-compass, Capgo Directorio de Plugin para el flujo de trabajo del producto en Capgo Directorio de Plugin, Capacitor Plugins por Capgo para el detalle de implementación en Capacitor Plugins por Capgo Agregar o Actualizar Plugins para el detalle de implementación en Agregar o Actualizar Plugins, y Alternativas de Plugins de Ionic Enterprise para el flujo de trabajo del producto en Ionic Enterprise Plugin Alternativas.