AlarmManager.SetWindow Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
SetWindow(AlarmType, Int64, Int64, PendingIntent) |
Programe una alarma para que se entregue dentro de un período de tiempo determinado. |
SetWindow(AlarmType, Int64, Int64, String, AlarmManager+IOnAlarmListener, Handler) |
Programe una alarma para que se entregue dentro de un período de tiempo determinado. |
SetWindow(AlarmType, Int64, Int64, String, IExecutor, AlarmManager+IOnAlarmListener) |
SetWindow(AlarmType, Int64, Int64, PendingIntent)
Programe una alarma para que se entregue dentro de un período de tiempo determinado.
[Android.Runtime.Register("setWindow", "(IJJLandroid/app/PendingIntent;)V", "GetSetWindow_IJJLandroid_app_PendingIntent_Handler")]
public virtual void SetWindow (Android.App.AlarmType type, long windowStartMillis, long windowLengthMillis, Android.App.PendingIntent operation);
[<Android.Runtime.Register("setWindow", "(IJJLandroid/app/PendingIntent;)V", "GetSetWindow_IJJLandroid_app_PendingIntent_Handler")>]
abstract member SetWindow : Android.App.AlarmType * int64 * int64 * Android.App.PendingIntent -> unit
override this.SetWindow : Android.App.AlarmType * int64 * int64 * Android.App.PendingIntent -> unit
Parámetros
- type
- AlarmType
tipo de alarma.
- windowStartMillis
- Int64
La primera vez, en milisegundos, que se debe entregar la alarma, expresada en las unidades del reloj adecuadas (dependiendo del tipo de alarma).
- windowLengthMillis
- Int64
Longitud de la ventana de entrega solicitada, en milisegundos. La alarma se entregará no más tarde de este número de milisegundos después windowStartMillis
de . Tenga en cuenta que este parámetro es una duración, no la marca de tiempo del final de la ventana.
- operation
- PendingIntent
Acción que se debe realizar cuando se apaga la alarma; normalmente procede de PendingIntent#getBroadcast
IntentSender.getBroadcast()
.
- Atributos
Comentarios
Programe una alarma para que se entregue dentro de un período de tiempo determinado. Este método es similar a #set(int, long, PendingIntent)
, pero permite a la aplicación controlar con precisión el grado en el que el sistema operativo podría ajustar su entrega. Este método permite a una aplicación aprovechar las optimizaciones de la batería que surgen del procesamiento por lotes de entrega incluso cuando tiene requisitos modestos de escalas de tiempo para sus alarmas.
Nota: A partir de la API Build.VERSION_CODES#S
, las aplicaciones no deben pasar una ventana de menos de 10 minutos. El sistema intentará adaptarse a ventanas más pequeñas si se supone que la alarma se activa en un futuro próximo, pero no hay ninguna garantía y la aplicación debe esperar que cualquier ventana menor de 10 minutos se desenlade a 10 minutos.
Este método también se puede usar para lograr garantías estrictas de ordenación entre varias alarmas asegurándose de que las ventanas solicitadas para cada alarma no se intersecan.
Cuando no se requiere la entrega precisa, las aplicaciones deben usar el método estándar #set(int, long, PendingIntent)
. Esto proporcionará al sistema operativo la mayor flexibilidad para minimizar las reactivaciones y el uso de la batería. En el caso de las alarmas que se deben entregar en momentos especificados con precisión sin ninguna variación aceptable, las aplicaciones pueden usar #setExact(int, long, PendingIntent)
.
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Consulte también
- <xref:Android.App.AlarmManager.Set(Android.App.AlarmType%2c+System.Int64%2c+System.Int64)>
- <xref:Android.App.AlarmManager.SetExact(Android.App.AlarmType%2c+System.Int64%2c+System.Int64)>
- <xref:Android.App.AlarmManager.SetRepeating(Android.App.AlarmType%2c+System.Int64%2c+System.Int64%2c+System.Int64)>
- Cancel(PendingIntent)
- SendBroadcast(Intent)
- <xref:Android.Content.Context.RegisterReceiver(Android.Content.BroadcastReceiver%2c+Android.Content.IntentFilter)>
- FilterEquals(Intent)
Se aplica a
SetWindow(AlarmType, Int64, Int64, String, AlarmManager+IOnAlarmListener, Handler)
Programe una alarma para que se entregue dentro de un período de tiempo determinado.
[Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSetWindow_IJJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)]
public virtual void SetWindow (Android.App.AlarmType type, long windowStartMillis, long windowLengthMillis, string? tag, Android.App.AlarmManager.IOnAlarmListener listener, Android.OS.Handler? targetHandler);
[<Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Landroid/app/AlarmManager$OnAlarmListener;Landroid/os/Handler;)V", "GetSetWindow_IJJLjava_lang_String_Landroid_app_AlarmManager_OnAlarmListener_Landroid_os_Handler_Handler", ApiSince=24)>]
abstract member SetWindow : Android.App.AlarmType * int64 * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit
override this.SetWindow : Android.App.AlarmType * int64 * int64 * string * Android.App.AlarmManager.IOnAlarmListener * Android.OS.Handler -> unit
Parámetros
- type
- AlarmType
tipo de alarma.
- windowStartMillis
- Int64
La primera vez, en milisegundos, que se debe entregar la alarma, expresada en las unidades del reloj adecuadas (dependiendo del tipo de alarma).
- windowLengthMillis
- Int64
Longitud de la ventana de entrega solicitada, en milisegundos. La alarma se entregará no más tarde de este número de milisegundos después windowStartMillis
de . Tenga en cuenta que este parámetro es una duración, no la marca de tiempo del final de la ventana.
- tag
- String
- listener
- AlarmManager.IOnAlarmListener
- targetHandler
- Handler
- Atributos
Comentarios
Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el proyecto de código abierto de Android y se usan según los términos descritos en la licencia de atribución de Creative Commons 2.5.
Se aplica a
SetWindow(AlarmType, Int64, Int64, String, IExecutor, AlarmManager+IOnAlarmListener)
[Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Ljava/util/concurrent/Executor;Landroid/app/AlarmManager$OnAlarmListener;)V", "GetSetWindow_IJJLjava_lang_String_Ljava_util_concurrent_Executor_Landroid_app_AlarmManager_OnAlarmListener_Handler", ApiSince=34)]
public virtual void SetWindow (Android.App.AlarmType type, long windowStartMillis, long windowLengthMillis, string? tag, Java.Util.Concurrent.IExecutor executor, Android.App.AlarmManager.IOnAlarmListener listener);
[<Android.Runtime.Register("setWindow", "(IJJLjava/lang/String;Ljava/util/concurrent/Executor;Landroid/app/AlarmManager$OnAlarmListener;)V", "GetSetWindow_IJJLjava_lang_String_Ljava_util_concurrent_Executor_Landroid_app_AlarmManager_OnAlarmListener_Handler", ApiSince=34)>]
abstract member SetWindow : Android.App.AlarmType * int64 * int64 * string * Java.Util.Concurrent.IExecutor * Android.App.AlarmManager.IOnAlarmListener -> unit
override this.SetWindow : Android.App.AlarmType * int64 * int64 * string * Java.Util.Concurrent.IExecutor * Android.App.AlarmManager.IOnAlarmListener -> unit
Parámetros
- type
- AlarmType
- windowStartMillis
- Int64
- windowLengthMillis
- Int64
- tag
- String
- executor
- IExecutor
- listener
- AlarmManager.IOnAlarmListener
- Atributos