Partager via


AlarmManager.SetWindow Méthode

Définition

Surcharges

SetWindow(AlarmType, Int64, Int64, PendingIntent)

Planifiez la livraison d’une alarme dans une fenêtre donnée.

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

Planifiez la livraison d’une alarme dans une fenêtre donnée.

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

SetWindow(AlarmType, Int64, Int64, PendingIntent)

Planifiez la livraison d’une alarme dans une fenêtre donnée.

[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

Paramètres

type
AlarmType

type d’alarme.

windowStartMillis
Int64

Le plus tôt, en millisecondes, que l’alarme doit être livrée, exprimée dans les unités de l’horloge appropriée (selon le type d’alarme).

windowLengthMillis
Int64

Longueur de la fenêtre de remise demandée, en millisecondes. L’alarme sera remise pas plus tard que ce nombre de millisecondes après windowStartMillis. Notez que ce paramètre est une durée, et non l’horodatage de la fin de la fenêtre.

operation
PendingIntent

Action à effectuer lorsque l’alarme s’éteint ; provient généralement de PendingIntent#getBroadcast IntentSender.getBroadcast().

Attributs

Remarques

Planifiez la livraison d’une alarme dans une fenêtre donnée. Cette méthode est similaire à , mais permet à #set(int, long, PendingIntent)l’application de contrôler précisément le degré auquel sa livraison peut être ajustée par le système d’exploitation. Cette méthode permet à une application de tirer parti des optimisations de batterie qui proviennent du traitement par lot de livraison même lorsqu’elle a des exigences de chronologie modestes pour ses alarmes.

Remarque : À compter de l’API Build.VERSION_CODES#S, les applications ne doivent pas passer dans une fenêtre de moins de 10 minutes. Le système va essayer son mieux pour prendre en charge les fenêtres plus petites si l’alarme est censée se déclencher dans un avenir proche, mais il n’y a aucune garantie et l’application doit s’attendre à une fenêtre inférieure à 10 minutes pour être allongée à 10 minutes.

Cette méthode peut également être utilisée pour obtenir des garanties de classement strictes entre plusieurs alarmes en garantissant que les fenêtres demandées pour chaque alarme ne se croisent pas.

Lorsque la remise précise n’est pas nécessaire, les applications doivent utiliser la méthode standard #set(int, long, PendingIntent) . Cela donnera au système d’exploitation la plus grande flexibilité pour réduire l’utilisation des éveils et de la batterie. Pour les alarmes qui doivent être livrées à des moments précis sans variation acceptable, les applications peuvent utiliser #setExact(int, long, PendingIntent).

Documentation Java pour android.app.AlarmManager.setWindow(int, long, long, android.app.PendingIntent).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

Voir aussi

  • <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)

S’applique à

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

Planifiez la livraison d’une alarme dans une fenêtre donnée.

[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

Paramètres

type
AlarmType

type d’alarme.

windowStartMillis
Int64

Le plus tôt, en millisecondes, que l’alarme doit être livrée, exprimée dans les unités de l’horloge appropriée (selon le type d’alarme).

windowLengthMillis
Int64

Longueur de la fenêtre de remise demandée, en millisecondes. L’alarme sera remise pas plus tard que ce nombre de millisecondes après windowStartMillis. Notez que ce paramètre est une durée, et non l’horodatage de la fin de la fenêtre.

tag
String
targetHandler
Handler
Attributs

Remarques

Documentation Java pour android.app.AlarmManager.setWindow(int, long, long, android.app.PendingIntent).

Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.

S’applique à

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

Paramètres

type
AlarmType
windowStartMillis
Int64
windowLengthMillis
Int64
tag
String
executor
IExecutor
Attributs

S’applique à