AlarmManager.SetAlarmClock(AlarmManager+AlarmClockInfo, PendingIntent) Método

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

Parâmetros

Atributos

RegisterAttribute RequiresPermissionAttribute

Comentários

Agende um alarme que representa um alarme, que será usado para notificar o usuário quando ele desligar. A expectativa é que, quando esse alarme for disparado, o aplicativo ative ainda mais o dispositivo para informar ao usuário sobre o alarme , ativando a tela, reproduzindo um som, vibrando etc. Como tal, o sistema normalmente também usará as informações fornecidas aqui para informar ao usuário sobre esse alarme futura, se apropriado. Devido à natureza desse tipo de alarme, semelhante a setExactAndAllowWhileIdle(int, long, PendingIntent), esses alarmes poderão ser disparados mesmo se o sistema estiver em um modo ocioso de baixa potência (também conhecido como doze). O sistema também pode fazer algum trabalho de preparação quando vê que tal alarme está chegando, para reduzir a quantidade de trabalho em segundo plano que poderia acontecer se isso faz com que o dispositivo acorde completamente - isso é para evitar situações como um grande número de dispositivos com um alarme definido ao mesmo tempo da manhã, todos acordando naquele momento e, de repente, inundando a rede com trabalho de fundo pendente. Como tal, esses tipos de alarmes podem ser extremamente caros no uso da bateria e só devem ser usados para sua finalidade pretendida.

Esse método é como setExact(int, long,PendingIntent), mas implica RTC_WAKEUP. Observação: começando com Build.VERSION_CODES. S, os aplicativos direcionados ao SDK nível 31 ou superior precisam solicitar a permissão SCHEDULE_EXACT_ALARM para usar essa API. O usuário e o sistema podem revogar essa permissão por meio da tela de acesso especial do aplicativo em Configurações. Observação: os alarmes exatos só devem ser usados para recursos voltados para o usuário. Para obter mais detalhes, consulte a permissão de alarme exata. Os alarmes agendados por meio dessa API poderão iniciar um serviço em primeiro plano mesmo se o aplicativo estiver em segundo plano. Requer Manifest.permission.SCHEDULE_EXACT_ALARM

Consulte também:

Referência do Android para android.app.AlarmManager.setAlarmClock.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.