更新记录

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 只注册一次,避免重复叠加监听。

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

读取用户从系统选择界面选中的单条电话号码及展示姓名(依赖系统返回 URI 的临时读权限,不声明 READ_CONTACTS)

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。