Langue

AlarmManager.SetAlarmClock(AlarmManager+AlarmClockInfo, PendingIntent) Méthode

Définition

Espace de noms:
Android.App
Assembly:
Mono.Android.dll

Planifiez une alarme qui représente une horloge d’alarme, qui sera utilisée pour avertir l’utilisateur lorsqu’il se désactive.

[Android.Runtime.Register("setAlarmClock", "(Landroid/app/AlarmManager$AlarmClockInfo;Landroid/app/PendingIntent;)V", "GetSetAlarmClock_Landroid_app_AlarmManager_AlarmClockInfo_Landroid_app_PendingIntent_Handler")]
[Android.Runtime.RequiresPermission("android.permission.SCHEDULE_EXACT_ALARM")]
public virtual void SetAlarmClock(Android.App.AlarmManager.AlarmClockInfo info, Android.App.PendingIntent operation);
[<Android.Runtime.Register("setAlarmClock", "(Landroid/app/AlarmManager$AlarmClockInfo;Landroid/app/PendingIntent;)V", "GetSetAlarmClock_Landroid_app_AlarmManager_AlarmClockInfo_Landroid_app_PendingIntent_Handler")>]
[<Android.Runtime.RequiresPermission("android.permission.SCHEDULE_EXACT_ALARM")>]
abstract member SetAlarmClock : Android.App.AlarmManager.AlarmClockInfo * Android.App.PendingIntent -> unit
override this.SetAlarmClock : Android.App.AlarmManager.AlarmClockInfo * Android.App.PendingIntent -> unit

Paramètres

info
AlarmManager.AlarmClockInfo

AlarmManager.AlarmClockInfo : cette valeur ne peut pas être null.

operation
PendingIntent

PendingIntent : action à effectuer lorsque l’alarme est désactivée ; provient généralement de IntentSender.getBroadcast(). Cette valeur ne peut pas être null.

Attributs
RegisterAttribute RequiresPermissionAttribute

Remarques

Planifiez une alarme qui représente une horloge d’alarme, qui sera utilisée pour avertir l’utilisateur lorsqu’il se désactive. L’attente est que lorsque cette alarme se déclenche, l’application réveille davantage l’appareil pour informer l’utilisateur de l’alarme - activer l’écran, lire un son, vibrer, etc. Par conséquent, le système utilisera généralement les informations fournies ici pour informer l’utilisateur de cette alarme à venir si nécessaire. En raison de la nature de ce type d’alarme, similaire à setExactAndAllowWhileIdle(int, long, PendingIntent), ces alarmes seront autorisées à se déclencher même si le système est en mode inactif à faible alimentation (a.k.a. doze). Le système peut également effectuer un certain travail de préparation lorsqu’il voit qu’une telle alarme s’affiche, pour réduire la quantité de travail en arrière-plan qui pourrait se produire si cela provoque le réveil complet de l’appareil - il s’agit d’éviter des situations telles qu’un grand nombre d’appareils ayant une alarme définie en même temps le matin, tout se réveiller à ce moment-là et soudainement marécager le réseau avec un travail en arrière-plan en attente. Par conséquent, ces types d’alarmes peuvent être extrêmement coûteux sur l’utilisation de la batterie et ne doivent être utilisés que pour leur objectif prévu.

Cette méthode est semblable à setExact(int,long,PendingIntent), mais implique RTC_WAKEUP. 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. 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. Les alarmes planifiées via cette API sont autorisées à démarrer un service de premier plan même si l’application est en arrière-plan. Nécessite Manifest.permission.SCHEDULE_EXACT_ALARM

Voir aussi :

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

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.

S’applique à