AlarmManager

ACTION_NEXT_ALARM_CLOCK_CHANGED

String ACTION_NEXT_ALARM_CLOCK_CHANGED

广播动作：在 getNextAlarmClock()返回的值发生变化后发送。

这是一个受保护的意图，只能由系统发送。 它只被发送给注册的接收者。

常量值：“android.app.action.NEXT_ALARM_CLOCK_CHANGED”

ELAPSED_REALTIME

int ELAPSED_REALTIME

闹钟时间SystemClock.elapsedRealtime() （启动后的时间，包括睡眠时间）。 该警报不会唤醒设备; 如果它在设备睡着的时候熄灭，它将不会在设备下一次唤醒之前交付。

常量值：3（0x00000003）

ELAPSED_REALTIME_WAKEUP

int ELAPSED_REALTIME_WAKEUP

SystemClock.elapsedRealtime()闹钟时间（启动后的时间，包括睡眠时间），当设备关闭时会唤醒设备。

常量值：2（0x00000002）

INTERVAL_DAY

long INTERVAL_DAY

在API 19之前的Android上运行时，由 setInexactRepeating(int, long, long, PendingIntent)识别的可用的不精确重复间隔。

常量值：86400000（0x0000000005265c00）

INTERVAL_FIFTEEN_MINUTES

long INTERVAL_FIFTEEN_MINUTES

在API 19之前的Android上运行时，由 setInexactRepeating(int, long, long, PendingIntent)识别的可用重复间隔时间可用。

常量值：900000（0x00000000000dbba0）

INTERVAL_HALF_DAY

long INTERVAL_HALF_DAY

在API 19之前的Android上运行时，由 setInexactRepeating(int, long, long, PendingIntent)识别的可用重复间隔时间可用。

常量值：43200000（0x0000000002932e00）

INTERVAL_HALF_HOUR

long INTERVAL_HALF_HOUR

在API 19之前的Android上运行时，由 setInexactRepeating(int, long, long, PendingIntent)识别的可用的不准确重复间隔。

常量值：1800000（0x00000000001b7740）

INTERVAL_HOUR

long INTERVAL_HOUR

在API 19之前的Android上运行时，由 setInexactRepeating(int, long, long, PendingIntent)识别的可用的不精确重复间隔。

常量值：3600000（0x000000000036ee80）

RTC

int RTC

System.currentTimeMillis()闹钟时间（以UTC表示的挂钟时间）。 该警报不会唤醒设备; 如果它在设备睡着的时候熄灭，它将不会在设备下一次唤醒之前交付。

常数值：1（0x00000001）

RTC_WAKEUP

int RTC_WAKEUP

闹钟时间为 System.currentTimeMillis() （以UTC表示的挂钟时间），当设备关闭时会唤醒设备。

常量值：0（0x00000000）

cancel

void cancel (PendingIntent operation)

使用匹配的Intent删除任何警报。 任何类型的意图匹配此意图的任何警报（由filterEquals(Intent)定义）将被取消。

cancel

void cancel (AlarmManager.OnAlarmListener listener)

删除预定发送给给定 AlarmManager.OnAlarmListener任何闹钟。

getNextAlarmClock

AlarmManager.AlarmClockInfo getNextAlarmClock ()

获取有关当前计划的下一个闹钟的信息。 所考虑的闹钟是由使用setAlarmClock(AlarmManager.AlarmClockInfo, PendingIntent)方法的任何应用程序预定的。

set

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

安排闹钟。 注意：对于定时操作（滴答，超时等），使用Handler会更容易和更高效。 如果已经为同一个IntentSender安排了警报，则先前的警报将首先被取消。

如果规定的触发时间在过去，则会立即触发警报。 如果已计划此意图的警报（两个意图的filterEquals(Intent)由filterEquals(Intent)定义），则它将被移除并由此替换。

该警报是通过AndroidManifest.xml文件中的 registerReceiver(BroadcastReceiver, IntentFilter)或<receiver>标签注册到的广播接收器的Intent广播。

报警意图通过一个名为Intent.EXTRA_ALARM_COUNT int类型的数据附加信息来Intent.EXTRA_ALARM_COUNT ，表明有多少过去的报警事件已累积到此意向广播中。 由于手机处于睡眠状态而未能送达的周期性警报可能会在交付时超过一次。

set

void set (int type, 
                long triggerAtMillis, 
                String tag, 
                AlarmManager.OnAlarmListener listener, 
                Handler targetHandler)

直接回调版本set(int, long, PendingIntent) 。 当达到闹钟时间时，不提供待发送的PendingIntent，而是提供此时将调用的AlarmManager.OnAlarmListener实例。

OnAlarmListener的 onAlarm()方法将通过指定的目标处理程序或在应用程序的主 null调用，如果 null作为 targetHandler参数传递。

setAlarmClock

void setAlarmClock (AlarmManager.AlarmClockInfo info, 
                PendingIntent operation)

安排代表闹钟的闹钟。 系统可以选择向用户显示关于该警报的信息。

此方法与 setExact(int, long, PendingIntent) ，但意味着 RTC_WAKEUP 。

setAndAllowWhileIdle

void setAndAllowWhileIdle (int type, 
                long triggerAtMillis, 
                PendingIntent operation)

像set(int, long, PendingIntent)一样，但即使系统处于低功耗空闲模式，也会允许执行此警报。 这种类型的警报只能用于实际需要警报在空闲期间熄灭的情况 - 一个合理的例子是日历通知应该发出声音，以便用户知道它。 当警报发出时，应用程序也会被添加到系统的临时白名单中约10秒钟，以允许该应用程序获取进一步的唤醒锁以完成其工作。

这些警报可能会在空闲时显着影响设备的电源使用（并因此导致应用程序对电池造成严重的电池责任），因此应小心使用它们。 为了减少滥用，对于特定应用程序的这些警报发生频率的限制是有限制的。 在正常的系统操作下，它不会在大约每分钟的时间内发送这些警报（此时每个这样的待处理警报都会发送）。 当处于低功率空闲模式时，这个持续时间可能会明显更长，例如15分钟。

与其他警报不同，系统可以自由地重新安排这种类型的警报，以防止其他警报发生，甚至是来自同一应用程序的警报。 当设备闲置时这会很明显地发生（因为这个闹钟可以在闲置时关闭，当应用程序发出任何其他警报时会保留，直到稍后），但即使不闲置也可能发生。

无论应用程序的目标SDK版本如何，此调用都可以批量处理警报。

setExact

void setExact (int type, 
                long triggerAtMillis, 
                PendingIntent operation)

安排警报在规定的时间准确发送。

此方法与set(int, long, PendingIntent)类似，但不允许操作系统调整交付时间。 警报将尽可能接近要求的触发时间。

注意：只有精确时间递送强烈需求的闹钟（例如在请求时间响闹的闹钟）才应该被安排。 强烈建议应用程序不要使用精确警报，因为它们会降低操作系统将电池使用量降至最低的能力。

setExact

void setExact (int type, 
                long triggerAtMillis, 
                String tag, 
                AlarmManager.OnAlarmListener listener, 
                Handler targetHandler)

直接回调版本setExact(int, long, PendingIntent) 。 当达到闹钟时间时，不提供待发送的PendingIntent，而是提供此时将调用的AlarmManager.OnAlarmListener实例。

OnAlarmListener的 onAlarm()方法将通过指定的目标处理程序或在应用程序的主 null调用，如果 null作为 targetHandler参数传递。

setExactAndAllowWhileIdle

void setExactAndAllowWhileIdle (int type, 
                long triggerAtMillis, 
                PendingIntent operation)

与setExact(int, long, PendingIntent)一样，但即使系统处于低功耗空闲模式，也会允许执行此警报。 如果您不需要确切的闹钟时间表，但仍然需要在空闲时执行，请考虑使用setAndAllowWhileIdle(int, long, PendingIntent) 。 这种类型的警报只能用于实际需要警报在空闲期间熄灭的情况 - 一个合理的例子是日历通知应该发出声音，以便用户知道它。 当警报发出时，应用程序也会被添加到系统的临时白名单中约10秒钟，以允许该应用程序获取进一步的唤醒锁以完成其工作。

这些警报可能会在空闲时显着影响设备的电源使用（并因此导致应用程序对电池造成严重的电池责任），因此应小心使用它们。 为了减少滥用，对于特定应用程序的这些警报发生频率的限制是有限制的。 在正常的系统操作下，它不会在大约每分钟的时间内发送这些警报（此时每个这样的待处理警报都会发送）。 当处于低功率空闲模式时，这个持续时间可能会明显更长，例如15分钟。

与其他警报不同，系统可以自由地重新安排这种类型的警报，以防止其他警报发生，甚至是来自同一应用程序的警报。 当设备闲置时这会很明显地发生（因为这个闹钟可以在闲置时关闭，当应用程序发出任何其他警报时会保留，直到稍后），但即使不闲置也可能发生。 请注意，由于应用程序选择了这种行为，操作系统将允许自己比安排正确的警报更具灵活性来安排这些警报。 当设备空闲时，为了优化电池寿命，可能需要调度更多的自由度。

setInexactRepeating

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

安排具有不精确触发时间要求的重复警报; 例如，每小时重复一次的警报，但不一定每小时都重复一次。 这些警报比传统上由setRepeating(int, long, long, PendingIntent)提供的严格重现setRepeating(int, long, long, PendingIntent) ，因为系统可以调整警报的交付时间以使其同时触发，避免超过必要的从睡眠状态唤醒设备。

警报的第一个触发不会在请求的时间之前，但在此之后的几乎整个时间间隔内可能不会发生。 另外，虽然重复报警的整个周期将按照要求进行，但报警的任何两次连续发射之间的时间可能会有所不同。 如果您的应用需要非常低的抖动，请改用适当窗口的一次性警报。 见setWindow(int, long, long, PendingIntent)和setExact(int, long, PendingIntent) 。

从API 19开始，所有重复警报都是不准确的。 由于此方法自API 3以来已可用，因此您的应用程序可以安全地调用它并确保它在当前版本和旧版本的Android上都会得到类似的行为。

setRepeating

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

安排重复报警。 注意：对于定时操作（滴答，超时等），使用Handler更容易，效率Handler 。 如果已经为同一个IntentSender安排了闹钟，它将首先被取消。

像set(int, long, PendingIntent)一样，除了您还可以提供闹钟自动重复的时间段。 该警报继续重复，直到cancel(AlarmManager.OnAlarmListener)明确删除。 如果规定的触发时间在过去，则警报将立即触发，并且警报计数取决于过去触发时间相对于重复间隔的距离。

如果警报延迟（例如，通过系统休眠，对于非_WAKEUP警报类型），将尽快传送跳过的重复。 之后，将来的报警将按照原始时间表发送; 他们不会随着时间漂移。 例如，如果您在每小时的顶部设置了重复闹钟，但手机在7:45至8:45之间睡着了，手机一旦唤醒就会发出闹钟，然后下一次闹钟将以9:00。

如果您的应用程序希望允许交付时间漂移以确保警报之间至少经过一段特定的时间间隔，则采取的方法是使用一次性警报，在处理每个警报传递时安排下一个警报。

注意：从API 19开始，所有重复警报都是不准确的。 如果您的应用程序需要精确的交付时间，那么它必须使用一次性精确警报，如上所述每次重新安排时间。 传统应用程序的targetSdkVersion比API 19早，它们将继续拥有所有警报，包括重复警报，并将其视为确切对待。

setTime

void setTime (long millis)

设置系统挂钟时间。 需要权限android.permission.SET_TIME。

setTimeZone

void setTimeZone (String timeZone)

设置系统的永久默认时区。 这是所有应用的时区，即使重启后也是如此。 如果您只是想更改应用程序中的时区，则可以使用setDefault(TimeZone) ，即使这样，仍然希望将明确的TimeZone传递给需要它的API，而不是更改所有线程的时区。

在android M及更高版本中，将非Olson时区传递给此函数是错误的。 请注意，对于所有Android版本，这是一个糟糕的主意，因为POSIX和TimeZone类在相同的非Olson ID中具有相反的解释'+'和'-' 。

setWindow

void setWindow (int type, 
                long windowStartMillis, 
                long windowLengthMillis, 
                PendingIntent operation)

安排警报在给定的时间范围内发送。 此方法类似于set(int, long, PendingIntent) ，但允许应用程序精确控制操作系统可能调整其传送的程度。 这种方法允许应用程序利用交付批量产生的电池优化，即使它对警报具有适度的及时性要求。

此方法还可用于通过确保为每个警报请求的窗口不相交来实现多个警报之间的严格排序保证。

如果不需要精确交货，则应用程序应使用标准set(int, long, PendingIntent)方法。 这将为OS提供最大的灵活性，以最大限度地减少唤醒和电池使用。 对于必须在精确指定的时间内交付并且没有可接受的变化的警报，应用程序可以使用setExact(int, long, PendingIntent) 。

setWindow

void setWindow (int type, 
                long windowStartMillis, 
                long windowLengthMillis, 
                String tag, 
                AlarmManager.OnAlarmListener listener, 
                Handler targetHandler)

直接回调版本setWindow(int, long, long, PendingIntent) 。 当达到闹钟时间时，不提供待发送的PendingIntent，而是提供此时将调用的AlarmManager.OnAlarmListener实例。

如果 null作为 targetHandler参数传递， targetHandler通过指定的目标处理程序或在应用程序的主 null调用OnAlarmListener onAlarm()方法。