1、AlarmManager,顾名思义,就是“提醒”,是Android中常用的一种系统级别的提示服务,在特定的时刻为我们广播一个指定的PendingIntent。通俗点,就是设置一个时间,在指定的时间里,Alarm会帮我们执行PendingIntent里的广播。
2、AlarmManager的常用方法有三个:
(1)set(int type,long startTime,PendingIntent pi);
该方法用于设置一次性闹钟,第一个参数表示闹钟类型,第二个参数表示闹钟执行时间,第三个参数表示闹钟响应动作。
(2)setRepeating(int type,long startTime,long intervalTime,PendingIntent pi);
该方法用于设置重复闹钟,第一个参数表示闹钟类型,第二个参数表示闹钟首次执行时间,第三个参数表示闹钟两次执行的间隔时间,第三个参数表示闹钟响应动作。
(3)setInexactRepeating(int type,long startTime,long intervalTime,PendingIntent pi);
该方法也用于设置重复闹钟,与第二个方法相似,不过其两个闹钟执行的间隔时间不是固定的而已。
3、三个方法各个参数详悉:
(1)int type: 闹钟的类型,常用的有5个值:AlarmManager.ELAPSED_REALTIME、 AlarmManager.ELAPSED_REALTIME_WAKEUP、AlarmManager.RTC、 AlarmManager.RTC_WAKEUP、AlarmManager.POWER_OFF_WAKEUP。
AlarmManager.ELAPSED_REALTIME表示闹钟在手机睡眠状态下不可用,该状态下闹钟使用相对时间(相对于系统启动开始),状态值为3;
AlarmManager.ELAPSED_REALTIME_WAKEUP表示闹钟在睡眠状态下会唤醒系统并执行提示功能,该状态下闹钟也使用相对时间,状态值为2;
AlarmManager.RTC表示闹钟在睡眠状态下不可用,该状态下闹钟使用绝对时间,即当前系统时间,状态值为1;
AlarmManager.RTC_WAKEUP表示闹钟在睡眠状态下会唤醒系统并执行提示功能,该状态下闹钟使用绝对时间,状态值为0;
AlarmManager.POWER_OFF_WAKEUP表示闹钟在手机关机状态下也能正常进行提示功能,所以是5个状态中用的最多的状态之一,该状态下闹钟也是用绝对时间,状态值为4;不过本状态好像受SDK版本影响,某些版本并不支持;
(2)long startTime: 闹钟的第一次执行时间,以毫秒为单位,可以自定义时间,不过一般使用当前时间。需要注意的是,本属性与第一个属性(type)密切相关,如果第一个参数对 应的闹钟使用的是相对时间(ELAPSED_REALTIME和ELAPSED_REALTIME_WAKEUP),那么本属性就得使用相对时间(相对于 系统启动时间来说),比如当前时间就表示为:SystemClock.elapsedRealtime();如果第一个参数对应的闹钟使用的是绝对时间 (RTC、RTC_WAKEUP、POWER_OFF_WAKEUP),那么本属性就得使用绝对时间,比如当前时间就表示 为:System.currentTimeMillis()。
(3)long intervalTime:对于后两个方法来说,存在本属性,表示两次闹钟执行的间隔时间,也是以毫秒为单位。
(4)PendingIntent pi: 绑定了闹钟的执行动作,比如发送一个广播、给出提示等等。PendingIntent是Intent的封装类。需要注意的是,如果是通过启动服务来实现闹钟提 示的话,PendingIntent对象的获取就应该采用Pending.getService(Context c,int i,Intent intent,int j)方法;如果是通过广播来实现闹钟提示的话,PendingIntent对象的获取就应该采用 PendingIntent.getBroadcast(Context c,int i,Intent intent,int j)方法;如果是采用Activity的方式来实现闹钟提示的话,PendingIntent对象的获取就应该采用 PendingIntent.getActivity(Context c,int i,Intent intent,int j)方法。如果这三种方法错用了的话,虽然不会报错,但是看不到闹钟提示效果。
现在来讲解下代码:
我们需要获取到闹钟管理器的权限,以下代码:
AlarmManager am = (AlarmManager) getSystemService(Context.ALARM_SERVICE);
接着我们需要制定一个时间:
Calendar cal = Utils.getTimeAfterInSecs(30);//延时30秒执行
getTimeAfterInSecs代码:
public static Calendar getTimeAfterInSecs(int s){
Calendar cd = Calendar.getInstance();
cd.add(Calendar.SECOND,s);
return cd;
}
接着我们指定一个Intent:
Intent intent = new Intent(this,TestReceiver.class);
intent.putExtra("msg", "测试一个闹钟,时间是:" + Utils.getDateTimeString(cal));
同时发送一条消息,如果是开发,我们可以发送我们需要的业务数据就可以了;
然后我们申明一个PendingIntent:
PendingIntent pi = PendingIntent.getBroadcast(this,1,intent,0);
第一个参数是上下文对象,第二个是请求码,如果有多个闹钟,一定要区分好请求码;
最后我们创一个闹钟:
am.set(AlarmManager.RTC_WAKEUP, cal.getTimeInMillis(), pi);
如果是重复闹钟:
am.setRepeating(AlarmManager.RTC_WAKEUP,cal.getTimeInMillis(),5*1000,pi);
以下我将贴出所以代码;
MainAcitivity的代码:
package com.lanxin.testalarm;
import android.app.AlarmManager;
import android.app.PendingIntent;
import android.content.Context;
import android.content.Intent;
import android.os.Bundle;
import android.support.v7.app.AppCompatActivity;
import android.support.v7.widget.Toolbar;
import android.util.Log;
import android.view.View;
import android.view.Menu;
import android.view.MenuItem;
import android.widget.Button;
import java.util.Calendar;
public class MainActivity extends AppCompatActivity {
private static final String TAG = "AlarmLog";
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_main);
Toolbar toolbar = (Toolbar) findViewById(R.id.toolbar);
setSupportActionBar(toolbar);
Button button = (Button)findViewById(R.id.button);
Button button2 = (Button)findViewById(R.id.button2);
button.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
init();
}
});
button2.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
init2();
}
});
}
private void init() {
AlarmManager am = (AlarmManager) getSystemService(Context.ALARM_SERVICE);
Calendar cal = Utils.getTimeAfterInSecs(30);
Log.i(TAG, Utils.getDateTimeString(cal));
Log.i(TAG, Utils.getNowTime());
Intent intent = new Intent(this,TestReceiver.class);
intent.putExtra("msg", "测试一个闹钟,时间是:" + Utils.getDateTimeString(cal));
PendingIntent pi = PendingIntent.getBroadcast(this,1,intent,0);
am.set(AlarmManager.RTC_WAKEUP, cal.getTimeInMillis(), pi);
}
private void init2() {
AlarmManager am = (AlarmManager) getSystemService(Context.ALARM_SERVICE);
Calendar cal = Utils.getTimeAfterInSecs(30);
Calendar cal2 = Utils.getTimeAfterInSecs(15);
Log.i(TAG, Utils.getNowTime());
Intent intent = new Intent(this,TestReceiver.class);
intent.putExtra("msg", "测试一个闹钟,时间是:" + Utils.getDateTimeString(cal));
PendingIntent pi = PendingIntent.getBroadcast(this,1,intent,0);
Intent intent2 = new Intent(this,TestReceiver2.class);
intent2.putExtra("msg", "测试一个闹钟,时间是:" + Utils.getDateTimeString(cal2));
PendingIntent pi2 = PendingIntent.getBroadcast(this,2,intent2,0);
am.set(AlarmManager.RTC_WAKEUP, cal.getTimeInMillis(), pi);
// am.set(AlarmManager.RTC_WAKEUP, cal2.getTimeInMillis(), pi);
am.setRepeating(AlarmManager.RTC_WAKEUP,cal2.getTimeInMillis(),5*1000,pi2);
am.cancel(pi2);
}
@Override
public boolean onCreateOptionsMenu(Menu menu) {
// Inflate the menu; this adds items to the action bar if it is present.
getMenuInflater().inflate(R.menu.menu_main, menu);
return true;
}
@Override
public boolean onOptionsItemSelected(MenuItem item) {
// Handle action bar item clicks here. The action bar will
// automatically handle clicks on the Home/Up button, so long
// as you specify a parent activity in AndroidManifest.xml.
int id = item.getItemId();
//noinspection SimplifiableIfStatement
if (id == R.id.action_settings) {
return true;
}
return super.onOptionsItemSelected(item);
}
}
Receiver类的代码:
package com.lanxin.testalarm;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.util.Log;
/**
* Created by Administrator on 2016/6/13 0013.
*/
public class TestReceiver extends BroadcastReceiver {
private static final String TAG = "TestReceiverLog";
@Override
public void onReceive(Context context, Intent intent) {
Log.i(TAG, Utils.getNowTime());
Log.i(TAG,"Intent:"+intent);
String str = intent.getStringExtra("msg");
Log.i(TAG,"msg:"+str);
}
}