3个接口:
- // 取消已经注册的与参数匹配的闹铃
- void cancel(PendingIntent operation)
- //注册一个新的闹铃
- void set( int type, long triggerAtTime, PendingIntent operation)
- //注册一个重复类型的闹铃
- //triggerAtTime响铃时间,interval 响铃间隔
- void setRepeating( int type, long triggerAtTime, long interval, PendingIntent operation)
- //设置时区
- void setTimeZone(String timeZone)
setInexactRepeating(int type,long startTime,long intervalTime,PendingIntent pi);
该方法也用于设置重复闹钟,与第二个方法相似,不过其两个闹钟执行的间隔时间不是固定的而已。它相对而言更节能(power-efficient)一些,因为系统可能会将几个差不多的闹钟合并为一个来执行,减少设备的唤醒次数。 有点类似JAVA的Timer里面schedule(TimerTask task, Date firstTime, long period):根据前一次执行的实际执行时间来安排每次执行。如果由于任何原因(如垃圾回收或其他后台活动)而延迟了某次执行,则后续执行也将被延迟。在长期运行中,执行的频率一般要稍慢于指定周期的倒数(假定 Object.wait(long) 所依靠的系统时钟是准确的)。
cancel(PendingIntent operation)
取消一个设置的闹钟
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)。
注意一个重要的参数PendingIntent。这个PendingIntent可以说是 Intent的进一步封装,
他既包含了Intent的描述又是Intent行为的执行(这种定义也许不太严格),
如果将Intent比作成一个订单的 话,PendingIntent更像是一个下订单的人,
因为它既要负责将订单发出去,也要负责订单发送后的处理,
比如发送成功后要准备验收订单货物,发送 失败后要重发还是取消订单等操作。
开发者可以通过调用三种不同方式来得到一个PendingIntent实例。
getActivity(Context, int, Intent, int)
getBroadcast(Context, int, Intent, int)
getService(Context, int, Intent, int)
getBroadcast
通过该函数获得的PendingIntent将会 扮演一个广播的功能,就像调用 Context.sendBroadcast()函数一样。
当系统通过它要发送一个intent时要采用广播的形式,并且在该intent中会包含相应的 intent接收对象,
当然这个对象我们可以在创建PendingIntent的时候指定,也可以通过ACTION 和CATEGORY等描述让系统自动找到该行为处理对象。
- Intent intent = new Intent(AlarmController. this , OneShotAlarm. class );
- PendingIntent sender = PendingIntent.getBroadcast(AlarmController.this , 0 , intent, 0);
- Intent intent = new Intent(AlarmController.this, OneShotAlarm.class);
- PendingIntent sender = PendingIntent.getBroadcast(AlarmController.this, 0, intent, 0);
getActivity
通过该函数获得的PendingIntent可以直 接启动新的activity, 就像调用 Context.startActivity(Intent)一样.
不过值得注意的是要想这个新的Activity不再是当前进程存在的Activity 时。我们在intent中必须使用Intent.FLAG_ACTIVITY_NEW_TASK.
- // The PendingIntent to launch our activity if the user selects this notification
- PendingIntent contentIntent = PendingIntent.getActivity(this , 0 , new Intent( this, AlarmService. class ), 0 );
- // The PendingIntent to launch our activity if the user selects this notification
- PendingIntent contentIntent = PendingIntent.getActivity(this, 0, new Intent(this, AlarmService.class), 0);
getService
通过该函数获得的PengdingIntent可以直接启动新的Service,就像调用Context.startService()一样。
- // Create an IntentSender that will launch our service, to be scheduled
- // with the alarm manager.
- mAlarmSender = PendingIntent.getService(AlarmService.this ,
- 0 , new Intent(AlarmService. this , AlarmService_Service. class ), 0);
2、编写界面:直接修改layout中的main.xml文件,代码如下:
- <?xml version="1.0" encoding="utf-8"?>
- <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
- android:orientation="vertical"
- android:layout_width="fill_parent"
- android:layout_height="fill_parent"
- android:gravity="center_vertical"
- >
- <Button
- android:id="@+id/timeBtn"
- android:layout_width="fill_parent"
- android:layout_height="wrap_content"
- android:text="@string/time"
- android:textSize="20sp"
- />
- <Button
- android:id="@+id/cancelAlarmBtn"
- android:layout_width="fill_parent"
- android:layout_height="wrap_content"
- android:text="@string/cancelAlarm"
- />
- </LinearLayout>
- timeBtn.setOnClickListener(new Button.OnClickListener(){
- @Override
- public void onClick(View arg0) {
- Log.d(TAG, "click the time button to set time");
- calendar.setTimeInMillis(System.currentTimeMillis());
- new TimePickerDialog(Alarm.this,new TimePickerDialog.OnTimeSetListener() {
- @Override
- public void onTimeSet(TimePicker arg0, int h, int m) {
- //更新按钮上的时间
- timeBtn.setText(formatTime(h,m));
- //设置日历的时间,主要是让日历的年月日和当前同步
- calendar.setTimeInMillis(System.currentTimeMillis());
- //设置日历的小时和分钟
- calendar.set(Calendar.HOUR_OF_DAY, h);
- calendar.set(Calendar.MINUTE, m);
- //将秒和毫秒设置为0
- calendar.set(Calendar.SECOND, 0);
- calendar.set(Calendar.MILLISECOND, 0);
- //建立Intent和PendingIntent来调用闹钟管理器
- Intent intent = new Intent(Alarm.this,AlarmReceiver.class);
- PendingIntent pendingIntent = PendingIntent.getBroadcast(Alarm.this, 0, intent, 0);
- //获取闹钟管理器
- AlarmManager alarmManager = (AlarmManager)getSystemService(ALARM_SERVICE);
- //设置闹钟
- alarmManager.set(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(), pendingIntent);
- alarmManager.setRepeating(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(), 10*1000, pendingIntent);
- Toast.makeText(Alarm.this, "设置闹钟的时间为:"+String.valueOf(h)+":"+String.valueOf(m), Toast.LENGTH_SHORT).show();
- Log.d(TAG, "set the time to "+formatTime(h,m));
- }
- },calendar.get(Calendar.HOUR_OF_DAY),calendar.get(Calendar.MINUTE),true).show();
- }
- });
代码里面有注释,这里就不多解释了,其中new TimePickerDialog为创建时间选择对话框。为了能够看到效果,我给闹钟添加了重复提醒:alarmManager.setRepeating(AlarmManager.RTC_WAKEUP, calendar.getTimeInMillis(), 10*1000, pendingIntent);。
还要为取消闹钟按钮添加事件监听器:
- //取消闹钟按钮事件监听
- final Button cancelAlarmBtn = (Button)findViewById(R.id.cancelAlarmBtn);
- cancelAlarmBtn.setOnClickListener(new Button.OnClickListener(){
- @Override
- public void onClick(View arg0) {
- Intent intent = new Intent(Alarm.this,AlarmReceiver.class);
- PendingIntent pendingIntent = PendingIntent.getBroadcast(Alarm.this, 0, intent, 0);
- //获取闹钟管理器
- AlarmManager alarmManager = (AlarmManager)getSystemService(ALARM_SERVICE);
- alarmManager.cancel(pendingIntent);
- Toast.makeText(Alarm.this, "闹钟已经取消!", Toast.LENGTH_SHORT).show();
- }
- });
在点击取消闹钟按钮时,取消之前设置的闹钟,核心代码就4行。
4、编写广播接收器,用来接收闹钟的广播事件,然后进行相关处理,
- public class AlarmReceiver extends BroadcastReceiver {
- /* (non-Javadoc)
- * @see android.content.BroadcastReceiver#onReceive(android.content.Context, android.content.Intent)
- */
- @Override
- public void onReceive(Context arg0, Intent data) {
- Log.d(Alarm.TAG, "the time is up,start the alarm...");
- Toast.makeText(arg0, "闹钟时间到了!", Toast.LENGTH_SHORT).show();
- }
- }
这个代码就很简单了,主要是要继 承 BroadcastReceiver 这个类,然后重写onRecive方法。onRecive方法在闹钟的时间达到之后会执行,在这里我们可以做自己的事情,比如启动某个程序,或者播放铃声,我这里就是简单的提示一下,使用的是Toast。
5、在android的AndroidManifest.xml文件中注册广播接收器:
- <manifest xmlns:android="http://schemas.android.com/apk/res/android"
- package="com.ql.activity"
- android:versionCode="1"
- android:versionName="1.0">
- <application android:icon="@drawable/icon" android:label="@string/app_name">
- <receiver android:name=".AlarmReceiver" android:process=":remote" />
- <activity android:name=".Alarm"
- android:label="@string/app_name">
- <intent-filter>
- <action android:name="android.intent.action.MAIN" />
- <category android:name="android.intent.category.LAUNCHER" />
- </intent-filter>
- </activity>
- </application>
- <uses-sdk android:minSdkVersion="8" />
- </manifest>
核心的配置为<receiver android:name=".AlarmReceiver" android:process=":remote" />,
这也是闹钟程序的关键,如果不做这个配置,那么时间到了之后,闹钟将不会提示。
到此为止,我们的小闹钟程序就结束了,接下来就是到模拟器上测试,运行截图如上图。程序源代码见附件。