Freigeben über


AlarmManager.SetAndAllowWhileIdle(AlarmType, Int64, PendingIntent) Methode

Definition

Wie #set(int, long, PendingIntent), aber dieser Alarm kann auch ausgeführt werden, wenn sich das System im Leerlauf befindet (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

Parameter

type
AlarmType

Art des Alarms.

triggerAtMillis
Int64

Zeit in Millisekunden, die der Alarm abläuft, mit der entsprechenden Uhr (je nach Alarmtyp).

operation
PendingIntent

Aktion auszuführen, wenn der Alarm abläuft; kommt in der Regel von PendingIntent#getBroadcast IntentSender.getBroadcast().

Attribute

Hinweise

Wie #set(int, long, PendingIntent), aber dieser Alarm kann auch ausgeführt werden, wenn sich das System im Leerlaufmodus (z.B. Doze) befindet. Diese Art von Alarm muss <nur></b> für Situationen verwendet werden, in denen es tatsächlich erforderlich ist, dass der Alarm im Leerlauf abgeht - ein vernünftiges Beispiel wäre für eine Kalenderbenachrichtigung, die einen Sound machen sollte, damit der Benutzer darauf aufmerksam wird. Wenn der Alarm verteilt wird, wird die App auch für ca. 10 Sekunden zur temporären Ausnahmeliste des Systems hinzugefügt, damit diese Anwendung weitere Wake-Sperren erwerben kann, in denen ihre Arbeit abgeschlossen werden kann.</p>

Diese Alarme können sich erheblich auf den Stromverbrauch des Geräts auswirken, wenn sie im Leerlauf sind (und somit erhebliche Akkuschulden an der App-Planung verursachen), sodass sie mit Sorgfalt verwendet werden sollten. Um Missbrauch zu verringern, gibt es Einschränkungen darüber, wie häufig diese Alarme für eine bestimmte Anwendung abläuft. Im normalen Systembetrieb werden diese Alarme nicht mehr als jede Minute verteilt (zu diesem Zeitpunkt wird jeder solche ausstehende Alarm verteilt); wenn im Leerlaufmodus diese Dauer erheblich länger sein kann, z. B. 15 Minuten.

Im Gegensatz zu anderen Alarmen ist das System frei, diese Art von Alarm neu zu planen, um mit allen anderen Alarmen, auch mit denen aus derselben App, außer Ordnung zu kommen. Dies geschieht eindeutig, wenn das Gerät im Leerlauf ist (da dieser Alarm während des Leerlaufs ausgeschaltet werden kann, wenn andere Alarme aus der App bis zu einem späteren Zeitpunkt gehalten werden), aber auch dann auftreten, wenn er nicht im Leerlauf ist.

Unabhängig von der Ziel-SDK-Version der App ermöglicht dieser Aufruf immer die Batchverarbeitung des Alarms.

Java-Dokumentation für android.app.AlarmManager.setAndAllowWhileIdle(int, long, android.app.PendingIntent).

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.

Gilt für: