androidalarm.docx
《androidalarm.docx》由会员分享,可在线阅读,更多相关《androidalarm.docx(12页珍藏版)》请在冰豆网上搜索。
androidalarm
PendingInent与AlarmManager
∙2009-11-2223:
13:
51
∙来源:
∙网友评论0条
概要:
本文通过对OPhone内置闹铃功能的简单介绍,来让开发者朋友们了解基于OPhone平台下客户/服务模式的编程模型,以及如何使用OPhone系统提供的闹铃唤醒功能。
与此同时,本文还对PendingIntent做一些简单的介绍,并通过实例程序来演示如何通过PendingIntent将闹钟应用程序和系统闹铃服务联系起来。
(作者:
YangAi'in)
一、闹铃功能
闹钟应用程序作为人们日常常用的基本应用程序之一,其重要性不言而喻。
在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调用接口:
void cancel(PendingIntentoperation)
//取消已经注册的与参数匹配的闹铃
void set(inttype,longtriggerAtTime,PendingIntentoperation)
//注册一个新的闹铃
void setRepeating(inttype,longtriggerAtTime,longinterval,PendingIntentoperation)
//注册一个重复类型的闹铃
void setTimeZone(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,他们分别是:
void set(inttype,longtriggerAtTime,PendingIntentoperation)
void setRepeating(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;
//创建一个PendingIntent
Intentintent=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中注册
name="AlarmReceiver">
name="com.android.alarmclock.ALARM_ALERT"/>
//在应用程序执行过程中注册
AlarmReceivermAlarmReceiver;
IntentFilterfilter=newIntentFilter();
filter.addAction(“com.android.alarmclock.ALARM_ALERT”);
context.registerReceiver(mAlarmReceiver,filter);
publicclassAlarmReceiverextendsBroadcastReceiver{
@Override
publicvoidonReceive(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{
@Override
publicvoidonReceive(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,int,Intent,int),getBroadcast(Context,int,Intent,int),getService(Context,int,Intent,int)函数来得到一个PendingIntent实例。
publicstaticPendingIntentgetBroadcast(Contextcontext,intrequestCode,Intentintent,intflags)
通过该函数获得的PendingIntent将会扮演一个广播的功能,就像调用Context.sendBroadcast()函数一样。
当系统通过它要发送一个intent时要采用广播的形式,并且在该intent中会包含相应的intent接收对象,当然这个对象我们可以在创建PendingIntent的时候指定,也可以通过ACTION和CATEGORY等描述让OPhone系统自动找到该行为处理对象。
实例代码如下:
Intentintent=newIntent(AlarmController.this,OneShotAlarm.class);
PendingIntentsender=PendingIntent.getBroadcast(AlarmController.this,
0,intent,0);
PublicstaticPendingIntentgetActivity(Context,int,Intent,int)
通过该函数获得的PendingIntent可以直接启动新的activity,就像调用Context.startActivity(Intent)一样.不过值得注意的是要想这个新的Activity不再是当前进程存在的Activity时。
我们在intent中必须使用Intent.FLAG_ACTIVITY_NEW_TASK.
实例代码如下:
//ThePendingIntenttolaunchouractivityiftheuserselectsthisnotification
PendingIntentcontentIntent=PendingIntent.getActivity(this,0,
newIntent(this,AlarmService.class),0);
publicstaticPendingIntentgetService(Contextcontext,intrequestCode,Intentintent,intflags)
通过该函数获得的PengdingIntent可以直接启动新的Service,就像调用Context.startService()一样。
实例代码如下:
//CreateanIntentSenderthatwilllaunchourservice,tobescheduled
//withthealarmmanager.
mAlarmSender=PendingIntent.getService(AlarmService.this,
0,newIntent(AlarmService.this,AlarmService_Service.class),0);
四、PendingInent与service
在OPhone系统编程中,一个完整OPhone应用程序可以有4个需要创建的模块,他们分别是:
Activity,BroadcastintentReceiver,Service,ContentProvider。
Service作为一个OPhone应用程序组成部分,通常运行在系统后台,他与用户之间没有交互。
像其他应用程序对象一样运行在所属进程的主线程中。
那么这就意味着它有可能进入长时间的运行等待而导致应用得不到用户的相应。
所以在开发者设计程序的时候就要考虑,如果一个Service要做一些长时间的数据处理时(比如播放MP3,或者是网络下载),就需要把该工作切换到自己的线程空间来执行。
实例代码如下:
importandroid.app.Notification;
importandroid.app.NotificationManager;
importandroid.app.PendingIntent;
importandroid.app.Service;
importandroid.content.Intent;
importandroid.os.Binder;
importandroid.os.IBinder;
importandroid.os.Parcel;
importandroid.os.RemoteException;
importandroid.widget.Toast;
//定义一个Service对象
publicclassAlarmService_ServiceextendsService{
NotificationManagermNM;
publicvoidonCreate(){
//创建一个线程来运行Runnable
Threadthr=newThread(null,mTask,"AlarmService_Service");
thr.start();
}
publicvoidonDestroy(){
}
RunnablemTask=newRunnable(){
publicvoidrun(){
//通常我们就可以在这里设计长时间运行的功能,
longendTime=System.currentTimeMillis()+15*1000;
while(System.currentTimeMillis() synchronized(mBinder){
try{
mBinder.wait(endTime-System.currentTimeMillis());
}catch(Exceptione){
}
}
}
//停止Service
AlarmService_Service.this.stopSelf();
}
};
//在编写Service代码时,可以不实现onStart,onStop等函数,但一定要实现onBind函数
publicIBinderonBind(Intentintent){
returnmBinder;
}
/* 通过该对象可以与客户端通信
*/
privatefinalIBindermBinder=newBinder(){
@Override
protectedbooleanonTransact(intcode,Parceldata,Parcelreply,
intflags)throwsRemoteException{
returnsuper.onTransact(code,data,reply,flags);
}