AlarmManager.SetWindow Método

Definição

Namespace:

Android.App

Assembly:

Mono.Android.dll

Sobrecargas

SetWindow(AlarmType, Int64, Int64, PendingIntent)	Agende um alarme para ser entregue dentro de uma determinada janela de tempo.
SetWindow(AlarmType, Int64, Int64, String, AlarmManager+IOnAlarmListener, Handler)	Agende um alarme para ser entregue dentro de uma determinada janela de tempo.
SetWindow(AlarmType, Int64, Int64, String, IExecutor, AlarmManager+IOnAlarmListener)

SetWindow(AlarmType, Int64, Int64, PendingIntent)

Agende um alarme para ser entregue dentro de uma determinada janela de tempo.

[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 alarme.

windowStartMillis

Int64

O primeiro tempo, em milissegundos, que o alarme deve ser emitido, expresso nas unidades de relógio apropriadas (dependendo do tipo de alarme).

windowLengthMillis

Int64

O comprimento da janela de entrega solicitada, em milissegundos. O alarme será entregue o mais tardar muitos milissegundos após windowStartMillis. Observe que esse parâmetro é uma duração, não o carimbo de data/hora do final da janela.

operation

PendingIntent

Ação a realizar quando o alarme disparar; normalmente vem de PendingIntent#getBroadcast IntentSender.getBroadcast().

Atributos

RegisterAttribute

Comentários

Agende um alarme para ser entregue dentro de uma determinada janela de tempo. Esse método é semelhante ao #set(int, long, PendingIntent), mas permite que o aplicativo controle precisamente o grau em que sua entrega pode ser ajustada pelo sistema operacional. Esse método permite que um aplicativo aproveite as otimizações de bateria que surgem do lote de entrega, mesmo quando tem requisitos de pontualidade modestos para seus alarmes.

Observação: a partir da API Build.VERSION_CODES#S, os aplicativos não devem passar em uma janela de menos de 10 minutos. O sistema tentará ao máximo acomodar janelas menores se o alarme for acionado em um futuro próximo, mas não há garantias e o aplicativo deve esperar que qualquer janela menor que 10 minutos seja alongada para 10 minutos.

Este método também pode ser usado para obter garantias de ordenação rigorosas entre vários alarmes, garantindo que as janelas solicitadas para cada alarme não se cruzem.

Quando a entrega precisa não é necessária, os aplicativos devem usar o método padrão #set(int, long, PendingIntent) . Isso dará ao sistema operacional a maior flexibilidade para minimizar o despertar e o uso da bateria. Para alarmes que devem ser entregues em horários especificados com precisão e sem variação aceitável, as aplicações podem usar #setExact(int, long, PendingIntent)o .

Documentação Java para android.app.AlarmManager.setWindow(int, long, long, android.app.PendingIntent).

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

Confira também

• <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)

SetWindow(AlarmType, Int64, Int64, String, AlarmManager+IOnAlarmListener, Handler)

Agende um alarme para ser entregue dentro de uma determinada janela de tempo.

[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 alarme.

windowStartMillis

Int64

O primeiro tempo, em milissegundos, que o alarme deve ser emitido, expresso nas unidades de relógio apropriadas (dependendo do tipo de alarme).

windowLengthMillis

Int64

O comprimento da janela de entrega solicitada, em milissegundos. O alarme será entregue o mais tardar muitos milissegundos após windowStartMillis. Observe que esse parâmetro é uma duração, não o carimbo de data/hora do final da janela.

tag

String

listener

AlarmManager.IOnAlarmListener

targetHandler

Handler

Atributos

RegisterAttribute

Comentários

Documentação Java para android.app.AlarmManager.setWindow(int, long, long, android.app.PendingIntent).

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

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

RegisterAttribute