Lenguaje

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

Definición

Espacio de nombres:
Android.App
Ensamblado:
Mono.Android.dll

Programe una alarma que represente un reloj de alarma, que se usará para notificar al usuario cuando se apague.

[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

info
AlarmManager.AlarmClockInfo

AlarmManager.AlarmClockInfo: este valor no puede ser NULL.

operation
PendingIntent

PendingIntent: Acción que se debe realizar cuando se apaga la alarma; normalmente procede de IntentSender.getBroadcast(). Este valor no puede ser nulo.

Atributos
RegisterAttribute RequiresPermissionAttribute

Comentarios

Programe una alarma que represente un reloj de alarma, que se usará para notificar al usuario cuando se apague. La expectativa es que, cuando esta alarma se desencadene, la aplicación reactivará aún más el dispositivo para informar al usuario sobre la alarma, activar la pantalla, reproducir un sonido, vibrar, etc. Por lo tanto, el sistema también usará la información proporcionada aquí para informar al usuario sobre esta próxima alarma si procede. Debido a la naturaleza de este tipo de alarma, similar a setExactAndAllowWhileIdle(int, long, PendingIntent), estas alarmas se podrán desencadenar incluso si el sistema está en modo inactivo de bajo consumo (a.k.a. doze). El sistema también puede hacer algún trabajo de preparación cuando ve que esta alarma aparece, para reducir la cantidad de trabajo en segundo plano que podría ocurrir si esto hace que el dispositivo se despierte completamente, esto es evitar situaciones como un gran número de dispositivos que tienen una alarma establecida al mismo tiempo en la mañana, todo despertando en ese momento y repentinamente inundando la red con trabajo en segundo plano pendiente. Por lo tanto, estos tipos de alarmas pueden ser extremadamente costosos en el uso de la batería y solo deben usarse para su propósito previsto.

Este método es como setExact(int,long,PendingIntent), pero implica RTC_WAKEUP. Nota: A partir de Build.VERSION_CODES. S, las aplicaciones destinadas al nivel 31 del SDK o superior deben solicitar el permiso SCHEDULE_EXACT_ALARM para usar esta API. El usuario y el sistema pueden revocar este permiso a través de la pantalla especial de acceso a la aplicación en Configuración. Nota: Las alarmas exactas solo deben usarse para las características orientadas al usuario. Para obtener más información, consulte Permiso de alarma exacta. Las alarmas programadas a través de esta API podrán iniciar un servicio en primer plano incluso si la aplicación está en segundo plano. Requiere Manifest.permission.SCHEDULE_EXACT_ALARM

Consulte también:

Referencia de Android para android.app.AlarmManager.setAlarmClock.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a