Condividi tramite


AlarmManager.SetWindow Metodo

Definizione

Overload

SetWindow(AlarmType, Int64, Int64, PendingIntent)

Pianificare un allarme da recapitare entro un determinato intervallo di tempo.

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

Pianificare un allarme da recapitare entro un determinato intervallo di tempo.

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

SetWindow(AlarmType, Int64, Int64, PendingIntent)

Pianificare un allarme da recapitare entro un determinato intervallo di 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

Parametri

type
AlarmType

tipo di allarme.

windowStartMillis
Int64

La prima volta, in millisecondi, che l'allarme deve essere recapitato, espresso nelle unità di orologio appropriate (a seconda del tipo di allarme).

windowLengthMillis
Int64

Lunghezza della finestra di recapito richiesta, espressa in millisecondi. L'allarme verrà recapitato non più tardi di questo numero di millisecondi dopo windowStartMillis. Si noti che questo parametro è una durata, non il timestamp della fine della finestra.

operation
PendingIntent

Azione da eseguire quando l'allarme si spegne; in genere proviene da PendingIntent#getBroadcast IntentSender.getBroadcast().

Attributi

Commenti

Pianificare un allarme da recapitare entro un determinato intervallo di tempo. Questo metodo è simile a #set(int, long, PendingIntent), ma consente all'applicazione di controllare con precisione il grado di recapito che potrebbe essere regolato dal sistema operativo. Questo metodo consente a un'applicazione di sfruttare le ottimizzazioni della batteria che derivano dall'invio in batch anche quando ha requisiti modesti di tempo per i suoi allarmi.

Nota: a partire dall'API Build.VERSION_CODES#S, le app non devono passare in una finestra inferiore a 10 minuti. Il sistema proverà il meglio per ospitare finestre più piccole se l'allarme dovrebbe essere attivato nel prossimo futuro, ma non ci sono garanzie e l'app dovrebbe aspettarsi qualsiasi finestra inferiore a 10 minuti per ottenere allungato a 10 minuti.

Questo metodo può essere usato anche per ottenere garanzie di ordinamento rigorose tra più allarmi assicurando che le finestre richieste per ogni allarme non si intersecano.

Quando non è necessario un recapito preciso, le applicazioni devono usare il metodo standard #set(int, long, PendingIntent) . In questo modo il sistema operativo offrirà la massima flessibilità per ridurre al minimo gli riattivazioni e l'uso della batteria. Per gli allarmi che devono essere recapitati in orari specificati con precisione senza variazioni accettabili, le applicazioni possono usare #setExact(int, long, PendingIntent).

Documentazione java per android.app.AlarmManager.setWindow(int, long, long, android.app.PendingIntent).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Vedi anche

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

Si applica a

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

Pianificare un allarme da recapitare entro un determinato intervallo di 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

Parametri

type
AlarmType

tipo di allarme.

windowStartMillis
Int64

La prima volta, in millisecondi, che l'allarme deve essere recapitato, espresso nelle unità di orologio appropriate (a seconda del tipo di allarme).

windowLengthMillis
Int64

Lunghezza della finestra di recapito richiesta, espressa in millisecondi. L'allarme verrà recapitato non più tardi di questo numero di millisecondi dopo windowStartMillis. Si noti che questo parametro è una durata, non il timestamp della fine della finestra.

tag
String
targetHandler
Handler
Attributi

Commenti

Documentazione java per android.app.AlarmManager.setWindow(int, long, long, android.app.PendingIntent).

Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.

Si applica 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

Parametri

type
AlarmType
windowStartMillis
Int64
windowLengthMillis
Int64
tag
String
executor
IExecutor
Attributi

Si applica a