AlarmManager.SetExact Méthode

[Android.Runtime.Register("setExact", "(IJLandroid/app/PendingIntent;)V", "GetSetExact_IJLandroid_app_PendingIntent_Handler")]
[Android.Runtime.RequiresPermission("android.permission.SCHEDULE_EXACT_ALARM")]
public virtual void SetExact(Android.App.AlarmType type, long triggerAtMillis, Android.App.PendingIntent operation);

[<Android.Runtime.Register("setExact", "(IJLandroid/app/PendingIntent;)V", "GetSetExact_IJLandroid_app_PendingIntent_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.SCHEDULE_EXACT_ALARM")>]
abstract member SetExact : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit
override this.SetExact : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit

Paramètres

Attributs

RegisterAttribute RequiresPermissionAttribute

Remarques

Planifiez une alarme à livrer précisément à l’heure indiquée. Cette méthode est semblable à set(int,long,PendingIntent), mais ne permet pas au système d’exploitation d’ajuster le délai de livraison. L’alarme sera remise le plus près possible de l’heure de déclenchement demandée. Remarque : seules les alarmes pour lesquelles il existe une forte demande de livraison à temps exact (par exemple, une sonnerie d’horloge d’alarme au moment demandé) doivent être planifiées comme exactes. Les applications sont fortement déconseillées d’utiliser des alarmes exactes inutilement, car elles réduisent la capacité du système d’exploitation à réduire l’utilisation de la batterie. Remarque : à partir de Build.VERSION_CODES. S, les applications ciblant le SDK niveau 31 ou supérieur doivent demander l’autorisation SCHEDULE_EXACT_ALARM d’utiliser cette API, sauf si l’application est exemptée des restrictions de batterie. L’utilisateur et le système peuvent révoquer cette autorisation via l’écran d’accès d’application spécial dans Paramètres. Remarque : Les alarmes exactes ne doivent être utilisées que pour les fonctionnalités accessibles par l’utilisateur. Pour plus d’informations, consultez l’autorisation d’alarme exacte.

Voir aussi :

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

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("setExact", "(IJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSetExact_IJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)]
public virtual void SetExact(Android.App.AlarmType type, long triggerAtMillis, string? tag, Android.App.AlarmManager.IOnAlarmListener listener, Android.OS.Handler? targetHandler);

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

Paramètres

Attributs

RegisterAttribute

Remarques

Version de rappel directe de setExact(int,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 de OnAlarm() sera 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. Sur les versions android précédentes Build.VERSION_CODES. S et Build.VERSION_CODES. TIRAMISU, applications ciblant le sdk niveau 31 ou supérieur nécessaire pour contenir l’autorisation SCHEDULE_EXACT_ALARM d’utiliser cette API, sauf si l’application a été exemptée des restrictions de batterie. Remarque : À partir de la version android Build.VERSION_CODES. UPSIDE_DOWN_CAKE, le système supprime explicitement toutes les alarmes définies via cette API lorsque l’application appelante sort du cycle de vie.

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

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.