Buscar pacotes, repositórios e categorias de apps

ducafecatGuia do ecossistema Flutter
Detalhes do pacotev1.0.1

compassx

Plugin de bússola Flutter que oferece rumo verdadeiro, precisão e necessidades de calibração.

AndroidiOS
pub.dev Documentação da API Código-fonte
Downloads em 30 dias
2,1 mil
Curtidas
20
Pontos Pub
150

Instalar pacote

flutter pub add compassx

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

CompassX é um plugin Flutter que fornece acesso aos dados do bússola do dispositivo, incluindo rumo verdadeiro, precisão magnética e status de calibração. Ele suporta as plataformas Android e iOS, fornecendo informações em tempo real sobre orientação por meio dos sensores do dispositivo. O plugin é ideal para aplicações de navegação, mapeamento e realidade aumentada que exigem entrada direcional precisa. Com configuração mínima via `flutter pub add compassx`, os desenvolvedores podem integrar funcionalidades confiáveis de bússola em seus aplicativos. O código-fonte está disponível publicamente no GitHub para transparência e personalização.

Casos de uso

  • Aplicativos de navegação
  • experiências de realidade aumentada
  • rastreamento de atividades ao ar livre
  • Aplicações baseadas em mapas
  • Elementos de interface direcionais

Principais recursos

  • Suporte de rumo verdadeiro
  • Relatório de precisão magnética
  • Atualizações em tempo real do sensor
  • Monitoramento de status de calibração
  • Compatibilidade multiplataforma

Indicado para

  • Desenvolvedores construindo ferramentas de navegação
  • Aplicativos que exigem consciência direcional
  • AR e serviços baseados em localização
  • Aplicativos móveis que precisam de integração de sensores

Considerações

  • Requer dispositivo com magnetômetro
  • A precisão depende do ambiente
  • Pode ser necessário calibração do usuário
  • Operação em segundo plano limitada em alguns dispositivos
  • O iOS exige permissão de privacidade

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

CompassX

Logo

Provides reliable compass data and extensive documentation.

Usage

StreamBuilder<CompassXEvent>(
  stream: CompassX.events,
  builder: (context, snapshot) {
    if (!snapshot.hasData) return const Text('No data');
    final compass = snapshot.data!;
    return Column(
      mainAxisSize: MainAxisSize.min,
      children: [
        Text('Heading: ${compass.heading}'),
        Text('Accuracy: ${compass.accuracy}'),
        Text('Should calibrate: ${compass.shouldCalibrate}'),
        Transform.rotate(
          angle: compass.heading * math.pi / 180,
          child: Icon(
            Icons.arrow_upward_rounded,
            size: MediaQuery.of(context).size.width - 80,
          ),
        ),
      ],
    );
  },
),
  • heading: The heading relative to true north in degree.
  • accuracy: The accuracy of the sensor data.
  • shouldCalibrate: Whether the sensor should be calibrated or not.

Install

$ flutter pub add compassx

Check the minimum supported version of your project and update as necessary.

  • iOS: 12
  • Android: 21

Request permission to get true heading in Android. Not required on iOS.

$ flutter pub add permission_handler

Specify the permissions one or both of the following in AndroidManifest.xml. It can be copied from example.

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
  • ACCESS_COARSE_LOCATION: Used when normal accuracy is required.
  • ACCESS_FINE_LOCATION: Used when the highest quality accuracy is required.

Add code to request permissions.

if (Platform.isAndroid) await Permission.location.request();

CompassX heading currently supports only portrait mode. It is recommended to fix the orientation of the device.

SystemChrome.setPreferredOrientations([
        DeviceOrientation.portraitUp,
        DeviceOrientation.portraitDown,
      ]);

Testing

It is recommended to use a real device. iOS simulators cannot use the heading sensor (compass). See Testing CompassX for details.

Documentation

If you are going to use this plugin in your product apps, I strongly suggest you read full documentation carefully.

Categorias

SensoresUtilitários de Geolocalização

Repositório-fonte

Projetos que usam este pacote

Ainda não há dados.