AlarmManager.SetAlarmClock(AlarmManager+AlarmClockInfo, 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.
Pianificare un allarme che rappresenta un allarme, che verrà usato per notificare all'utente quando si spegne.
[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 -> unitParametri
AlarmManager.AlarmClockInfo: questo valore non può essere Null.
- operation
- PendingIntent
PendingIntent: azione da eseguire quando l'allarme si spegne; in genere proviene da IntentSender.getBroadcast(). Questo valore non può essere Null.
- Attributi
Commenti
Pianificare un allarme che rappresenta un allarme, che verrà usato per notificare all'utente quando si spegne. L'aspettativa è che quando questo allarme si attiva, l'applicazione si sveglierà ulteriormente il dispositivo per indicare all'utente l'allarme - attivando sullo schermo, riproducendo un suono, vibrando e così via. Di conseguenza, il sistema userà in genere anche le informazioni fornite qui per informare l'utente di questo imminente allarme, se appropriato. A causa della natura di questo tipo di allarme, simile a setExactAndAllowWhileIdle(int, long, PendingIntent), questi allarmi saranno autorizzati a attivare anche se il sistema è in modalità a basso consumo (a.k.a. doze). Il sistema può anche eseguire alcune operazioni preliminari quando si vede che tale allarme in arrivo, per ridurre la quantità di lavoro in background che potrebbe verificarsi se questo fa sì che il dispositivo si riattiva completamente - questo è di evitare situazioni come un numero elevato di dispositivi che hanno un allarme impostato contemporaneamente al mattino, tutti svegliarsi in quel momento e improvvisamente paludere la rete con lavoro in background in sospeso. Di conseguenza, questi tipi di allarmi possono essere estremamente costosi per l'uso della batteria e devono essere usati solo per il loro scopo previsto.
Questo metodo è simile a setExact(int,long,PendingIntent), ma implica RTC_WAKEUP. Nota: a partire da Build.VERSION_CODES. S, le app destinate al livello SDK 31 o superiore devono richiedere l'autorizzazione SCHEDULE_EXACT_ALARM per usare questa API. L'utente e il sistema possono revocare questa autorizzazione tramite la schermata speciale di accesso all'app in Impostazioni. Nota: gli allarmi esatti devono essere usati solo per le funzionalità rivolte all'utente. Per altri dettagli, vedere Autorizzazione di allarme esatta. Gli allarmi pianificati tramite questa API potranno avviare un servizio in primo piano anche se l'app è in background. Richiede Manifest.permission.SCHEDULE_EXACT_ALARM
Vedere anche:
Informazioni di riferimento su Android per android.app.AlarmManager.setAlarmClock.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dalla e usati in base ai termini descritti in Creative License 2.5 Attribution License.