AlarmManager.SetWindow Méthode

[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

Attributs

RegisterAttribute

Remarques

Planifiez la livraison d’une alarme dans une fenêtre donnée. Cette méthode est similaire à set(int,long,PendingIntent), mais permet à 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 : À partir de Build.VERSION_CODES d’API. S, les applications ne doivent pas passer dans une fenêtre de moins de 10 minutes. Le système va essayer son meilleur 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 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 fournies à des moments précis sans variation acceptable, les applications peuvent utiliser setExact(int,long,PendingIntent).

Voir aussi :

Référence Android pour android.app.AlarmManager.setWindow.

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

[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

Attributs

RegisterAttribute

Remarques

Version de rappel directe de setWindow(int,long,long,PendingIntent). Au lieu de fournir une instance PendingIntent à envoyer lorsque l’heure de l’alarme est atteinte, cette variante fournit une instance OnAlarmListener qui sera appelée à ce moment-là. Les alarmes basées sur l’écouteur peuvent être annulées par le système Android chaque fois que le processus appelant n’a plus de composants en cours d’exécution, tels que l’activité, le service ou contentProvider. Utilisez donc uniquement ces API lorsque vous n’avez pas besoin de recevoir d’alarmes une fois le composant actuel terminé, et veillez également à les annuler (OnAlarmListener) lorsqu’il le fait. Par exemple, si vous utilisez ces API à partir d’une activité, veillez à annuler les alarmes respectives une fois l’activité terminée. Si vous devez recevoir l’alarme même après cela, utilisez les API En attenteIntent. La méthode OnAlarmListener onAlarm() est appelée via le gestionnaire cible spécifié ou sur le bouclage principal de l’application si la valeur Null est passée en tant que paramètre targetHandler. Remarque : À partir de Build.VERSION_CODES d’API. S, les applications ne doivent pas passer dans une fenêtre de moins de 10 minutes. Le système va essayer son meilleur 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.

Voir aussi :

Référence Android pour android.app.AlarmManager.setWindow.

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

[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

Attributs

RegisterAttribute

Remarques

Version de rappel directe de setWindow(int,long,long,PendingIntent). Au lieu de fournir une instance PendingIntent à envoyer lorsque l’heure de l’alarme est atteinte, cette variante fournit une instance OnAlarmListener qui sera appelée à ce moment-là. Les alarmes basées sur l’écouteur peuvent être annulées par le système Android chaque fois que le processus appelant n’a plus de composants en cours d’exécution, tels que l’activité, le service ou contentProvider. Utilisez donc uniquement ces API lorsque vous n’avez pas besoin de recevoir d’alarmes une fois le composant actuel terminé, et veillez également à les annuler (OnAlarmListener) lorsqu’il le fait. Par exemple, si vous utilisez ces API à partir d’une activité, veillez à annuler les alarmes respectives une fois l’activité terminée. Si vous devez recevoir l’alarme même après cela, utilisez les API En attenteIntent. La méthode OnAlarmListener onAlarm() sera appelée via l’exécuteur cible spécifié. Remarque : À partir de Build.VERSION_CODES d’API. S, les applications ne doivent pas passer dans une fenêtre de moins de 10 minutes. Le système va essayer son meilleur 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.

Voir aussi :

Le contenu et les exemples de code de cette page sont soumis aux licences décrites dans la licence de contenu. Java et OpenJDK sont des marques ou des marques déposées d’Oracle et/ou de ses affiliés.

Dernière mise à jour 2026-08-03 UTC.

Référence Android pour android.app.AlarmManager.setWindow.

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