Compartir a través de


AlarmManager.SetWindow Método

Definición

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 windowStartMillisde . 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).

Documentación de Java para android.app.AlarmManager.setWindow(int, long, long, android.app.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 windowStartMillisde . Tenga en cuenta que este parámetro es una duración, no la marca de tiempo del final de la ventana.

tag
String
targetHandler
Handler
Atributos

Comentarios

Documentación de Java para android.app.AlarmManager.setWindow(int, long, long, android.app.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.

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
Atributos

Se aplica a