AlarmManager.SetWindow Metodo
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
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)
.
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
- listener
- AlarmManager.IOnAlarmListener
- targetHandler
- Handler
- Attributi
Commenti
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
- listener
- AlarmManager.IOnAlarmListener
- Attributi