Compass

Utilisation de @capgo/capacitor-compass

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

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 renvoyée. Sur Android, l'orientation est calculée lors de l'appel de la méthode à l'aide des capteurs accéléromètre et magnétomètre. Non implémenté sur Web.
• startListening - Démarrer la lecture 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 la lecture 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 le statut actuel des autorisations pour accéder aux données de l'orientation. Sur iOS, cela vérifie le statut d'autorisation de localisation. Sur Android, cela renvoie 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 renvoyée. Sur Android, l'orientation est calculée lors de l'appel de la méthode à 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 l'émission d'é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-l’avec @capgo/capacitor-compass pour les détails d'implémentation dans @capgo/capacitor-compass, Prise en main pour les détails d'implémentation dans Prise en main, 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 l'Introduction, et API Clés pour les détails d'implémentation dans API Clés.