综述
这个类提供了一种使用系统提供的alarm服务。这个服务同意用户安排他们的应用程序在将来的某一个时间点执行。当设置的alarm响起,那么之前系统为这个alarm注冊的Intent就会自己主动的执行目标应用程序(假设此时应用程序还没有执行)。即使在系统处于休眠状态时(假设在此期间alarm响起,那么就会唤醒设备),系统注冊的alarm依然保持,可是当alarm被关闭或者是系统重新启动后,之前设置的alarm就会被清除。
在alarm的接收者的onReceive()方法运行的过程中,Alarm Manager就会持有一个CPU的锁(wake lock),这样就行确保在处理alarm broadcast的操作运行完毕之前系统不会进入休眠状态。一旦onReceive()方法运行完毕后,Alarm Manager就会释放持有的锁。这意味着,在某些情况下,一旦你的onReceive(0方法运行完毕后,系统有可能马上进入休眠状态。假设你的alarm的接收者调用Context.startService()方法启动一个服务,那么系统还是有可能在启动这项服务之前就进入休眠状态。为了防址这样的情况发生,你的BroadcastReceiver和Service须要实现一个独立的wake
lock策略来确保系统在完毕启动这项服务之前一直处于执行状态。
注意:Alarm Manager的意图是实现安排你的应用程序在某个特定的时刻执行,即使你的应用此刻并没有执行。对于一般的时间操作(比如:ticks、timeouts等等),使用Handler将会更加的简单和高效。
你不应该直接实例化这个类,取而代之的是通过例如以下方式获取:
Context.getSystemService(Context.ALARM_SERVICE)
经常使用的方法例如以下:
set()方法是设置在某个时间运行,有三个參数:第一个是alarm的类型,主要有下面几种类型:
ELAPSED_REALTIME, ELAPSED_REALTIME_WAKEUP, RTC or RTC_WAKEUP,这个大家看文档就知道了。
第二个參数是:第二个是alarm触发的时间,这个值的设置和前面一个參数,也就是alarm的类型是有关的。
第三个參数是一个PendingIntent的对象,alarm通常是通过发出一个广播来实现的,所以应该定义一个PendingIntent来发出广播。
包括的常量例如以下图:
接下里我们就实现一个样例,通过一个button设置alarm,然后在设定的时间到后,就实现alarm的效果---显示一个toast,当然也能够通过一个button取消设置的闹钟。
第一步:新建一个project,命名为alarmManager;
第二步:改动布局文件加入两个button,文件内容例如以下:
<?xml version="1.0" encoding="utf-8"?> <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android" android:layout_width="fill_parent" android:layout_height="fill_parent" android:orientation="vertical" > <TextView android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/hello" /> <Button android:id="@+id/set" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/set"/> <Button android:id="@+id/cancel" android:layout_width="fill_parent" android:layout_height="wrap_content" android:text="@string/cancel"/> </LinearLayout>
第四步:改动alarmManager.java文件,主要实现给两个button设置事件监听器,在当中主要实现alarm的广播的功能,当然还须要设置广播接收器,代码例如以下:
public class AlarmManagerActivity extends Activity { private Button setBtn, cancelBtn; /** Called when the activity is first created. */ @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.main); setBtn = (Button)findViewById(R.id.set); cancelBtn = (Button)findViewById(R.id.cancel); final AlarmManager am = (AlarmManager)this.getSystemService(ALARM_SERVICE); Intent intent = new Intent(); intent.setAction("com.maker.alarmManager.app.MY_ACTION"); intent.putExtra("msg", "闹钟事件发生了"); final PendingIntent pi = PendingIntent.getBroadcast(this, 0, intent, 0); final long time = System.currentTimeMillis(); setBtn.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { // TODO Auto-generated method stub am.setRepeating(AlarmManager.RTC_WAKEUP, time, 10*1000, pi); } }); cancelBtn.setOnClickListener(new View.OnClickListener() { @Override public void onClick(View v) { // TODO Auto-generated method stub am.cancel(pi); } }); } }
第五步:实现广播接收器,在这的代码就是闹钟事件发生后要实现的功能:显示一条toast,代码例如以下:
public class MyReceiver extends BroadcastReceiver { @Override public void onReceive(Context context, Intent intent) { String msg = intent.getStringExtra("msg"); Toast.makeText(context, msg, Toast.LENGTH_LONG).show(); } }
注意:实现了广播接收器MyReceiver,还要再project的AndroidManifest文件里进行声明。
第六步:执行程序,例如以下图。