包含获取通讯录、添加联系人、修改联系人、删除联系人、拨打电话、获取通话记录、添加通话记录、删除通话记录、获取短信记录、发送短信、获取电话号码运营商和归属地等功能。
所需权限
复制代码 <!-- 读写联系人权限 -->
<uses-permission android:name="android.permission.READ_CONTACTS"/>
<uses-permission android:name="android.permission.WRITE_CONTACTS"/>
<!--读写手机通话记录权限-->
<uses-permission android:name="android.permission.READ_CALL_LOG" />
<uses-permission android:name="android.permission.WRITE_CALL_LOG" />
<!-- 打电话 -->
<uses-permission android:name="android.permission.CALL_PHONE" />
<!--读写短信信息的权限-->
<uses-permission android:name="android.permission.READ_SMS" />
<uses-permission android:name="android.permission.RECEIVE_SMS"/>
<uses-permission android:name="android.permission.SEND_SMS" />
引入插件
复制代码const lunaContact = uni.requireNativePlugin("Luna-Contact");
1、权限接口
1.1 权限检查
复制代码checkPermissions({
permissionList:[], //见注释1，格式：["权限1","权限2"]，必填
},res=>{
console.log(res);
res={
"code":0,
"checked":true/false,
"message":"权限全部通过/有权限未通过",
"unPermissionList":[],//未通过权限列表
}
res={
"code":1,
"message":"权限检查失败：",
}
});
1.2 跳转到应用设置页面
复制代码getSettings();
2、联系人相关接口
在调用接口之前，请先获取相应的权限
2.1 获取联系人
复制代码getContacts({
type: 0, //见注释2，默认值0：查询全部的联系人，可选
param:"",//见注释2，默认值""，可选
},res=>{
console.log(res);
res={
"code": 0,
"message": "获取成功",
"data":"获取的数据"
}
data=[{
"id": "105", //id每个手机中生成的都不相同，即使是相同联系人
"name": "这是一个测试联系人",
"number": "18650246538"
"operator": "中国联通",
"address": "福建省莆田市",
},
......
]
res={
"code": 1,
"message": "获取失败",
}
})
2.2 添加联系人
每次调用，都会新增一条联系人记录
即使联系人姓名和电话号码都与已有记录相同，也会新增一条id不同的记录
可以通过【2.1获取联系人】接口查看详情
因为在一般的手机通讯里，姓名和号码相同时，只会显示一条记录，若姓名相同，号码不同，会显示两条记录
若想实现在同一个联系人姓名下，添加多个号码，可以配合使用【2.3修改联系人】接口
复制代码addContacts({
name:"", //姓名，必填
number:"",//号码，必填
},res=>{
console.log(res);
res={
"code": 0,
"message": "添加成功",
}
res={
"code": 1,
"message": "添加失败：",
}
})
2.3 修改联系人
复制代码editContacts({
id: "", // 联系人id，通过【2.1获取联系人】接口查询出，必填
name: "", // 姓名，原姓名或修改后的姓名，必填
addedNumbers: [], // 新增的号码，格式：["新增的号码1","新增的号码2"]，可选
deletedNumbers: [],// 删除的号码，格式：["删除的号码1","删除的号码2"]，可选
modifiedNumbers:[] // 修改的号码，格式：[{original:"原号码1",modified:"修改后的号码1"}]，可选
},res=>{
console.log(res);
res={
"code": 0,
"message": "修改成功"
}
res={
"code": 1,
"message": "修改失败"
}
res={
"code": 2,
"message": "没有查询到联系人数据",
}
})
2.4 删除联系人
复制代码deleteContacts({
type: 1, //见注释3，必填
param: "", //见注释3，必填
},res=>{
console.log(res);
res={
"code": 0,
"message": "删除成功",
}
res={
"code": 1,
"message": "删除失败",
}
res={
"code": 2,
"message": "没有查询到联系人数据",
}
})
2.5 拨打电话
复制代码callUp("电话号码")
2.6 获取电话号码运营商和归属地
复制代码getPhoneNumberInfo("电话号码",res=>{
console.log(res);
res={
"data": {
"operator": "中国移动", //运营商
"address": "北京" //归属地
}
}
})
3、通话记录相关接口
在调用接口之前，请先获取相应的权限
3.1 获取通话记录
复制代码getCallLogs({
type: 0, //见注释4，默认值0：查询全部的通话记录，可选
param:"",//见注释4，默认值""，可选
},res=>{
console.log(res);
res={
"code": 0,
"message": "获取成功",
"data":"获取的数据"
}
//type=0,1,2,3时，返回的data数据
data =[
{"id":"804",
"operator":"", //号码运营商，座机查不出
"address":"广东省云浮市", //号码归属地，座机号码带区号就可以查出，不带区号查不出
"count":0, //通话次数，插件内部没做查询，所以默认0
"number":"07668937564", //电话号码
"duration":0,//通话时长，单位秒
"type":5, //通话记录类型，见注释5
"date":"2022-06-25 17:05:44" //时间
},
......
]
//type=4时，返回的data数据（查询通话次数最多的电话号码及其次数，）
data={
"operator": "中国电信",
"type": 0, //无用参数
"address": "北京",
"name": "姓名",
"count": 67, //通话次数
"number": "号码",
"duration": 0 //无用参数
}
//type=5时，返回的data数据（查询通话时间最长的通话记录，）
data= {
"id": "363",
"name": "姓名",
"operator": "中国联通",
"address": "中国",
"count": 0, //通话次数，插件内部没做查询，所以默认0
"number": "号码",
"duration": 1662, //通话时长，单位秒
"type": 1, 通话记录类型，见注释5
"date": "2021-05-17 21:43:02" //来电时间
}
res={
"code": 1,
"message": "获取失败",
}
})
3.2 新增通话记录
复制代码addCallLogs({
name:"", //姓名，必填
number:"",//号码，必填
date: , //通话日期，长整型，单位毫秒，默认值：当前系统时间，可选
duration:60,//通话时长，长整型，单位秒，必填
type:1,//通话记录类型，整型，见注释5，必填
},res=>{
console.log(res);
res={
"code": 0,
"message": "添加成功",
}
res={
"code": 1,
"message": "添加失败：",
}
})
3.3 删除通话记录
复制代码deleteCallLogs({
type: "", //见注释6，必填
param: "", //见注释6，必填
},res=>{
console.log(res);
res={
"code": 0,
"message": "删除成功",
}
res={
"code": 1,
"message": "删除失败",
}
})
4、短信相关接口
读取和发送短信的权限无需单独请求，接口调用时会自动申请
4.1 获取短信记录
这个接口比较简单，查询结果也不全，一些不带区号的座机号码，或者虚拟号码发送的短信是查询不到的
复制代码getSMSLogs({
type: 0, //默认值0：查询全部的短信记录，可选，type无其他值
param:"",//默认值""，可选
},res=>{
console.log(res);
res={
"code": 0,
"message": "获取成功",
"data":"获取的数据"
}
data=[
{
"id": "1940",
"read": 1, //短信是否已读1:已读 0：未读
"number": "02163232056",
"type": 1, //短信类型，见注释7
"body": "短信内容",
"date": "2022-06-19 18:01:16"
}
]
res={
"code": 1,
"message": "获取失败",
}
})
4.2 发送短信
复制代码sendSMS({
numbers:[], //收件人号码，必填，格式：["收件人号码1","收件人号码2"]
body:"",//短信内容，必填，如果内容大于70字，会拆分为多条发送
},res=>{
console.log(res);
res={
"code": 0,
"message": "发送成功",
}
res={
"code": 1,
"message": "发送失败：",
}
})
注释
1 权限列表
| value | 说明 |
|---|---|
| android.permission.READ_CONTACTS | 读联系人权限 |
| android.permission.WRITE_CONTACTS | 写联系人权限 |
| android.permission.READ_CALL_LOG | 读通话记录权限 |
| android.permission.WRITE_CALL_LOG | 写通话记录权限 |
| android.permission.CALL_PHONE | 拨打电话权限 |
| android.permission.READ_SMS | 读短信权限 |
| android.permission.SEND_SMS | 发送短信权限 |
2 获取联系人
| type | type说明 | param | param说明 |
|---|---|---|---|
| 0 | 查询全部的联系人 | "" | 无需输入param值 |
| 1 | 根据id查询指定的联系人 | "id" | 输入查询到的联系人id值，严格匹配 |
| 2 | 根据姓名查询指定的联系人 | "姓名" | 输入联系人姓名，严格匹配 |
| 3 | 根据号码查询指定的联系人 | "号码" | 输入联系人号码，严格匹配 |
3 删除联系人
| type | type说明 | param | param说明 |
|---|---|---|---|
| 1 | 根据id删除指定的联系人 | "id" | 输入查询到的联系人id值，严格匹配 |
| 2 | 根据姓名删除指定的联系人 | "姓名" | 输入联系人姓名，严格匹配 |
| 3 | 根据号码删除指定的联系人 | "号码" | 输入联系人号码，严格匹配 |
4 获取通话记录
| type | type说明 | param | param说明 |
|---|---|---|---|
| 0 | 查询全部的通话记录 | "" | 无需输入param值 |
| 1 | 根据id查询指定的通话记录 | "id" | 输入查询到的通话记录id值，严格匹配 |
| 2 | 根据姓名查询指定的通话记录 | "姓名" | 输入姓名，严格匹配 |
| 3 | 根据号码查询指定的通话记录 | "号码" | 输入号码，严格匹配 |
| 4 | 获取通话次数最多的电话号码及其次数 | "" | 无需输入param值 |
| 5 | 获取通话时间最长的通话记录 | "" | 无需输入param值 |
5 通话记录类型
| type | 说明 |
|---|---|
| 1 | 来电 (呼入) |
| 2 | 拨出 (呼出) |
| 3 | 未接 |
| 4 | 语音邮件 |
| 5 | 已拒绝 (已挂断) |
6 删除通话记录
| type | type说明 | param | param说明 |
|---|---|---|---|
| 1 | 通过id删除通话记录 | "id" | 输入查询到的通话记录id值，严格匹配 |
| 2 | 通过姓名删除通话记录 | "姓名" | 输入姓名，严格匹配 |
| 3 | 通过电话号码删除通话记录 | "号码" | 输入号码，严格匹配 |
7 短信类型
| type | 说明 |
|---|---|
| 0 | 全部 |
| 1 | 收件箱 |
| 2 | 发送 |
| 3 | 草稿 |
| 4 | 发件箱 |
| 5 | 失败的 |
| 6 | 排队 |
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
