AlarmManager.SetInexactRepeating Método

Definición

Espacio de nombres:: Android.App

Ensamblado:: Mono.Android.dll

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

[Android.Runtime.Register("setInexactRepeating", "(IJJLandroid/app/PendingIntent;)V", "GetSetInexactRepeating_IJJLandroid_app_PendingIntent_Handler")]
public virtual void SetInexactRepeating(Android.App.AlarmType type, long triggerAtMillis, long intervalMillis, Android.App.PendingIntent operation);

[<Android.Runtime.Register("setInexactRepeating", "(IJJLandroid/app/PendingIntent;)V", "GetSetInexactRepeating_IJJLandroid_app_PendingIntent_Handler")>]
abstract member SetInexactRepeating : Android.App.AlarmType * int64 * int64 * Android.App.PendingIntent -> unit
override this.SetInexactRepeating : Android.App.AlarmType * int64 * int64 * Android.App.PendingIntent -> unit

Parámetros

type: AlarmType

tipo de alarma.

triggerAtMillis: Int64

tiempo en milisegundos que la alarma debe apagarse, utilizando el reloj adecuado (dependiendo del tipo de alarma). Esto es inexacto: la alarma no se activará antes de esta vez, pero puede haber un retraso de casi un intervalo de alarma completo antes de la primera invocación de la alarma.

intervalMillis: Int64

intervalo en milisegundos entre repeticiones posteriores de la alarma. Antes de la API 19, si se trata de una de INTERVAL_FIFTEEN_MINUTES, INTERVAL_HALF_HOUR, INTERVAL_HOUR, INTERVAL_HALF_DAY o INTERVAL_DAY, la alarma estará alineada por fases con otras alarmas para reducir el número de reactivaciones. De lo contrario, la alarma se establecerá como si la aplicación hubiera llamado #setRepeatinga . A partir de la API 19, todas las alarmas repetidas serán inexactas y estarán sujetas a procesamiento por lotes con otras alarmas, independientemente de su intervalo de repetición indicado.

operation: PendingIntent

Acción que se debe realizar cuando se apaga la alarma; normalmente procede de PendingIntent#getBroadcast IntentSender.getBroadcast().

Atributos: RegisterAttribute

Comentarios

Programar una alarma de repetición que tenga requisitos de tiempo de desencadenador inexactos; por ejemplo, una alarma que se repite cada hora, pero no necesariamente en la parte superior de cada hora. Estas alarmas son más eficientes de energía que las estrictas periodicidades proporcionadas tradicionalmente por setRepeating(int, long, long, PendingIntent), ya que el sistema puede ajustar los tiempos de entrega de las alarmas para provocar que se activen simultáneamente, evitando despertar el dispositivo de suspensión más de lo necesario. El primer desencadenador de la alarma no estará antes de la hora solicitada, pero es posible que no se produzca durante casi un intervalo completo después de ese tiempo. Además, mientras que el período general de la alarma de repetición será según lo solicitado, el tiempo entre dos disparos sucesivos de la alarma puede variar. Si la aplicación requiere una vibración muy baja, use alarmas de un solo disparo con una ventana adecuada en su lugar; vea setWindow(int,long,long,PendingIntent) y setExact(int,long,PendingIntent). A partir de la API 19, todas las alarmas repetidas son inexactas. Dado que este método ha estado disponible desde la API 3, la aplicación puede llamarla de forma segura y estar seguro de que obtendrá un comportamiento similar en las versiones actuales y anteriores de Android. Aplicaciones destinadas a Build.VERSION_CODES. S tendrá que establecer la marca PendingIntent.FLAG_MUTABLE en el PendingIntent que se usa para establecer esta alarma, si quieren que el recuento de alarmas se proporcione con la clave Intent.EXTRA_ALARM_COUNT.

Consulte también:

Referencia de Android para android.app.AlarmManager.setInexactRepeating.

Las partes de esta página son modificaciones basadas en el trabajo creado y compartido por el Android y se usan según los términos descritos en creative Creative Commons 2.5 Attribution License.

Se aplica a