flutter_activity_recognition

Visão geral do pacote

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

O pacote flutter_activity_recognition permite que desenvolvedores detectem e respondam a atividades do usuário, como caminhar, correr, pedalar ou dirigir, em dispositivos Android e iOS. Ele utiliza APIs nativas da plataforma para fornecer reconhecimento de atividade em tempo real, tornando-o ideal para rastreamento de condicionamento físico, aplicativos de navegação e serviços baseados em contexto. O plugin é leve e se integra perfeitamente aos aplicativos Flutter. Suporta monitoramento de atividade em segundo plano e oferece atualizações baseadas em eventos para uso eficiente de recursos.

Casos de uso

Rastreamento de condicionamento físico e bem-estar
Aplicativos móveis conscientes do contexto
Sistemas de navegação inteligentes
análise baseada em atividades
Detecção de driver para aplicativos de segurança

Principais recursos

Detecção de atividade em tempo real
Suporte multiplataforma (Android e iOS)
monitoramento de atividade em segundo plano
API baseada em eventos
Leve e eficiente

Indicado para

Desenvolvedores construindo aplicativos de fitness
Aplicativos que exigem consciência do contexto do usuário
Aplicativos móveis que precisam de insights sobre atividades
Projetos envolvendo gatilhos baseados em movimento

Considerações

Permissões apropriadas são necessárias em ambas as plataformas
O uso da bateria pode aumentar com o monitoramento contínuo
Limitado ao hardware de dispositivo compatível
Pode ser necessário testar em dispositivos físicos
Considerações de privacidade para rastreamento contínuo de atividades

README original

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

This plugin is used to recognize user activity on Android and iOS platforms. To implement this plugin, Android used ActivityRecognitionClient and iOS used CMMotionActivityManager.

Features

Can request activity recognition permission.
Can subscribe to ActivityStream to listen activity in real time.

Getting started

To use this plugin, add flutter_activity_recognition as a dependency in your pubspec.yaml file. For example:

dependencies:
  flutter_activity_recognition: ^4.0.0

After adding the flutter_activity_recognition plugin to the flutter project, we need to specify the platform-specific permissions to use for this plugin to work properly.

:baby_chick: Android

Open the AndroidManifest.xml file and add the following permissions between the <manifest> and <application> tags.

<uses-permission android:name="android.permission.ACTIVITY_RECOGNITION" />
<uses-permission android:name="com.google.android.gms.permission.ACTIVITY_RECOGNITION" />

:baby_chick: iOS

Open the ios/Runner/Info.plist file and add the following permission inside the <dict> tag.

<key>NSMotionUsageDescription</key>
<string>Used to recognize user activity information.</string>

How to use

Checks whether activity recognition permission is granted.

Future<bool> _checkAndRequestPermission() async {
  ActivityPermission permission =
      await FlutterActivityRecognition.instance.checkPermission();
  if (permission == ActivityPermission.PERMANENTLY_DENIED) {
    // permission has been permanently denied.
    return false;
  } else if (permission == ActivityPermission.DENIED) {
    permission =
        await FlutterActivityRecognition.instance.requestPermission();
    if (permission != ActivityPermission.GRANTED) {
      // permission is denied.
      return false;
    }
  }

  return true;
}

To listen activity in real time, use the activityStream getter.

StreamSubscription<Activity>? _activitySubscription;

Future<void> _subscribeActivityStream() async {
  if (await _checkAndRequestPermission()) {
    _activitySubscription = FlutterActivityRecognition.instance.activityStream
        .handleError(_onError)
        .listen(_onActivity);
  }
}

void _onActivity(Activity activity) {
  print('activity detected >> ${activity.toJson()}');
}

void _onError(dynamic error) {
  print('error >> $error');
}

Background Mode

If you want to use this plugin in the background, use the flutter_foreground_task plugin.

Support

If you find any bugs or issues while using the plugin, please register an issues on GitHub. You can also contact us at <hwj930513@naver.com>.

Buscar pacotes, repositórios e categorias de apps

Instalar pacote