SystemClock Clase

Definición

[Android.Runtime.Register("android/os/SystemClock", DoNotGenerateAcw=true)]
public sealed class SystemClock : Java.Lang.Object

[<Android.Runtime.Register("android/os/SystemClock", DoNotGenerateAcw=true)>]
type SystemClock = class
    inherit Object

Herencia

Object

JavaObject

Object

SystemClock

Atributos

RegisterAttribute

Comentarios

Instalaciones básicas de mantenimiento de tiempo.

Hay tres relojes diferentes disponibles y no deben confundirse:

<ul><li>

System#currentTimeMillis System.currentTimeMillis() es el reloj estándar de "pared" (hora y fecha) que expresa milisegundos desde la época. El reloj de pared se puede establecer por el usuario o la red telefónica (vea #setCurrentTimeMillis), por lo que el tiempo puede saltar hacia atrás o hacia delante de forma impredecible. Este reloj solo debe usarse cuando la correspondencia con fechas y horas del mundo real es importante, como en una aplicación de calendario o reloj de alarma. Las medidas de tiempo transcurrido o intervalo deben usar un reloj diferente. Si usa System.currentTimeMillis(), considere la posibilidad de escuchar las android.content.Intent#ACTION_TIME_TICK ACTION_TIME_TICKdifusión y android.content.Intent#ACTION_TIME_CHANGED ACTION_TIME_CHANGEDandroid.content.Intent#ACTION_TIMEZONE_CHANGED ACTION_TIMEZONE_CHANGEDandroid.content.Intent Intent para averiguar cuándo cambia la hora.

<li>

#uptimeMillis se cuenta en milisegundos desde el arranque del sistema. Este reloj se detiene cuando el sistema entra en suspensión profunda (CPU desactivada, pantalla oscura, dispositivo esperando entrada externa), pero no se ve afectado por el escalado del reloj, inactivo u otros mecanismos de ahorro de energía. Esta es la base para la mayoría de los intervalos, como Thread#sleep(long) Thread.sleep(millis), Object#wait(long) Object.wait(millis)y System#nanoTime System.nanoTime(). Se garantiza que este reloj es monotonico y es adecuado para el intervalo de tiempo cuando el intervalo no abarca la suspensión del dispositivo. La mayoría de los métodos que aceptan un valor de marca de tiempo esperan actualmente el #uptimeMillis reloj.

<li>

#elapsedRealtime y #elapsedRealtimeNanos devuelven el tiempo desde el arranque del sistema e incluyen suspensión profunda. Se garantiza que este reloj es monotonico y sigue marcando incluso cuando la CPU está en modos de ahorro de energía, por lo que es la base recomendada para el intervalo de uso general.

</ul>

Hay varios mecanismos para controlar el tiempo de los eventos:

<ul><li>

Las funciones estándar como Thread#sleep(long) Thread.sleep(millis) y Object#wait(long) Object.wait(millis) siempre están disponibles. Estas funciones usan el #uptimeMillis reloj; si el dispositivo entra en suspensión, el resto del tiempo se pospondrá hasta que el dispositivo se despierte. Estas funciones sincrónicas pueden interrumpirse con Thread#interrupt Thread.interrupt()y debe controlar InterruptedException.

<li>

#sleep SystemClock.sleep(millis) es una función de utilidad muy similar a Thread#sleep(long) Thread.sleep(millis), pero omite InterruptedException. Use esta función para retrasos si no usa Thread#interrupt Thread.interrupt(), ya que conservará el estado interrumpido del subproceso.

<li>

La android.os.Handler clase puede programar devoluciones de llamada asincrónicas en un tiempo absoluto o relativo. Los objetos de controlador también usan el #uptimeMillis reloj y requieren un android.os.Looper event loop (normalmente presente en cualquier aplicación de GUI).

<li>

android.app.AlarmManager Puede desencadenar eventos de una sola vez o periódicos que se producen incluso cuando el dispositivo está en suspensión profunda o la aplicación no se está ejecutando. Los eventos se pueden programar con su elección de java.lang.System#currentTimeMillis (RTC) o #elapsedRealtime (ELAPSED_REALTIME) y provocar una android.content.Intent difusión cuando se producen. </ul>

Java documentación para android.os.SystemClock.

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.