Android Alarm

AlarmManager

  AlarmManager,顾名思义,就是“提醒”,是Android中常用的一种系统级别的提示服务,在特定的时刻发出一个PendingIntent。简单的说就是我们设定一个时间,然后在该时间到来时,AlarmManager为我们广播、开始活动或者开启服务。通常我们使用 PendingIntent,PendingIntent可以理解为Intent的封装包,简单的说就是在Intent上在加个指定的动作。在使用Intent的时候,我们还需要在执行startActivity、startService或sendBroadcast才能使Intent有用。而PendingIntent的话就是将这个动作包含在内了。

alarm类型

  • RTC_WAKEUP

  表示闹钟在睡眠状态下会唤醒系统并执行提示功能,该状态下闹钟使用绝对时间。

  • RTC

  表示闹钟在睡眠状态下不可用,该状态下闹钟使用绝对时间,即当前系统时间。

  • ELAPSED_REALTIME_WAKEUP

  表示闹钟在睡眠状态下会唤醒系统并执行提示功能,该状态下闹钟也使用相对时间

  • ELAPSED_REALTIME

  表示闹钟在手机睡眠状态下不可用,该状态下闹钟使用相对时间(相对于系统启动开始)

  • POWER_OFF_WAKEUP【Android4.0之后没有了】

  表示闹钟在手机关机状态下也能正常进行提示功能,所以是5个状态中用的最多的状态之一,该状态下闹钟也是用绝对时间

RTC和ELAPSED_REALTIME的区别

  RTC表示的是绝对时间,而ELAPSED_REALTIME表示的是时间流,RTC可以通过修改手机时间触发闹钟事件,而ELAPSED_REALTIME必须通过真实时间的流逝,即使在休眠状态,时间也会被计算。

AlarmManager的常用方法

set(int type,long startTime,PendingIntent operation);

  该方法用于设置一次性闹钟,第一个参数表示闹钟类型,第二个参数表示闹钟执行时间,第三个参数表示闹钟响应动作。

setRepeating(int type,long startTime,long intervalTime,PendingIntent operation);【精准的重复】

  该方法用于设置重复闹钟,第一个参数表示闹钟类型,第二个参数表示闹钟首次执行时间,第三个参数表示闹钟两次执行的间隔时间,第三个参数表示闹钟响应动作。

setInexactRepeating(int type,long startTime,long intervalTime,PendingIntent operation);【模糊的的重复】

  该方法也用于设置重复闹钟,与第二个方法相似,不过其两个闹钟执行的间隔时间不是固定的而已。

cancel(PendingIntent operation)

  该方法用户端是调用AlarmManager对象的cancel()函数来取消alarm的。

注意,在取消alarm时,是以一个PendingIntent对象作为参数的。
这个PendingIntent对象正是当初设置alarm时,所传入的那个operation参数。
我们不能随便创建一个新的PendingIntent对象来调用remove()函数,否则remove()是不会起作用的。

setRepeating和setInexactRepeating的区别

  setRepeating是精准的重复时间,而setInexactRepeating是大概的重复时间,一般情况下使用setInexactRepeating,因为可以省电。

各种参数详解

  • int type

  闹钟的类型

  • long startTime:

  闹钟的第一次执行时间,以毫秒为单位,可以自定义时间,不过一般使用当前时间。需要注意的是,本属性与第一个属性(type)密切相关,如果第一个参数对应的闹钟使用的是相对时间(ELAPSED_REALTIME和ELAPSED_REALTIME_WAKEUP),那么本属性就得使用相对时间(相对于系统启动时间来说),比如当前时间就表示为:SystemClock.elapsedRealtime();如果第一个参数对应的闹钟使用的是绝对时间(RTC、RTC_WAKEUP、POWER_OFF_WAKEUP),那么本属性就得使用绝对时间,比如当前时间就表示 为:System.currentTimeMillis()

  • long intervalTime

  对于后两个方法来说,存在本属性,表示两次闹钟执行的间隔时间,也是以毫秒为单位。

  • PendingIntent operation:

  绑定了闹钟的执行动作

AlarmManager还提供设置系统时间的功能。

public void setTime(long millis)

  设置系统时间的功能,需要android.permission.SET_TIME权限

public void setTimeZone(String tz)

  设置时区的功能,需要具有android.permission.SET_TIME_ZONE权限。

案例


package com.hzj163.myapp3;

import android.app.AlarmManager;
import android.app.PendingIntent;
import android.content.BroadcastReceiver;
import android.content.Context;
import android.content.Intent;
import android.content.IntentFilter;
import android.os.SystemClock;
import android.support.v7.app.AppCompatActivity;
import android.os.Bundle;
import android.view.Menu;
import android.view.MenuItem;
import android.widget.TextView;

import java.util.Calendar;

public class MainActivity extends AppCompatActivity {
    TextView textView2;
    AlarmManager alarmManager;
    PendingIntent pendingIntent;
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        textView2 = (TextView) findViewById(R.id.textView2);
        //注册广播
        IntentFilter intentFilter = new IntentFilter("com.hzj163.myapp3.MainActivity.b1");
        this.registerReceiver(broadcastReceiver, intentFilter);
        //获取闹钟服务对象
        alarmManager = (AlarmManager) this.getSystemService(Context.ALARM_SERVICE);
        //闹钟最少间隔需要在60秒以上
        //5分钟之后触发闹钟
        Calendar calendar = Calendar.getInstance();
        //SystemClock.elapsedRealtime()获取开机到现在的时间
        calendar.setTimeInMillis(SystemClock.elapsedRealtime());
        //5分钟之后开始闹钟
        calendar.add(Calendar.MINUTE, 5);
        //设置一个广播
        Intent intent = new Intent("com.hzj163.myapp3.MainActivity.b1");
        //发送广播
        pendingIntent = PendingIntent.getBroadcast(this, 1, intent, PendingIntent.FLAG_UPDATE_CURRENT);
        //只执行一次【ELAPSED类型】
        //alarmManager.set(AlarmManager.ELAPSED_REALTIME_WAKEUP,calendar.getTimeInMillis(),pendingIntent);
        //当前时间每隔80000秒执行一次【RTC类型】
        alarmManager.setRepeating(AlarmManager.RTC_WAKEUP, System.currentTimeMillis(), 80000, pendingIntent);
    }

    BroadcastReceiver broadcastReceiver = new BroadcastReceiver() {
        @Override
        public void onReceive(Context context, Intent intent) {
            textView2.setText("ddddhzj:" + System.currentTimeMillis());
        }
    };

    @Override
    protected void onDestroy() {
        //注销广播
        this.unregisterReceiver(broadcastReceiver);
        //结束闹钟
        alarmManager.cancel(pendingIntent);
        super.onDestroy();
    }

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