Blog

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);
    }
}