Поделиться через


AlarmManager.SetWindow Метод

Определение

Перегрузки

SetWindow(AlarmType, Int64, Int64, PendingIntent)

Запланируйте доставку сигнализации в течение заданного периода времени.

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

Запланируйте доставку сигнализации в течение заданного периода времени.

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

SetWindow(AlarmType, Int64, Int64, PendingIntent)

Запланируйте доставку сигнализации в течение заданного периода времени.

[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

Параметры

type
AlarmType

тип сигнализации.

windowStartMillis
Int64

Самое раннее время в миллисекундах, которое должно быть доставлено сигналом, выраженным в соответствующих единицах часов (в зависимости от типа сигнализации).

windowLengthMillis
Int64

Длина запрошенного окна доставки в миллисекундах. Сигнализация будет доставлена не позже, чем после этого многих миллисекундах windowStartMillis. Обратите внимание, что этот параметр является длительностью , а не меткой времени конца окна.

operation
PendingIntent

Действие для выполнения при отключении сигнализации; обычно происходит из PendingIntent#getBroadcast IntentSender.getBroadcast().

Атрибуты

Комментарии

Запланируйте доставку сигнализации в течение заданного периода времени. Этот метод аналогичен #set(int, long, PendingIntent), но позволяет приложению точно контролировать степень, в которой ее доставка может быть скорректирована ОС. Этот метод позволяет приложению воспользоваться преимуществами оптимизации батареи, возникающих при пакетной обработке доставки, даже если она имеет скромные требования к времени для своих предупреждений.

Примечание. Начиная с API Build.VERSION_CODES#Sприложения не должны проходить в окне менее 10 минут. Система попытается лучше всего разместить небольшие окна, если сигнализация должна срабочить в ближайшем будущем, но нет гарантий, и приложение должно ожидать, что любое окно меньше 10 минут, чтобы получить вытянутое до 10 минут.

Этот метод также можно использовать для обеспечения строгого порядка между несколькими оповещениями, гарантируя, что окна, запрошенные для каждой сигнализации, не пересекаются.

Если точную доставку не требуется, приложения должны использовать стандартный #set(int, long, PendingIntent) метод. Это позволит ОС максимально гибко свести к минимуму пробуждения и использования батареи. Для предупреждений, которые должны быть доставлены в точно указанное время без допустимых вариантов, приложения могут использовать #setExact(int, long, PendingIntent).

Документация по Java для android.app.AlarmManager.setWindow(int, long, long, android.app.PendingIntent).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

См. также раздел

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

Запланируйте доставку сигнализации в течение заданного периода времени.

[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

Параметры

type
AlarmType

тип сигнализации.

windowStartMillis
Int64

Самое раннее время в миллисекундах, которое должно быть доставлено сигналом, выраженным в соответствующих единицах часов (в зависимости от типа сигнализации).

windowLengthMillis
Int64

Длина запрошенного окна доставки в миллисекундах. Сигнализация будет доставлена не позже, чем после этого многих миллисекундах windowStartMillis. Обратите внимание, что этот параметр является длительностью , а не меткой времени конца окна.

tag
String
targetHandler
Handler
Атрибуты

Комментарии

Документация по Java для android.app.AlarmManager.setWindow(int, long, long, android.app.PendingIntent).

Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.

Применяется к

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

Параметры

type
AlarmType
windowStartMillis
Int64
windowLengthMillis
Int64
tag
String
executor
IExecutor
Атрибуты

Применяется к