前言
在上节我们已经学习了ContentResolver的使用，那么这节让我们来学习下ContentObserver的使用。ContentObserver主要用于实现短信监听。为了方便短信监听的调用，这里我封装了一个工具类——SmsMonitor。下面就来讲讲它的使用吧。
今天涉及内容：
- SmsMonitor使用场景
- SmsMonitor主要方法介绍
- 用户权限
- SmsMonitor 在 activity 中使用
- 效果图和项目结构图
- ContentObserver的onChange方法多次调用的处理办法
- SmsMonitor 源码
监听收到短信内容如下：
==电话号码: 18927563503 短信内容: 我是测试啊
一. SmsMonitor使用场景
SmsMonitor主要用于监听获取收到的短信的内容，所以特别适合用在接收短信验证码并自动填入输入框的场景。
二.SmsMonitor主要方法介绍
SmsMonitor作为一个单例类，我们主要使用到以下几个方法：
/***
* 初始化
*
* @param context
*/
public SmsMonitor init(Context context)
/***
* 注册短信接收监听(一般在点击"发送短信"按钮时注册)
*
* @param phoneNumber：phoneNumber为具体电话号码时表示只监听该号码短信
* phoneNumber表示监听所有短信
*
* @param listener: 监听得到的短信数据
*
*/
public void registerSmsObserver(String phoneNumber,OnSmsChangeListener listener)
/***
* 注销短信接收监听
*
* 注：一般在短信接收超时时注销
* 当然为了保证代码健壮性,在界面退出时也要调用
*/
public void unRegisterSmsObserver()
为了方便存放短信信息，我这里建了一个类SmsData，SmsData代码如下：
/**
* Title: 短信数据载体
*
* description:
* autor:pei
* created on 2021/3/2
*/
public class SmsData {
private String address;//短信号码
private String person;//人物
private String body;//信息
private String date;//时间
private String type;//类型
public String getAddress() {
return address;
}
public void setAddress(String address) {
this.address = address;
}
public String getPerson() {
return person;
}
public void setPerson(String person) {
this.person = person;
}
public String getBody() {
return body;
}
public void setBody(String body) {
this.body = body;
}
public String getDate() {
return date;
}
public void setDate(String date) {
this.date = date;
}
public String getType() {
return type;
}
public void setType(String type) {
this.type = type;
}
@Override
public String toString() {
return "SmsData{" +
"address='" + address + '\'' +
", person='" + person + '\'' +
", body='" + body + '\'' +
", date='" + date + '\'' +
", type='" + type + '\'' +
'}';
}
/**获得对象除date属性之外的数据**/
public String withOutDateToString() {
return "SmsData{" +
"address='" + address + '\'' +
", person='" + person + '\'' +
", body='" + body + '\'' +
", type='" + type + '\'' +
'}';
}
/**比较两个对象除date之外是否值相等**/
@Override
public boolean equals(@Nullable Object obj) {
if(obj!=null){
if(obj instanceof SmsData){
SmsData temp= (SmsData) obj;
if(temp.withOutDateToString().equals(this.withOutDateToString())){
return true;
}
}
}
return false;
}
}
三. 用户权限
SmsMonitor的使用需要在Androidmanifast.xml中添加以下权限：
<uses-permission android:name="android.permission.READ_SMS"/>
当然，你还需要添加Android 6.0+手动权限和FileProvider文件权限，具体可参考文章
PermissionsDispatcher动态权限申请kotlin版
接着需要添加FileProvider相关处理，大家可参考以下文章
SpUtil多样加密存储，兼容android9.0
四. SmsMonitor 在 activity 中使用
下面贴出SmsMonitor在TempActivity中使用代码：
public class TempActivity extends AppCompatActivity {
private TextView mTvTest;
private Button mBtnTest;
@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_temp);
//初始化控件
initView();
//初始化数据
initData();
//控件监听
setListener();
}
/**
* 初始化控件
**/
private void initView() {
mTvTest = findViewById(R.id.mTvTest);
mBtnTest = findViewById(R.id.mBtnTest);
}
private void initData() {
//初始化
SmsMonitor.getInstance().init(this);
}
/**
* 控件监听
**/
private void setListener() {
//发送短信验证
mBtnTest.setOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
ToastUtil.shortShow("发送短信");
//每次点击按钮注册一次短信监听
SmsMonitor.getInstance().registerSmsObserver(null, new SmsMonitor.OnSmsChangeListener() {
@Override
public boolean isAuthor(SmsData smsData) {
//设置接收短信内容的条件(如只接收信息内容中含"验证码"的信息)
String message=smsData.getBody();
if(StringUtil.isNotEmpty(message)&&message.contains("验证码")){
return true;
}
return false;
}
@Override
public void getSmsData(SmsData smsData) {
LogUtil.i("=============接收我要的数据==========");
//注:每次收到消息后都会注销短信监听
// 要想监听生效,则需下次重新注册监听
LogUtil.i("==电话号码: " + smsData.getAddress() + " 短信内容: " + smsData.getBody()+" 时间: "+smsData.getDate());
mTvTest.setText("电话号码: " + smsData.getAddress() + "\n短信内容: " + smsData.getBody());
}
});
}
});
}
@Override
protected void onDestroy() {
//注销短信接收的监听
SmsMonitor.getInstance().unRegisterSmsObserver();
super.onDestroy();
}
}
需要注意的是，接收短信的监听是在每次点击发送短信按钮时注册的，当接收到了我们需要的短信时，就会自动注销。下次要接收时，则需要重新注册。然后在isAuthor(SmsData smsData)方法中我们指定接收特定特征的短信息。程序退出时，别忘了调用注销方法。
五. 效果图和项目结构图
监听收到短信内容如下：
==电话号码: 18927563503 短信内容: 我是测试啊
项目结构图.png
六.ContentObserver的onChange方法多次调用的处理办法
在监听收到短信内容时，发现ContentObserver的onChange会重复调用。
对于这种现象，有几种处理办法，下面来逐个分析。
