android闹钟系统设计报告

PendingInent与AlarmManager概要：本文通过对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与LinuxAlarm驱动程序接口之间还有一层封装，那就是JNI。AlarmManager将应用与服务分割开来后，使得应用程序开发者不用关心具体的服务，而是直接通过AlarmManager来使用这种服务。这也许就是客户/服务模式的好处吧。AlarmManager与AlarmManagerServie之间是通过Binder来通信的，他们之间是多对一的关系。在OPhone系统中，AlarmManage提供了3个接口5种类型的闹铃服务：3个API调用接口：voidcancel(PendingIntentoperation)//取消已经注册的与参数匹配的闹铃voidset(inttype,longtriggerAtTime,PendingIntentoperation)//注册一个新的闹铃voidsetRepeating(inttype,longtriggerAtTime,longinterval,PendingIntentoperation)//注册一个重复类型的闹铃voidsetTimeZone(StringtimeZone)//设置时区5种闹铃类型：publicstaticfinalintELAPSED_REALTIME//当系统进入睡眠状态时，这种类型的闹铃不会唤醒系统。直到系统下次被唤醒才传递它，该闹铃所用的时间是相对时间，是从系统启动后开始计时的,包括睡眠时间，可以通过调用SystemClock.elapsedRealtime()获得。系统值是3(0x00000003)。publicstaticfinalintELAPSED_REALTIME_WAKEUP//能唤醒系统，用法同ELAPSED_REALTIME，系统值是2(0x00000002)。publicstaticfinalintRTC//当系统进入睡眠状态时，这种类型的闹铃不会唤醒系统。直到系统下次被唤醒才传递它，该闹铃所用的时间是绝对时间，所用时间是UTC时间，可以通过调用System.currentTimeMillis()获得。系统值是1(0x00000001)。publicstaticfinalintRTC_WAKEUP//能唤醒系统，用法同RTC类型，系统值为0(0x00000000)。PublicstaticfinalintPOWER_OFF_WAKEUP//能唤醒系统，它是一种关机闹铃，就是说设备在关机状态下也可以唤醒系统，所以我们把它称之为关机闹铃。使用方法同RTC类型，系统值为4(0x00000004)。开发者可以通过OPhoneSDK来获取更多AlarmManager的相关细节，他所在的包是：Android.app.AlarmManager随着OPhone系统版本的不断的升级，这些接口和闹铃类型也许会有些调整，但其基本使用方法将不会改变二、闹钟设置与提醒我们首先通过一个直观的UI来感受一下OPhone系统内嵌的闹钟程序是如何响应用户设置和自动提醒的的：（如下4个图所示）（图一）（图二）（图三）（图四）上面4图直观的告诉了开发者如何使用OPhone内嵌的闹钟应用程序，但开发者可能更关心的是通过代码如何实现这些功能。比如说怎么设置一个闹铃，该设置哪种类型的闹铃，以及如何获得闹铃时间已到并提醒用户。依据这几个问题，我们在下面的章节中逐步来介绍。2.1设置闹铃在第一小节中，我们已经提到过OPhone系统AlarmManagerService提供了两个设置闹铃的API，他们分别是：voidset(inttype,longtriggerAtTime,PendingIntentoperation)voidsetRepeating(inttype,longtriggerAtTime,longinterval,PendingIntentoperation)在OPhone1.5版本中又增加了一个API。下面的程序演示了如何设置一个闹铃。/当设置的闹铃触发时，Ophone系统会广播一个Intent，当然我们需要在创建一个新的闹铃//时注册一个闹铃事件接收对象AlarmReceiver，该接收对象也可以通过在//AndroidManifest.xml中发布，也可以在代码中动态注册。importandroid.app.AlarmManager;importandroid.app.PendingIntent;importandroid.content.Intent;importandroid.os.SystemClock;importandroid.os.Bundle;importjava.util.Calendar;//创建一个PendingIntentIntentintent=newIntent(ALARM_ALERT_ACTION);intent.putExtra(ID,id);intent.putExtra(TIME,atTimeInMillis);PendingIntentsender=PendingIntent.getBroadcast(context,0,intent,PendingIntent.FLAG_CANCEL_CURRENT);//获得AlarmMnager并注册一个新闹铃，//一次性闹铃的设置AlarmManageram=(AlarmManager)getSystemService(ALARM_SERVICE);am.set(AlarmManager.POWER_OFF_WAKEUP,atTimeInMillis,sender);//重复性闹铃的设置//Wewantthealarmtogooff30secondsfromnow.longfirstTime=SystemClock.elapsedRealtime();firstTime+=15*1000;//Schedulethealarm!AlarmManageram=(AlarmManager)getSystemService(ALARM_SERVICE);am.setRepeating(AlarmManager.POWER_OFF_WAKEUP,firstTime,15*1000,sender);//在AndroidManifest.xml中注册receiverandroid:name=AlarmReceiverintent-filteractionandroid:name=com.android.alarmclock.ALARM_ALERT//intent-filter/receiver//在应用程序执行过程中注册AlarmReceivermAlarmReceiver;IntentFilterfilter=newIntentFilter();filter.addAction(“com.android.alarmclock.ALARM_ALERT”);context.registerReceiver(mAlarmReceiver,filter);publicclassAlarmReceiverextendsBroadcastReceiver{@OverridepublicvoidonReceive(Contextcontext,Intentintent){}}2.2闹铃提醒在OPhone系统中，当应用程序所设置的闹铃时间到了后，OPhone系统中的AlarmManagerService就会从系统底层获取一个闹铃事件并从自己维护的队列中取出其匹配的闹铃，然后通过其应用注册的PendingIntent把该闹铃事件发送回给应用。PendingIntent.send();当我们的应用收到该Intent后就会启动相应的Activity来提醒用户闹铃时间到。程序代码如下：packagecom.android.alarmclock;importandroid.content.Context;importandroid.content.Intent;importandroid.content.BroadcastReceiver;importandroid.os.Handler;importandroid.os.PowerManager;importandroid.os.SystemClock;publicclassAlarmReceiverextendsBroadcastReceiver{@OverridepublicvoidonReceive(Contextcontext,Intentintent){longnow=System.currentTimeMillis();intid=intent.getIntExtra(Alarms.ID,0);longsetFor=intent.getLongExtra(Alarms.TIME,0);IntentfireAlarm=newIntent(context,AlarmAlert.class);fireAlarm.putExtra(Alarms.ID,id);fireAlarm.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);//启动一个新的UI对象来提醒context.startActivity(fireAlarm);}}三、PendingIntent在前面的章节中，我们在注册闹铃﹑发送闹铃事件的时候，有过一个重要的参数PendingIntent。这个PendingIntent可以说是Intent的进一步封装，他既包含了Intent的描述又是Intent行为的执行（这种定义也许不太严格），如果将Intent比作成一个订单的话，PendingIntent更像是一个下订单的人，因为它既要负责将订单发出去，也要负责订单发送后的处理，比如发送成功后要准备验收订单货物，发送失败后要重发还是取消订单等操作。开发者可以通过调用getActivity(Context,