AlarmManager.SetAndAllowWhileIdle(AlarmType, Int64, PendingIntent) Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Come #set(int, long, PendingIntent), ma questo allarme sarà autorizzato a essere eseguito anche quando il sistema è inattiva a basso consumo (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 -> unitParametri
- type
- AlarmType
tipo di allarme.
- triggerAtMillis
- Int64
tempo in millisecondi in cui l'allarme deve essere spento, utilizzando l'orologio appropriato (a seconda del tipo di allarme).
- operation
- PendingIntent
Azione da eseguire quando l'allarme si spegne; in genere proviene da PendingIntent#getBroadcast
IntentSender.getBroadcast().
- Attributi
Commenti
Come #set(int, long, PendingIntent), ma questo allarme sarà autorizzato a essere eseguito anche quando il sistema è in modalità di inattività a basso consumo (ad esempio, doze). Questo tipo di allarme deve <essere usato solo< b>/b> per situazioni in cui è effettivamente necessario che l'allarme si spegne mentre è inattivo - un esempio ragionevole sarebbe per una notifica del calendario che dovrebbe fare un suono in modo che l'utente ne sia a conoscenza. Quando viene inviato l'allarme, l'app verrà aggiunta anche all'elenco di esenzione temporanea dell'alimentazione del sistema per circa 10 secondi per consentire all'applicazione di acquisire ulteriori blocchi di riattivazione in cui completare il lavoro.</p>
Questi allarmi possono influire significativamente sull'uso dell'alimentazione del dispositivo quando sono inattive (e quindi causare una significativa colpa della batteria per la pianificazione dell'app), quindi devono essere usati con attenzione. Per ridurre l'abuso, ci sono restrizioni sulla frequenza con cui questi allarmi andranno disattivati per una particolare applicazione. Nel normale funzionamento del sistema, non invierà questi allarmi più di circa ogni minuto (a quel punto ogni allarme in sospeso viene inviato); quando in modalità di inattività a basso consumo questa durata può essere significativamente più lunga, ad esempio 15 minuti.
A differenza di altri allarmi, il sistema è libero di riprogrammare questo tipo di allarme per verificarsi fuori ordine con qualsiasi altro allarme, anche quelli della stessa app. Ciò si verifica chiaramente quando il dispositivo è inattiva (poiché questo allarme può andare spento mentre è inattiva, quando qualsiasi altro allarme dall'app verrà mantenuto fino a un secondo momento), ma può verificarsi anche quando non è inattiva.
Indipendentemente dalla versione dell'SDK di destinazione dell'app, questa chiamata consente sempre l'invio in batch dell'allarme.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.