AlarmManager.Set Methode

[Android.Runtime.Register("set", "(IJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSet_IJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)]
public virtual void Set(Android.App.AlarmType type, long triggerAtMillis, string? tag, Android.App.AlarmManager.IOnAlarmListener listener, Android.OS.Handler? targetHandler);

[<Android.Runtime.Register("set", "(IJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSet_IJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)>]
abstract member Set : Android.App.AlarmType * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit
override this.Set : Android.App.AlarmType * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit

Parameter

Attribute

RegisterAttribute

Hinweise

Direkte Rückrufversion von set(int,long,PendingIntent). Anstatt beim Erreichen der Alarmzeit einen PendingIntent zu senden, stellt diese Variante eine OnAlarmListener-Instanz bereit, die zu diesem Zeitpunkt aufgerufen wird. Listener-basierte Alarme können vom Android-System abgebrochen werden, wenn der aufrufende Prozess keine Komponenten mehr ausgeführt wird, z. B. Aktivität, Dienst oder ContentProvider, sodass Sie diese APIs nur verwenden müssen, wenn Sie nach Abschluss der aktuellen Komponente keine Alarme empfangen müssen, und stellen Sie außerdem sicher, dass sie (OnAlarmListener) abbrechen(OnAlarmListener). Wenn Sie diese APIs beispielsweise aus einer Aktivität verwenden, stellen Sie sicher, dass die entsprechenden Alarme abgebrochen werden, wenn die Aktivität abgeschlossen ist. Wenn Sie den Alarm auch danach erhalten müssen, verwenden Sie die PendingIntent-basierten APIs. Die OnAlarmListener-OnAlarm()-Methode wird über den angegebenen Zielhandler oder in der Hauptschleife der Anwendung aufgerufen, wenn NULL als TargetHandler-Parameter übergeben wird.

Android-Referenz für android.app.AlarmManager.set.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.

[Android.Runtime.Register("set", "(IJLandroid/app/PendingIntent;)V", "GetSet_IJLandroid_app_PendingIntent_Handler")]
public virtual void Set(Android.App.AlarmType type, long triggerAtMillis, Android.App.PendingIntent operation);

[<Android.Runtime.Register("set", "(IJLandroid/app/PendingIntent;)V", "GetSet_IJLandroid_app_PendingIntent_Handler")>]
abstract member Set : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit
override this.Set : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit

Parameter

Attribute

RegisterAttribute

Hinweise

Planen Sie einen Alarm. Hinweis: Für Zeitplanungsvorgänge (Ticks, Timeouts usw.) ist es einfacher und viel effizienter, den Handler zu verwenden. Wenn bereits ein Alarm für denselben IntentSender geplant ist, wird dieser vorherige Alarm zuerst abgebrochen. Wenn die angegebene Auslösezeit in der Vergangenheit liegt, wird der Alarm sofort ausgelöst. Wenn bereits ein Alarm für diese Absicht geplant ist (mit der Gleichheit von zwei Absichten, die von Intent.filterEquals definiert werden), wird sie entfernt und durch diese ersetzt. Der Alarm ist eine Intent-Übertragung, die an einen Übertragungsempfänger gesendet wird, den Sie bei Context.registerReceiver(BroadcastReceiver, IntentFilter) oder über das <Empfängertag> in einer AndroidManifest.xml Datei registriert haben. Alarmabsichten werden mit einem zusätzlichen Datentyp bereitgestellt, der als Intent.EXTRA_ALARM_COUNT bezeichnet wird, der angibt, wie viele vergangene Alarmereignisse in dieser Absichtsübertragung gesammelt wurden. Wiederkehrende Alarme, die nicht mehr zugestellt wurden, weil das Telefon eingeschlafen war, kann eine Anzahl größer als eins sein, wenn es zugestellt wurde. Hinweis: Ab API 19 wird die an diese Methode übergebene Auslösezeit als ungenau behandelt: Der Alarm wird nicht vor dieser Zeit übermittelt, kann jedoch einige Zeit später zurückgestellt und übermittelt werden. Das Betriebssystem verwendet diese Richtlinie, um Alarme im gesamten System zu "stapeln", wodurch die Häufigkeit minimiert wird, mit der das Gerät "aufwachen" und den Akkueinsatz minimiert. Im Allgemeinen werden alarmierte Alarme, die in naher Zukunft geplant sind, nicht verzögert, solange in Zukunft Alarme geplant sind. Mit der neuen Chargenrichtlinie sind Lieferauftragsgarantien nicht so stark wie zuvor. Wenn die Anwendung mehrere Alarme festlegt, ist es möglich, dass die tatsächlichen Lieferbestellungen dieser Alarme möglicherweise nicht mit der Bestellung ihrer angeforderten Lieferzeiten übereinstimmen. Wenn Ihre Anwendung starke Sortieranforderungen hat, gibt es andere APIs, die Sie verwenden können, um das erforderliche Verhalten zu erhalten. siehe setWindow(int,long,long,PendingIntent) und setExact(int,long,PendingIntent). Anwendungen, deren targetSdkVersion vor API 19 liegt, erhalten weiterhin das vorherige Alarmverhalten: Alle geplanten Alarme werden genau behandelt.

Siehe auch:

Android-Referenz für android.app.AlarmManager.set.

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die von der Android Open Source Project erstellt und gemeinsam verwendet und gemäß den in der 2.5 Attribution License beschriebenen Begriffen verwendet werden.