android闹钟系统设计报告

概要：本文通过对OPhone内置闹铃功能的简单介绍，来让开发者朋友们了解基于OPhone 平台下客户/服务模式的编程模型，以及如何使用OPhone系统提供的闹铃唤醒功能。与此同时，本文还对PendingIntent做一些简单的介绍，并通过实例程序来演示如何通过PendingIntent将闹钟应用程序和系统闹铃服务联系起来。

关键字：闹钟；

一、闹铃功能

闹钟应用程序作为人们日常常用的基本应用程序之一，其重要性不言而喻。在OPhone 系统中闹铃服务功能不仅仅对闹钟应用程序服务，最重要的是可以利用该闹铃服务功能提供的唤醒能力来做定时器。这样即便应用程序没有运行或者是没有启动的情况下，只要其注册过闹铃，那么该闹铃到时间后，OPhone系统可以自动将该应用程序启动，这就是所谓的闹铃“唤醒“功能。

在OPhone系统中，底层系统提供了两种类型的时钟，软时钟与硬时钟，软时钟就是我们常说的Timer,硬时钟就是RTC。系统在正常运行的情况下，Timer工作提供时间服务和闹铃提醒，而在系统进入睡眠状态后，时间服务和闹铃提醒由RTC来负责。对于上层应用来说，我们并不需要关心是timer还是RTC为我们提供服务，因为OPhone系统的Framework层把底层细节做了封装并统一提供API。这个API他的名字就叫AlarmManager。在OPhone系统中有意思的是对应AlarmManage有一个AlarmManagerServie服务程序，该服务程序才是正真提供闹铃服务的，它主要维护应用程序注册下来的各类闹铃并适时的设置即将触发的闹铃给闹铃设备（在OPhone系统中，linux实现的设备名为”/dev/alarm”），并且一直监听闹铃设备，一旦有闹铃触发或者是闹铃事件发生，AlarmManagerServie服务程序就会遍历闹铃列表找到相应的注册闹铃并发出广播。该服务程序在系统启动时被系统服务程序system_service启动并初始化闹铃设备(/dev/alarm)。当然，在JAVA层的AlarmManagerService与Linux Alarm驱动程序接口之间还有一层封装，那就是JNI。

AlarmManager将应用与服务分割开来后，使得应用程序开发者不用关心具体的服务，而是直接通过AlarmManager来使用这种服务。这也许就是客户/服务模式的好处吧。AlarmManager与AlarmManagerServie之间是通过Binder来通信的，他们之间是多对一的关系。在OPhone系统中，AlarmManage提供了3个接口5种类型的闹铃服务：

3个API调用接口：

void cancel(PendingIntent operation)

// 取消已经注册的与参数匹配的闹铃

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

//注册一个新的闹铃

void setRepeating(int type, long triggerAtTime, long interval, PendingIntent operation)

//注册一个重复类型的闹铃

void setTimeZone(String timeZone)

//设置时区

5种闹铃类型：

public static final int ELAPSED_REALTIME

//当系统进入睡眠状态时，这种类型的闹铃不会唤醒系统。直到系统下次被唤醒才传递它，该闹铃所用的时间是相对时间，是从系统启动后开始计时的,包括睡眠时间，可以通过调用SystemClock.elapsedRealtime()获得。系统值是3 (0x00000003)。

public static final int ELAPSED_REALTIME_WAKEUP

//能唤醒系统，用法同ELAPSED_REALTIME，系统值是2 (0x00000002) 。

public static final int RTC

//当系统进入睡眠状态时，这种类型的闹铃不会唤醒系统。直到系统下次被唤醒才传递它，该闹铃所用的时间是绝对时间，所用时间是UTC时间，可以通过调用

System.currentTimeMillis()获得。系统值是1 (0x00000001) 。

public static final int RTC_WAKEUP

//能唤醒系统，用法同RTC类型，系统值为0 (0x00000000) 。

Public static final int POWER_OFF_WAKEUP

//能唤醒系统，它是一种关机闹铃，就是说设备在关机状态下也可以唤醒系统，所以我们把它称之为关机闹铃。使用方法同RTC类型，系统值为4(0x00000004)。

开发者可以通过OPhone SDK来获取更多AlarmManager的相关细节，他所在的包是：Android.app.AlarmManager

随着OPhone系统版本的不断的升级，这些接口和闹铃类型也许会有些调整，但其基本使用方法将不会改变

二、闹钟设置与提醒

我们首先通过一个直观的UI来感受一下OPhone系统内嵌的闹钟程序是如何响应用户设置和自动提醒的的：（如下4个图所示）

（图一）（图二）

（图三）（图四）

上面4图直观的告诉了开发者如何使用OPhone内嵌的闹钟应用程序，但开发者可能更关心的是通过代码如何实现这些功能。比如说怎么设置一个闹铃，该设置哪种类型的闹铃，以及如何获得闹铃时间已到并提醒用户。依据这几个问题，我们在下面的章节中逐步来介绍。

2.1 设置闹铃

在第一小节中，我们已经提到过OPhone系统AlarmManagerService提供了两个设置闹铃的API，他们分别是：

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

void setRepeating(int type, long triggerAtTime, long interval, PendingIntent operation)

在OPhone 1.5版本中又增加了一个API。

下面的程序演示了如何设置一个闹铃。

/当设置的闹铃触发时，Ophone系统会广播一个Intent，当然我们需要在创建一个新的闹铃//时注册一个闹铃事件接收对象AlarmReceiver ，该接收对象也可以通过在

//AndroidManifest.xml中发布，也可以在代码中动态注册。

import android.app.AlarmManager;

import android.app.PendingIntent;

import android.content.Intent;

import android.os.SystemClock;

import android.os.Bundle;

import java.util.Calendar;

//创建一个PendingIntent

Intent intent = new Intent(ALARM_ALERT_ACTION);

intent.putExtra(ID, id);

intent.putExtra(TIME, atTimeInMillis);

PendingIntent sender = PendingIntent.getBroadcast(

context, 0, intent, PendingIntent.FLAG_CANCEL_CURRENT);

//获得AlarmMnager并注册一个新闹铃，

//一次性闹铃的设置

AlarmManager am = (AlarmManager)getSystemService(ALARM_SERVICE);

am.set(AlarmManager.POWER_OFF_WAKEUP, atTimeInMillis, sender);