AlarmManager.SetAndAllowWhileIdle(AlarmType, Int64, PendingIntent) 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.
Comme #set(int, long, PendingIntent), mais cette alarme est autorisée à s’exécuter même lorsque le système est inactif à faible alimentation (a.
[Android.Runtime.Register("setAndAllowWhileIdle", "(IJLandroid/app/PendingIntent;)V", "GetSetAndAllowWhileIdle_IJLandroid_app_PendingIntent_Handler", ApiSince=23)]
public virtual void SetAndAllowWhileIdle (Android.App.AlarmType type, long triggerAtMillis, Android.App.PendingIntent operation);[<Android.Runtime.Register("setAndAllowWhileIdle", "(IJLandroid/app/PendingIntent;)V", "GetSetAndAllowWhileIdle_IJLandroid_app_PendingIntent_Handler", ApiSince=23)>]
abstract member SetAndAllowWhileIdle : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit
override this.SetAndAllowWhileIdle : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unitParamètres
- type
- AlarmType
type d’alarme.
- triggerAtMillis
- Int64
durée en millisecondes pendant laquelle l’alarme doit s’éteindre, à l’aide de l’horloge appropriée (selon le type d’alarme).
- operation
- PendingIntent
Action à effectuer lorsque l’alarme s’éteint ; provient généralement de PendingIntent#getBroadcast
IntentSender.getBroadcast().
- Attributs
Remarques
Comme #set(int, long, PendingIntent), mais cette alarme sera autorisée à s’exécuter même lorsque le système est en mode inactif à faible alimentation (a.k.a. doze). Ce type d’alarme doit <être>utilisé uniquement</b> pour les situations où il est réellement nécessaire que l’alarme s’éteigne pendant l’inactivité , un exemple raisonnable serait pour une notification de calendrier qui doit émettre un son afin que l’utilisateur soit conscient de celui-ci. Lorsque l’alarme est distribuée, l’application est également ajoutée à la liste d’exemption d’alimentation temporaire du système pendant environ 10 secondes pour permettre à cette application d’acquérir d’autres verrous de veille dans lesquels effectuer son travail.</p>
Ces alarmes peuvent avoir un impact significatif sur l’utilisation de l’alimentation de l’appareil en cas d’inactivité (et donc causer une charge importante à l’application qui les planifie), de sorte qu’elles doivent être utilisées avec soin. Pour réduire les abus, il existe des restrictions sur la fréquence à laquelle ces alarmes seront désactivées pour une application particulière. En cas de fonctionnement normal du système, il n’envoie pas ces alarmes plus d’environ toutes les minutes (à quel moment toutes ces alarmes en attente sont distribuées) ; lorsque dans les modes inactifs à faible alimentation, cette durée peut être considérablement plus longue, par exemple 15 minutes.
Contrairement à d’autres alarmes, le système est libre de replanifier ce type d’alarme pour se produire hors d’ordre avec d’autres alarmes, même celles de la même application. Cela se produit clairement lorsque l’appareil est inactif (car cette alarme peut s’éteindre pendant l’inactivité, quand toutes les autres alarmes de l’application seront conservées jusqu’à plus tard), mais peut également se produire même lorsqu’elle n’est pas inactive.
Quelle que soit la version du SDK cible de l’application, cet appel autorise toujours le traitement par lots de l’alarme.
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.