Freigeben über

AlarmManager.SetWindow Methode

  • Referenz

Definition

Namespace:
Android.App
Assembly:
Mono.Android.dll

Überlädt

SetWindow(AlarmType, Int64, Int64, PendingIntent)

Planen Sie einen Alarm, der innerhalb eines bestimmten Zeitfensters übermittelt werden soll.
SetWindow(AlarmType, Int64, Int64, String, AlarmManager+IOnAlarmListener, Handler)

Planen Sie einen Alarm, der innerhalb eines bestimmten Zeitfensters übermittelt werden soll.
SetWindow(AlarmType, Int64, Int64, String, IExecutor, AlarmManager+IOnAlarmListener)

SetWindow(AlarmType, Int64, Int64, PendingIntent)

Planen Sie einen Alarm, der innerhalb eines bestimmten Zeitfensters übermittelt werden soll.

[Android.Runtime.Register("setWindow", "(IJJLandroid/app/PendingIntent;)V", "GetSetWindow_IJJLandroid_app_PendingIntent_Handler")]
public virtual void SetWindow (Android.App.AlarmType type, long windowStartMillis, long windowLengthMillis, Android.App.PendingIntent operation);
[<Android.Runtime.Register("setWindow", "(IJJLandroid/app/PendingIntent;)V", "GetSetWindow_IJJLandroid_app_PendingIntent_Handler")>]
abstract member SetWindow : Android.App.AlarmType * int64 * int64 * Android.App.PendingIntent -> unit
override this.SetWindow : Android.App.AlarmType * int64 * int64 * Android.App.PendingIntent -> unit

Parameter

type
AlarmType

Art des Alarms.

windowStartMillis
Int64

Die früheste Zeit in Millisekunden, dass der Alarm geliefert werden sollte, ausgedrückt in den Einheiten der entsprechenden Uhr (je nach Alarmtyp).

windowLengthMillis
Int64

Die Länge des angeforderten Lieferfensters in Millisekunden. Der Alarm wird spätestens nach windowStartMillisdiesen vielen Millisekunden geliefert. Beachten Sie, dass dieser Parameter eine Dauer und nicht der Zeitstempel des Endes des Fensters ist.

operation
PendingIntent

Aktion auszuführen, wenn der Alarm abläuft; kommt in der Regel von PendingIntent#getBroadcast IntentSender.getBroadcast().

Attribute
RegisterAttribute

Hinweise

Planen Sie einen Alarm, der innerhalb eines bestimmten Zeitfensters übermittelt werden soll. Diese Methode ähnelt #set(int, long, PendingIntent), ermöglicht der Anwendung jedoch die genaue Kontrolle des Grads, in dem die Lieferung durch das Betriebssystem angepasst werden kann. Mit dieser Methode kann eine Anwendung die Akkuoptimierungen nutzen, die sich aus der Übermittlungsbatchierung ergeben, auch wenn sie bescheidene Zeitachsenanforderungen für ihre Alarme aufweist.

Hinweis: Ab API Build.VERSION_CODES#Ssollten Apps in einem Fenster von weniger als 10 Minuten nicht übergeben werden. Das System versucht am besten, kleinere Fenster aufzunehmen, wenn der Alarm in naher Zukunft ausgelöst werden soll, aber es gibt keine Garantien, und die App sollte erwarten, dass ein Fenster kleiner als 10 Minuten ist, um bis zu 10 Minuten verlängert zu werden.

Diese Methode kann auch verwendet werden, um strenge Anordnungsgarantien zwischen mehreren Alarmen zu erreichen, indem sichergestellt wird, dass die für jeden Alarm angeforderten Fenster nicht überschneiden.

Wenn keine präzise Lieferung erforderlich ist, sollten Anwendungen die Standardmethode #set(int, long, PendingIntent) verwenden. Dies bietet dem Betriebssystem die größte Flexibilität, um Die Aktivierungen und den Akkueinsatz zu minimieren. Für Alarme, die zu genau festgelegten Zeiten ohne akzeptable Variation geliefert werden müssen, können Anwendungen verwenden #setExact(int, long, PendingIntent).

Java-Dokumentation für android.app.AlarmManager.setWindow(int, long, long, android.app.PendingIntent).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Weitere Informationen

  • <xref:Android.App.AlarmManager.Set(Android.App.AlarmType%2c+System.Int64%2c+System.Int64)>
  • <xref:Android.App.AlarmManager.SetExact(Android.App.AlarmType%2c+System.Int64%2c+System.Int64)>
  • <xref:Android.App.AlarmManager.SetRepeating(Android.App.AlarmType%2c+System.Int64%2c+System.Int64%2c+System.Int64)>
  • Cancel(PendingIntent)
  • SendBroadcast(Intent)
  • <xref:Android.Content.Context.RegisterReceiver(Android.Content.BroadcastReceiver%2c+Android.Content.IntentFilter)>
  • FilterEquals(Intent)

Gilt für:

SetWindow(AlarmType, Int64, Int64, String, AlarmManager+IOnAlarmListener, Handler)

Planen Sie einen Alarm, der innerhalb eines bestimmten Zeitfensters übermittelt werden soll.

[Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSetWindow_IJJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)]
public virtual void SetWindow (Android.App.AlarmType type, long windowStartMillis, long windowLengthMillis, string? tag, Android.App.AlarmManager.IOnAlarmListener listener, Android.OS.Handler? targetHandler);
[<Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSetWindow_IJJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)>]
abstract member SetWindow : Android.App.AlarmType * int64 * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit
override this.SetWindow : Android.App.AlarmType * int64 * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit

Parameter

type
AlarmType

Art des Alarms.

windowStartMillis
Int64

Die früheste Zeit in Millisekunden, dass der Alarm geliefert werden sollte, ausgedrückt in den Einheiten der entsprechenden Uhr (je nach Alarmtyp).

windowLengthMillis
Int64

Die Länge des angeforderten Lieferfensters in Millisekunden. Der Alarm wird spätestens nach windowStartMillisdiesen vielen Millisekunden geliefert. Beachten Sie, dass dieser Parameter eine Dauer und nicht der Zeitstempel des Endes des Fensters ist.

tag
String
listener
AlarmManager.IOnAlarmListener
targetHandler
Handler
Attribute
RegisterAttribute

Hinweise

Java-Dokumentation für android.app.AlarmManager.setWindow(int, long, long, android.app.PendingIntent).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für:

SetWindow(AlarmType, Int64, Int64, String, IExecutor, AlarmManager+IOnAlarmListener) 

[Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Ljava/util/concurrent/Executor;Landroid/app/AlarmManager$OnAlarmListener;)V", "GetSetWindow_IJJLjava_lang_String_Ljava_util_concurrent_Executor_Landroid_app_AlarmManager_OnAlarmListener_Handler", ApiSince=34)]
public virtual void SetWindow (Android.App.AlarmType type, long windowStartMillis, long windowLengthMillis, string? tag, Java.Util.Concurrent.IExecutor executor, Android.App.AlarmManager.IOnAlarmListener listener);
[<Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Ljava/util/concurrent/Executor;Landroid/app/AlarmManager$OnAlarmListener;)V", "GetSetWindow_IJJLjava_lang_String_Ljava_util_concurrent_Executor_Landroid_app_AlarmManager_OnAlarmListener_Handler", ApiSince=34)>]
abstract member SetWindow : Android.App.AlarmType * int64 * int64 * string * Java.Util.Concurrent.IExecutor * Android.App.AlarmManager.IOnAlarmListener -> unit
override this.SetWindow : Android.App.AlarmType * int64 * int64 * string * Java.Util.Concurrent.IExecutor * Android.App.AlarmManager.IOnAlarmListener -> unit

Parameter

type
AlarmType
windowStartMillis
Int64
windowLengthMillis
Int64
tag
String
executor
IExecutor
listener
AlarmManager.IOnAlarmListener
Attribute
RegisterAttribute

Gilt für: