flutter_alarm_background_trigger

Visão geral do pacote

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

Um plugin Flutter para Android que permite iniciar um aplicativo em segundo plano em um horário específico, imitando o comportamento do aplicativo nativo de alarme do Android. Permite aos desenvolvedores agendar despertares do aplicativo mesmo quando o aplicativo está fechado ou o dispositivo está em sono profundo, sendo ideal para aplicativos de alarme, lembretes e notificações programadas. O plugin utiliza as APIs JobScheduler e AlarmManager do Android para garantir execução confiável. Não é compatível com iOS. O pacote é leve e se integra perfeitamente a projetos existentes do Flutter.

Casos de uso

Agendamento de alarmes
Implementando aplicativos de lembrete
Disparando tarefas em segundo plano em horários específicos
Criando notificações baseadas em tempo
Habilitar o lançamento do aplicativo no modo de suspensão

Principais recursos

Início de aplicativo em segundo plano
Suporte apenas para Android
Usa JobScheduler e AlarmManager
Integração simples com o Flutter
Tempo confiável para eventos agendados

Indicado para

Desenvolvedores de aplicativos de alarme
construtores do sistema de lembretes
Processamento em segundo plano acionado por tempo
Aplicativos Flutter voltados para Android
Aplicativos que exigem agendamento preciso de despertar

Considerações

Funciona apenas no Android
Requer configuração apropriada do manifesto do Android
Pode ser afetado por configurações de otimização de bateria
Limitado à plataforma Android
Necessita permissão do usuário para execução em segundo plano

README original

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

Flutter background alarm trigger

A flutter plugin for Android to launch app from background at specific time just like stock alarm app in Android

Installation

flutter_alarm_background_trigger: ^1.0.0
# or
flutter pub add flutter_alarm_background_trigger

Initialization

void main() {
  // Very important to call before initialize since it 
  // ensures the binding is available and ready before 
  // any native call
  WidgetsFlutterBinding.ensureInitialized();

  // initialize Required for alarm events to bind with flutter method channel
  FlutterAlarmBackgroundTrigger.initialize();

  runApp(const MyApp());
}

Create instance

var alarmPlugin = FlutterAlarmBackgroundTrigger();

Set Alarm

alarmPlugin.addAlarm(
      // Required
      DateTime.now().add(Duration(seconds: 10)),

      //Optional
      uid: "YOUR_APP_ID_TO_IDENTIFY",
      payload: {"YOUR_EXTRA_DATA":"FOR_ALARM"},

      // screenWakeDuration: For how much time you want 
      // to make screen awake when alarm triggered
      screenWakeDuration: Duration(minutes: 1)
  )

Receive event when alarm trigger

alarmPlugin.requestPermission().then((isGranted){
  if(isGranted){
    alarmPlugin.onForegroundAlarmEventHandler((alarm){
      // Perform your action here such as navigation
      // This event will be triggered on both cases, 
      // when app is in foreground or background!
      print(alarm.id)
    })
  }
})

Additional methods

Request permission to draw over other apps

Future<bool> requestPermission()

Add

Future<AlarmItem> addAlarm(
  DateTime time, 
  {
    String? uid, 
    Map<String, dynamic>? payload, 
    Duration screenWakeDuration
  }
)

Get alarm by uid

Future<List<AlarmItem>> getAlarmByUid(String uid)

Get all scheduled alarms

Future<List<AlarmItem>> getAllAlarms()

Get single alarm

Future<AlarmItem> getAlarm(int id)

Get alarm by payload

Future<List<AlarmItem>> getAlarmByPayload(Map<String, dynamic> payload)

Get alarm by time

Future<List<AlarmItem>> getAlarmByTime(DateTime time)

Alarm trigger event

void onForegroundAlarmEventHandler(OnForegroundAlarmEvent alarmEvent)

Delete single alarm

Future<void> deleteAlarm(int id)

Delete by payload

Future<void> deleteAlarmsByPayload(Map<String, dynamic> payload)

Delete by time

Future<void> deleteAlarmsByTime(DateTime dateTime)

Delete by uid

Future<void> deleteAlarmsByUid(String uid)

Delete all scheduled alarms

Future<void> deleteAllAlarms()

Buscar pacotes, repositórios e categorias de apps

Instalar pacote