IT. Expert System.

public class AlarmManager
extends Object

• Field Summary

  Fields

  Modifier and Type	Field and Description
  static int	ELAPSED_REALTIME Alarm time in SystemClock.elapsedRealtime() (time since boot, including sleep).
  static int	ELAPSED_REALTIME_WAKEUP Alarm time in SystemClock.elapsedRealtime() (time since boot, including sleep), which will wake up the device when it goes off.
  static long	INTERVAL_DAY
  static long	INTERVAL_FIFTEEN_MINUTES Available inexact recurrence intervals recognized by setInexactRepeating(int, long, long, PendingIntent)
  static long	INTERVAL_HALF_DAY
  static long	INTERVAL_HALF_HOUR
  static long	INTERVAL_HOUR
  static int	RTC Alarm time in System.currentTimeMillis() (wall clock time in UTC).
  static int	RTC_WAKEUP Alarm time in System.currentTimeMillis() (wall clock time in UTC), which will wake up the device when it goes off.

• Method Summary

  Methods

  Modifier and Type	Method and Description
  void	cancel(PendingIntent operation) Remove any alarms with a matching Intent.
  void	set(int type, long triggerAtMillis, PendingIntent operation) Schedule an alarm.
  void	setInexactRepeating(int type, long triggerAtMillis, long intervalMillis, PendingIntent operation) Schedule a repeating alarm that has inexact trigger time requirements; for example, an alarm that repeats every hour, but not necessarily at the top of every hour.
  void	setRepeating(int type, long triggerAtMillis, long intervalMillis, PendingIntent operation) Schedule a repeating alarm.
  void	setTime(long millis) Set the system wall clock time.
  void	setTimeZone(String timeZone) Set the system default time zone.

  • Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

• Field Detail

  • RTC_WAKEUP

    public static final int RTC_WAKEUP

    Alarm time in System.currentTimeMillis() (wall clock time in UTC), which will wake up the device when it goes off.

    See Also:

    Constant Field Values

  • RTC

    public static final int RTC

    Alarm time in System.currentTimeMillis() (wall clock time in UTC). This alarm does not wake the device up; if it goes off while the device is asleep, it will not be delivered until the next time the device wakes up.

    See Also:

    Constant Field Values

  • ELAPSED_REALTIME_WAKEUP

    public static final int ELAPSED_REALTIME_WAKEUP

    Alarm time in SystemClock.elapsedRealtime() (time since boot, including sleep), which will wake up the device when it goes off.

    See Also:

    Constant Field Values

  • ELAPSED_REALTIME

    public static final int ELAPSED_REALTIME

    Alarm time in SystemClock.elapsedRealtime() (time since boot, including sleep). This alarm does not wake the device up; if it goes off while the device is asleep, it will not be delivered until the next time the device wakes up.

    See Also:

    Constant Field Values

  • INTERVAL_FIFTEEN_MINUTES

    public static final long INTERVAL_FIFTEEN_MINUTES

    Available inexact recurrence intervals recognized by setInexactRepeating(int, long, long, PendingIntent)

    See Also:

    Constant Field Values

  • INTERVAL_HALF_HOUR

    public static final long INTERVAL_HALF_HOUR

    See Also:

    Constant Field Values

  • INTERVAL_HOUR

    public static final long INTERVAL_HOUR

    See Also:

    Constant Field Values

  • INTERVAL_HALF_DAY

    public static final long INTERVAL_HALF_DAY

    See Also:

    Constant Field Values

  • INTERVAL_DAY

    public static final long INTERVAL_DAY

    See Also:

    Constant Field Values

• Method Detail

  • set

    public void set(int type,
           long triggerAtMillis,
           PendingIntent operation)

    Schedule an alarm. Note: for timing operations (ticks, timeouts, etc) it is easier and much more efficient to use Handler. If there is already an alarm scheduled for the same IntentSender, it will first be canceled.

    If the time occurs in the past, the alarm will be triggered immediately. If there is already an alarm for this Intent scheduled (with the equality of two intents being defined by Intent.filterEquals(android.content.Intent)), then it will be removed and replaced by this one.

    The alarm is an intent broadcast that goes to a broadcast receiver that you registered with Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter) or through the <receiver> tag in an AndroidManifest.xml file.

    Alarm intents are delivered with a data extra of type int called Intent.EXTRA_ALARM_COUNT that indicates how many past alarm events have been accumulated into this intent broadcast. Recurring alarms that have gone undelivered because the phone was asleep may have a count greater than one when delivered.

    Parameters:

    type - One of ELAPSED_REALTIME, ELAPSED_REALTIME_WAKEUP, RTC or RTC_WAKEUP.

    triggerAtMillis - time in milliseconds that the alarm should go off, using the appropriate clock (depending on the alarm type).

    operation - Action to perform when the alarm goes off; typically comes from IntentSender.getBroadcast().

    See Also:

    Handler, setRepeating(int, long, long, android.app.PendingIntent), cancel(android.app.PendingIntent), Context.sendBroadcast(android.content.Intent), Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter), Intent.filterEquals(android.content.Intent), ELAPSED_REALTIME, ELAPSED_REALTIME_WAKEUP, RTC, RTC_WAKEUP

  • setRepeating

    public void setRepeating(int type,
                    long triggerAtMillis,
                    long intervalMillis,
                    PendingIntent operation)

    Schedule a repeating alarm. Note: for timing operations (ticks, timeouts, etc) it is easier and much more efficient to use Handler. If there is already an alarm scheduled for the same IntentSender, it will first be canceled.

    Like set(int, long, android.app.PendingIntent), except you can also supply a rate at which the alarm will repeat. This alarm continues repeating until explicitly removed with cancel(android.app.PendingIntent). If the time occurs in the past, the alarm will be triggered immediately, with an alarm count depending on how far in the past the trigger time is relative to the repeat interval.

    If an alarm is delayed (by system sleep, for example, for non _WAKEUP alarm types), a skipped repeat will be delivered as soon as possible. After that, future alarms will be delivered according to the original schedule; they do not drift over time. For example, if you have set a recurring alarm for the top of every hour but the phone was asleep from 7:45 until 8:45, an alarm will be sent as soon as the phone awakens, then the next alarm will be sent at 9:00.

    If your application wants to allow the delivery times to drift in order to guarantee that at least a certain time interval always elapses between alarms, then the approach to take is to use one-time alarms, scheduling the next one yourself when handling each alarm delivery.

    Parameters:

    type - One of ELAPSED_REALTIME, ELAPSED_REALTIME_WAKEUP}, RTC or RTC_WAKEUP.

    triggerAtMillis - time in milliseconds that the alarm should first go off, using the appropriate clock (depending on the alarm type).

    intervalMillis - interval in milliseconds between subsequent repeats of the alarm.

    operation - Action to perform when the alarm goes off; typically comes from IntentSender.getBroadcast().

    See Also:

    Handler, set(int, long, android.app.PendingIntent), cancel(android.app.PendingIntent), Context.sendBroadcast(android.content.Intent), Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter), Intent.filterEquals(android.content.Intent), ELAPSED_REALTIME, ELAPSED_REALTIME_WAKEUP, RTC, RTC_WAKEUP

  • setInexactRepeating

    public void setInexactRepeating(int type,
                           long triggerAtMillis,
                           long intervalMillis,
                           PendingIntent operation)

    Schedule a repeating alarm that has inexact trigger time requirements; for example, an alarm that repeats every hour, but not necessarily at the top of every hour. These alarms are more power-efficient than the strict recurrences supplied by setRepeating(int, long, long, android.app.PendingIntent), since the system can adjust alarms' phase to cause them to fire simultaneously, avoiding waking the device from sleep more than necessary.

    Your alarm's first trigger will not be before the requested time, but it might not occur for almost a full interval after that time. In addition, while the overall period of the repeating alarm will be as requested, the time between any two successive firings of the alarm may vary. If your application demands very low jitter, use setRepeating(int, long, long, android.app.PendingIntent) instead.

    Parameters:

    type - One of ELAPSED_REALTIME, ELAPSED_REALTIME_WAKEUP}, RTC or RTC_WAKEUP.

    triggerAtMillis - time in milliseconds that the alarm should first go off, using the appropriate clock (depending on the alarm type). This is inexact: the alarm will not fire before this time, but there may be a delay of almost an entire alarm interval before the first invocation of the alarm.

    intervalMillis - interval in milliseconds between subsequent repeats of the alarm. If this is one of INTERVAL_FIFTEEN_MINUTES, INTERVAL_HALF_HOUR, INTERVAL_HOUR, INTERVAL_HALF_DAY, or INTERVAL_DAY then the alarm will be phase-aligned with other alarms to reduce the number of wakeups. Otherwise, the alarm will be set as though the application had called setRepeating(int, long, long, android.app.PendingIntent).

    operation - Action to perform when the alarm goes off; typically comes from IntentSender.getBroadcast().

    See Also:

    Handler, set(int, long, android.app.PendingIntent), cancel(android.app.PendingIntent), Context.sendBroadcast(android.content.Intent), Context.registerReceiver(android.content.BroadcastReceiver, android.content.IntentFilter), Intent.filterEquals(android.content.Intent), ELAPSED_REALTIME, ELAPSED_REALTIME_WAKEUP, RTC, RTC_WAKEUP, INTERVAL_FIFTEEN_MINUTES, INTERVAL_HALF_HOUR, INTERVAL_HOUR, INTERVAL_HALF_DAY, INTERVAL_DAY

  • cancel

    public void cancel(PendingIntent operation)

    Remove any alarms with a matching Intent. Any alarm, of any type, whose Intent matches this one (as defined by Intent.filterEquals(android.content.Intent)), will be canceled.

    Parameters:

    operation - IntentSender which matches a previously added IntentSender.

    See Also:

    set(int, long, android.app.PendingIntent)

  • setTime

    public void setTime(long millis)

    Set the system wall clock time. Requires the permission android.permission.SET_TIME.

    Parameters:

    millis - time in milliseconds since the Epoch

  • setTimeZone

    public void setTimeZone(String timeZone)

    Set the system default time zone. Requires the permission android.permission.SET_TIME_ZONE.

    Parameters:

    timeZone - in the format understood by TimeZone