AlarmManager.SetAndAllowWhileIdle(AlarmType, Int64, PendingIntent) Méthode

Définition

Espace de noms:: Android.App

Assembly:: Mono.Android.dll

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 -> unit

Paramè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: RegisterAttribute

Remarques

Comme set(int,long,PendingIntent), mais cette alarme est 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 ne doit être utilisé que 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 faire 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 temporaires de l’alimentation du système pendant environ 10 secondes pour permettre à cette application d’acquérir d’autres verrous de veille dans lesquels effectuer son travail.

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.

Voir aussi :

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

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 à