AlarmManager.SetWindow Méthode
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
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)
.
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
- listener
- AlarmManager.IOnAlarmListener
- targetHandler
- Handler
- Attributs
Remarques
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
- listener
- AlarmManager.IOnAlarmListener
- Attributs