AlarmManager.SetAndAllowWhileIdle(AlarmType, Int64, PendingIntent) Метод
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Как и #set(int, long, PendingIntent), но эта сигнализация будет разрешена выполнять даже в том случае, если система находится в состоянии простоя с низкой мощностью (a).
[Android.Runtime.Register("setAndAllowWhileIdle", "(IJLandroid/app/PendingIntent;)V", "GetSetAndAllowWhileIdle_IJLandroid_app_PendingIntent_Handler", ApiSince=23)]
public virtual void SetAndAllowWhileIdle (Android.App.AlarmType type, long triggerAtMillis, Android.App.PendingIntent operation);[<Android.Runtime.Register("setAndAllowWhileIdle", "(IJLandroid/app/PendingIntent;)V", "GetSetAndAllowWhileIdle_IJLandroid_app_PendingIntent_Handler", ApiSince=23)>]
abstract member SetAndAllowWhileIdle : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unit
override this.SetAndAllowWhileIdle : Android.App.AlarmType * int64 * Android.App.PendingIntent -> unitПараметры
- type
- AlarmType
тип сигнализации.
- triggerAtMillis
- Int64
время в миллисекундах, которое должно выходить, используя соответствующие часы (в зависимости от типа сигнализации).
- operation
- PendingIntent
Действие для выполнения при отключении сигнализации; обычно происходит из PendingIntent#getBroadcast
IntentSender.getBroadcast().
- Атрибуты
Комментарии
Как #set(int, long, PendingIntent)и , но эта сигнализация будет разрешена выполнять даже в том случае, если система находится в режимах простоя с низкой мощностью (a.k.a. doze). Этот тип сигнализации должен <использоваться только< b>/b> для ситуаций, когда на самом деле требуется, чтобы тревога отключается во время простоя - разумный пример будет для уведомления календаря, который должен сделать звук, чтобы пользователь знал об этом. При отправке сигнализации приложение также будет добавлено в список временных исключений питания системы в течение примерно 10 секунд, чтобы позволить этому приложению получить дополнительные блокировки пробуждения, в которых завершить работу.</p>
Эти сигнализации могут значительно повлиять на использование питания устройства при простое (и, следовательно, привести к значительной вине батареи в планировании приложения), поэтому они должны использоваться с осторожностью. Чтобы уменьшить злоупотребление, существуют ограничения на частоту этих предупреждений для конкретного приложения. В обычной системной операции эти оповещения не будут отправляться больше, чем каждые минуты (в какой момент отправляется каждое ожидающее оповещение); если в режимах простоя с низкой мощностью эта длительность может быть значительно длиннее, например 15 минут.
В отличие от других оповещений, система может перепланировать этот тип тревоги, чтобы произойти вне порядка с любыми другими оповещениями, даже теми из того же приложения. Это явно произойдет, когда устройство неактивно (так как эта сигнализация может выходить во время простоя, когда любые другие оповещения из приложения будут храниться до конца), но также могут произойти, даже если не простой.
Независимо от целевой версии пакета SDK для приложения, этот вызов всегда разрешает пакетную обработку сигнализации.
Части этой страницы — это изменения на основе работы, созданной и общей проектом с открытым исходным кодом Android и используемой в соответствии с условиями, описанными в лицензии Creative Commons 2.5 Attribution.