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)
.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом 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
- listener
- AlarmManager.IOnAlarmListener
- targetHandler
- Handler
- Атрибуты
Комментарии
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом 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
- listener
- AlarmManager.IOnAlarmListener
- Атрибуты