Idioma

AlarmManager.SetAndAllowWhileIdle(AlarmType, Int64, PendingIntent) Método

Definição

Como #set(int, long, PendingIntent), mas esse alarme poderá ser executado mesmo quando o sistema estiver em ociosidade de baixa potência (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

Parâmetros

type
AlarmType

tipo de alarme.

triggerAtMillis
Int64

tempo em milissegundos em que o alarme deve disparar, usando o relógio apropriado (dependendo do tipo de alarme).

operation
PendingIntent

Ação a ser executada quando o alarme disparar; normalmente vem de PendingIntent#getBroadcast IntentSender.getBroadcast().

Atributos

Comentários

Como set(int,long, PendingIntent), mas esse alarme será permitido para ser executado mesmo quando o sistema estiver em modos ociosos de baixa potência (também conhecidos como doze). Esse tipo de alarme só deve ser usado para situações em que, na verdade, é necessário que o alarme desative enquanto estiver ocioso . Um exemplo razoável seria para uma notificação de calendário que deve fazer um som para que o usuário esteja ciente dele. Quando o alarme for enviado, o aplicativo também será adicionado à lista temporária de isenção de energia do sistema por aproximadamente 10 segundos para permitir que esse aplicativo adquira novos bloqueios de ativação para concluir seu trabalho.

Esses alarmes podem afetar significativamente o uso de energia do dispositivo quando ociosos (e, portanto, causar uma culpa significativa da bateria para o aplicativo que os agenda), portanto, eles devem ser usados com cuidado. Para reduzir o abuso, há restrições sobre a frequência com que esses alarmes dispararão para um determinado aplicativo. Em operação normal do sistema, ele não enviará esses alarmes mais do que a cada minuto (momento em que cada alarme pendente é expedido); quando em modos ociosos de baixa potência essa duração pode ser significativamente maior, como 15 minutos.

Ao contrário de outros alarmes, o sistema é livre para reagendar esse tipo de alarme para acontecer fora de ordem com quaisquer outros alarmes, mesmo aqueles do mesmo aplicativo. Isso ocorrerá claramente quando o dispositivo estiver ocioso (já que esse alarme pode disparar enquanto estiver ocioso, quando quaisquer outros alarmes do aplicativo serão mantidos até mais tarde), mas também podem ocorrer mesmo quando não estiverem ociosos.

Independentemente da versão do SDK de destino do aplicativo, essa chamada sempre permite o envio em lote do alarme.

Consulte também:

Referência do Android para android.app.AlarmManager.setAndAllowWhileIdle.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.

Aplica-se a