Compass

Utilisation de @capgo/capacitor-compass

Interface du plugin Compass de Capacitor pour la lecture de l'orientation du capteur de l'appareil.

Installer

bun add @capgo/capacitor-compass
bunx cap sync

Ce que ce plugin expose

• getCurrentHeading - Récupérer l'orientation actuelle du capteur en degrés. Sur iOS, l'orientation est mise à jour en arrière-plan, et la dernière valeur est retournée. Sur Android, l'orientation est calculée lorsque la méthode est appelée à l'aide des capteurs accéléromètre et magnétomètre. Non implémenté sur Web.
• startListening - Démarrer l'écoute des changements d'orientation du capteur via des événements. Cela démarre les capteurs de l'orientation et émet des événements de type « headingChange ».
• stopListening - Arrêter l'écoute des changements d'orientation du capteur. Cela arrête les capteurs de l'orientation et arrête l'émission d'événements.
• checkPermissions - Vérifier l'état actuel des autorisations pour accéder aux données de l'orientation. Sur iOS, cela vérifie l'état des autorisations de localisation. Sur Android, cela retourne toujours « granted » car aucune autorisation n'est requise.

Exemple d'utilisation

getCurrentHeading

Récupérer l'orientation actuelle du capteur en degrés. Sur iOS, l'orientation est mise à jour en arrière-plan, et la dernière valeur est retournée. Sur Android, l'orientation est calculée lorsque la méthode est appelée à l'aide des capteurs accéléromètre et magnétomètre. Non implémenté sur Web.

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

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

startListening

Commencez à écouter les changements de direction du compas via les événements. Cela démarre les capteurs du compas et émet des événements de type « 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

Arrêtez d'écouter les changements de direction du compas. Cela arrête les capteurs du compas et arrête d'émettre des événements.

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

await CapgoCompass.stopListening();

checkPermissions

Vérifiez l'état actuel des autorisations pour accéder aux données du compas. Sur iOS, cela vérifie l'état de la permission de localisation. Sur Android, cela retourne toujours « granted » car aucune autorisation n'est requise.

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

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

Référence complète

• GitHub: https://github.com/Cap-go/capacitor-compass/
• Documentation : /docs/plugins/compass/

Continuez à partir de l'utilisation de @capgo/capacitor-compass

Si vous utilisez L'utilisation de @capgo/capacitor-compass pour planifier le tableau de bord et les opérations de API, connectez-le avec @capgo/capacitor-compass pour les détails d'implémentation dans @capgo/capacitor-compass, Démarrage rapide pour les détails d'implémentation dans Démarrage rapide, API Vue d'ensemble pour les détails d'implémentation dans API Vue d'ensemble, Introduction pour les détails d'implémentation dans Introduction, et API Clés pour les détails d'implémentation dans API Clés.