更新记录
1.0.3(2026-04-12)
下载此版本
- 号码去空白改为循环处理,避免 UTS 中
replace 仅去掉一处空格的问题
1.0.2(2026-04-12)
下载此版本
1.0.1(2026-04-12)
下载此版本
- 移除
READ_CONTACTS:改为 Phone.CONTENT_URI 选择 + 仅查询返回 URI 对应行
查看更多
平台兼容性
uni-app(5.0)
| Vue2 |
Vue3 |
Chrome |
Safari |
app-vue |
app-vue插件版本 |
app-nvue |
app-nvue插件版本 |
Android |
iOS |
鸿蒙 |
鸿蒙插件版本 |
| × |
× |
× |
× |
√ |
1.0.1 |
√ |
1.0.1 |
√ |
× |
17 |
1.0.1 |
| 微信小程序 |
支付宝小程序 |
抖音小程序 |
百度小程序 |
快手小程序 |
京东小程序 |
鸿蒙元服务 |
QQ小程序 |
飞书小程序 |
小红书小程序 |
快应用-华为 |
快应用-联盟 |
| × |
× |
× |
× |
× |
× |
× |
× |
× |
× |
× |
× |
uni-app x(5.0)
| Chrome |
Safari |
Android |
iOS |
鸿蒙 |
微信小程序 |
| - |
- |
- |
- |
- |
- |
xxq-contact
Android 端不声明、不申请 READ_CONTACTS。使用 Intent.ACTION_PICK + ContactsContract.CommonDataKinds.Phone.CONTENT_URI,由系统对返回的 content URI 授予临时读取权限,仅查询这一行得到姓名与号码。
行为说明
- 系统界面为「按电话条目选择」(同一联系人多条号码时可能显示多行),选中的结果在
phones 中通常为一条号码。
- 若某机型/ROM 未正确附带 URI 读权限导致查询失败,需自行评估是否改用其它方案(本插件按你的要求不包含
READ_CONTACTS)。
使用
import { xxqContact, pickContact } from '@/uni_modules/xxq-contact'
xxqContact.pickContact((res) => {
if (res.success) {
console.log(res.name, res.phones)
} else if (res.cancelled) {
console.log('用户取消')
} else {
console.log(res.message)
}
})
其它
- 同一时间仅允许一次进行中的选择。
onAppActivityResult 只注册一次,避免重复叠加监听。