public final class AlarmClock
extends Object
| java.lang.Object | |
| ↳ | android.provider.AlarmClock |
AlarmClock提供程序包含一个Intent操作以及可用于启动Activity以在闹钟应用程序中设置新警报或计时器的附加功能。 希望接收ACTION_SET_ALARM和ACTION_SET_TIMER意图的应用程序应该创建一个活动来处理需要com.android.alarm.permission.SET_ALARM权限的Intent。 希望创建新警报或计时器的应用程序应使用Context.startActivity()以便用户可以选择使用哪个闹钟应用程序。
Constants |
|
|---|---|
String |
ACTION_DISMISS_ALARM 活动操作：关闭警报。 |
String |
ACTION_SET_ALARM 活动操作：设置闹钟。 |
String |
ACTION_SET_TIMER 活动行动：设置一个计时器。 |
String |
ACTION_SHOW_ALARMS 活动操作：显示警报。 |
String |
ACTION_SNOOZE_ALARM 活动操作：暂停当前振铃的警报。 |
String |
ALARM_SEARCH_MODE_ALL 选择所有警报。 |
String |
ALARM_SEARCH_MODE_LABEL 按警报标签搜索。 |
String |
ALARM_SEARCH_MODE_NEXT 选择下一个振铃的闹铃，或者当前振铃的闹铃（如果有的话）。 |
String |
ALARM_SEARCH_MODE_TIME 搜索由搜索参数最紧密匹配的报警 |
String |
EXTRA_ALARM_SEARCH_MODE 附加软件包：指定搜索模式的类型以查找警报。 |
String |
EXTRA_ALARM_SNOOZE_DURATION 附加套餐：以分钟为单位的闹钟的打盹持续时间。 |
String |
EXTRA_DAYS 附加套餐：重复闹钟的平日。 |
String |
EXTRA_HOUR 附加套餐：闹钟的小时。 |
String |
EXTRA_IS_PM 额外捆绑：警报的AM / PM。 |
String |
EXTRA_LENGTH Bundle extra：定时器的长度，以秒为单位。 |
String |
EXTRA_MESSAGE 附加组件：报警或计时器的自定义消息。 |
String |
EXTRA_MINUTES 附加套餐：闹钟的分钟数。 |
String |
EXTRA_RINGTONE 附加套餐：使用此闹钟播放铃声。 |
String |
EXTRA_SKIP_UI Bundle extra：是否在执行操作后显示活动。 |
String |
EXTRA_VIBRATE 附加组件：是否激活设备振动器。 |
String |
VALUE_RINGTONE_SILENT 捆绑附加值：表示不应播放铃声。 |
Public constructors |
|
|---|---|
AlarmClock() |
|
Inherited methods |
|
|---|---|
 From class java.lang.Object
|
|
String ACTION_DISMISS_ALARM
活动操作：关闭警报。
可以通过以下某种方式指定或搜索要解除的警报：
Android开发手册EXTRA_ALARM_SEARCH_MODE to determine how to search for the alarm. 如果以上都没有给出：
如果使用额外的EXTRA_ALARM_SEARCH_MODE ，并且搜索结果包含两个或更多匹配的警报，则实施应该显示带有结果的UI，并允许用户选择要解除的警报。 如果实施支持CATEGORY_VOICE ，并且活动以语音交互模式启动（即检查isVoiceInteraction() ），则实施应额外使用VoiceInteractor.PickOptionRequest开始语音交互后续流程，以帮助用户通过语音消除歧义。
如果指定的警报是单次发生警报，则有效地解除警报会禁用警报; 除非明确重新启用，否则它不会再次振铃。
如果指定的警报是重复警报，则解除警报只能防止即将发生的事件振铃。 警报保持启用状态，以便它在下一个实例的日期和时间（即即将到来的实例之后的实例）仍然响铃。
也可以看看：
常量值：“android.intent.action.DISMISS_ALARM”
String ACTION_SET_ALARM
活动操作：设置闹钟。
激活现有的警报或创建一个新警报。
此操作要求在一天的给定时间内设置闹钟。 如果没有指定一天的时间，则实施应该启动一个能够设置警报的活动（在这种情况下EXTRA_SKIP_UI被忽略）。 如果指定了一天中的某个时间，并且EXTRA_SKIP_UI为true ，并且该警报不重复，则实施应在该警报解除后将其删除。 如果存在与所有参数匹配的相同警报，则实施可能会重新使用该警报而不是创建新警报（在这种情况下，警报不应在解散后除去）。
此操作始终启用警报。
此活动也可以在语音交互模式下启动。 该活动应检查isVoiceInteraction() ，如果属实，则实施应使用VoiceInteractor.CompleteVoiceRequest报告创建/启用警报的VoiceInteractor.CompleteVoiceRequest 。 这允许后续语音操作（例如ACTION_DISMISS_ALARM解除刚启用的警报。
EXTRA_HOUR (optional): The hour of the alarm being set. EXTRA_MINUTES (optional): The minutes of the alarm being set. EXTRA_DAYS (optional): Weekdays for repeating alarm. EXTRA_MESSAGE (optional): A custom message for the alarm. EXTRA_RINGTONE (optional): A ringtone to play with this alarm. EXTRA_VIBRATE (optional): Whether or not to activate the device vibrator for this alarm. EXTRA_SKIP_UI (optional): Whether or not to display an activity for setting this alarm. 常量值：“android.intent.action.SET_ALARM”
String ACTION_SET_TIMER
活动行动：设置一个计时器。
激活现有计时器或创建一个新计时器。
这个动作请求一个定时器启动一个特定的length的时间。 如果没有指定length ，则实施应该启动一个能够设置定时器的活动（在这种情况下EXTRA_SKIP_UI被忽略）。 如果指定了length ，并且EXTRA_SKIP_UI是true ，那么实现应该在解除该定时器后移除该定时器。 如果一个相同的，未使用的定时器存在与两个参数相匹配，则实现可以重新使用它而不是创建一个新的定时器（在这种情况下，解除定时器后不应该被移除）。 这个动作总是启动计时器。
EXTRA_LENGTH (optional): The length of the timer being set. EXTRA_MESSAGE (optional): A custom message for the timer. EXTRA_SKIP_UI (optional): Whether or not to display an activity for setting this timer. 常量值：“android.intent.action.SET_TIMER”
String ACTION_SHOW_ALARMS
活动操作：显示警报。
此操作将打开警报页面。
常量值：“android.intent.action.SHOW_ALARMS”
String ACTION_SNOOZE_ALARM
活动操作：暂停当前振铃的警报。
暂停当前正在响铃的闹钟。 可以选择额外的EXTRA_ALARM_SNOOZE_DURATION来指定打盹持续时间; 如果未设置，则实施应使用合理的默认值，例如10分钟。 在打盹持续时间后，闹铃应再次响起。
注意：设置额外EXTRA_ALARM_SNOOZE_DURATION不会改变默认的打盹持续时间; 它只适用于当前正在响铃的闹钟。
如果当前没有振铃报警，那么这是一个空操作。
也可以看看：
常量值：“android.intent.action.SNOOZE_ALARM”
String ALARM_SEARCH_MODE_ALL
选择所有警报。
也可以看看：
常量值：“android.all”
String ALARM_SEARCH_MODE_LABEL
按警报标签搜索。 应返回包含给定标签中的单词或短语的警报。
也可以看看：
常量值：“android.label”
String ALARM_SEARCH_MODE_NEXT
选择下一个振铃的闹铃，或者当前振铃的闹铃（如果有的话）。
也可以看看：
常量值：“android.next”
String ALARM_SEARCH_MODE_TIME
搜索由搜索参数最紧密匹配的报警EXTRA_HOUR ， EXTRA_MINUTES ， EXTRA_IS_PM 。 在这种搜索模式下，至少需要添加其中一种附加功能。
EXTRA_HOUR - The hour to search for the alarm. EXTRA_MINUTES - The minute to search for the alarm. EXTRA_IS_PM - Whether the hour is AM or PM. 也可以看看：
常量值：“android.time”
String EXTRA_ALARM_SEARCH_MODE
附加软件包：指定搜索模式的类型以查找警报。
例如，由 ACTION_DISMISS_ALARM用于识别要解雇的警报。
只有当警报尚未由Intent的数据URI中指定的深层链接识别时，才会使用此额外信息。
此额外值为 String ，仅限于以下一组受支持的搜索模式：
ALARM_SEARCH_MODE_TIME: Selects the alarm that is most closely matched by the search parameters EXTRA_HOUR, EXTRA_MINUTES, EXTRA_IS_PM. ALARM_SEARCH_MODE_NEXT: Selects the alarm that will ring next, or the alarm that is currently ringing, if any. ALARM_SEARCH_MODE_ALL: Selects all alarms. ALARM_SEARCH_MODE_LABEL: Search by alarm label. Should return alarms that contain the word or phrase in given label. 也可以看看：
常量值：“android.intent.extra.alarm.SEARCH_MODE”
String EXTRA_ALARM_SNOOZE_DURATION
附加套餐：以分钟为单位的闹钟的打盹持续时间。
由ACTION_SNOOZE_ALARM 。 该额外值是可选的，值为Integer ，用于指定暂停闹钟的持续时间（以分钟为单位）。
也可以看看：
常量值：“android.intent.extra.alarm.SNOOZE_DURATION”
String EXTRA_DAYS
附加套餐：重复闹钟的平日。
由 ACTION_SET_ALARM 。
该值是一个ArrayList<Integer> 。 每个项目可以是：
常量值：“android.intent.extra.alarm.DAYS”
String EXTRA_HOUR
附加套餐：闹钟的小时。
由 ACTION_SET_ALARM 。
这额外是可选的。 如果未提供，实施应打开一个活动，允许用户使用用户提供的时间设置闹钟。
该值是 Integer ，范围从0到23。
常量值：“android.intent.extra.alarm.HOUR”
String EXTRA_IS_PM
额外捆绑：警报的AM / PM。
这个额外的选项是可选的，只有当EXTRA_ALARM_SEARCH_MODE被设置为ALARM_SEARCH_MODE_TIME时才被使用。 在此搜索模式下， EXTRA_IS_PM与EXTRA_HOUR和EXTRA_MINUTES一起使用。 实施应该查找这些搜索参数最匹配的警报。 如果缺少EXTRA_IS_PM ，则指定的EXTRA_HOUR的AM / PM不明确，并且实现应要求用户澄清。
该值为 Boolean ，其中false = AM且true = PM。
常量值：“android.intent.extra.alarm.IS_PM”
String EXTRA_LENGTH
Bundle extra：定时器的长度，以秒为单位。
由 ACTION_SET_TIMER 。
这额外是可选的。 如果未提供，则实现应打开一个允许用户使用用户提供的长度设置计时器的活动。
值为 Integer ，范围从1到86400（24小时）。
也可以看看：
常量值：“android.intent.extra.alarm.LENGTH”
String EXTRA_MESSAGE
附加组件：报警或计时器的自定义消息。
由 ACTION_SET_ALARM和 ACTION_SET_TIMER 。
该值是 String 。
也可以看看：
常量值：“android.intent.extra.alarm.MESSAGE”
String EXTRA_MINUTES
附加套餐：闹钟的分钟数。
由 ACTION_SET_ALARM 。
该值为 Integer ，范围从0到59.如果未提供，则默认为0。
也可以看看：
常量值：“android.intent.extra.alarm.MINUTES”
String EXTRA_RINGTONE
附加套餐：使用此闹钟播放铃声。
由 ACTION_SET_ALARM 。
此值是一个String和可以被设定为VALUE_RINGTONE_SILENT或到内容将要播放的媒体的URI。 如果未指定或URI不存在，则将使用"content://settings/system/alarm_alert 。
常量值：“android.intent.extra.alarm.RINGTONE”
String EXTRA_SKIP_UI
Bundle extra：是否在执行操作后显示活动。
由 ACTION_SET_ALARM和 ACTION_SET_TIMER 。
如果为true，则应用程序被要求绕过任何中间用户界面。 如果为false，则应用程序可能会显示中间用户界面，如确认对话框或设置。
该值是Boolean 。 默认值是false 。
也可以看看：
常量值：“android.intent.extra.alarm.SKIP_UI”
String EXTRA_VIBRATE
附加组件：是否激活设备振动器。
由 ACTION_SET_ALARM 。
该值是Boolean 。 默认值是true 。
常量值：“android.intent.extra.alarm.VIBRATE”
String VALUE_RINGTONE_SILENT
捆绑附加值：表示不应播放铃声。
由 ACTION_SET_ALARM ，通过 EXTRA_RINGTONE 。
常数值：“无声”