uniapp获取用户手机通讯录手机号

admin 2026年02月24日 12:36 104 0

uniapp获取用户通讯录手机号需先获取用户授权，通过uni.choosePhoneContact接口选择联系人，回调函数中可获取联系人信息，包括手机号，需注意：iOS和Android平台对通讯录权限要求不同，需提前处理权限状态（如uni.getSetting检查），若未授权需引导用户在设置中开启，需遵循隐私政策，明确告知用户获取用途，避免敏感信息滥用，接口调用成功后，从回调对象的mobilePhoneNumber字段提取手机号，若用户取消选择则返回空，实际开发中需结合平台差异做兼容处理，确保功能稳定。

Uniapp 获取用户通讯录手机号：完整实现指南与关键注意事项

在开发社交、办公类移动应用时，获取用户通讯录手机号是一项常见且核心的需求，例如实现联系人同步、智能好友推荐、高效办公协作等功能，Uniapp 作为跨平台开发框架，提供了统一的 API 来调用设备原生能力，不同平台（iOS、Android、H5）对通讯录权限的管控机制存在显著差异，这给开发者带来了兼容性挑战，本文将详细阐述在 Uniapp 中获取用户通讯录手机号的完整实现流程，并重点解析权限配置、平台兼容性、隐私合规性等关键问题，助您安全、高效地集成此功能。

前置准备：通讯录权限的合规性要求（重中之重）

在着手开发之前，必须明确并严格遵守以下核心原则：获取用户通讯录属于高度敏感权限，其处理必须严格遵守各平台隐私政策、国家法律法规（如《个人信息保护法》）以及行业最佳实践，无论目标平台是 iOS、Android 还是 H5,均需满足以下硬性要求：

明确告知用途，获取单独同意：在申请权限前，必须以清晰、显著的方式向用户明确说明获取通讯录的具体目的（如“用于添加好友”、“同步联系人到通讯录”、“智能推荐可能认识的人”等）。**强烈建议**通过弹窗等用户主动交互的方式，单独就通讯录权限的获取取得用户的明确授权（“单独同意”）,而非笼统地包含在整体用户协议中。
遵循最小必要原则：仅获取实现功能所必需的信息（如手机号码）。**严禁**过度收集联系人姓名、邮箱、地址、头像等其他非必要数据，在代码层面，应通过 API 参数（如 `fields`）精确指定所需字段。
提供便捷的关闭与清除机制：应用内必须提供清晰、易于访问的入口，允许用户随时在设置中关闭通讯录权限，应提供选项让用户能够清除已从其通讯录中获取的数据（如已同步的联系人）,并确保在权限关闭后不再尝试访问或使用相关数据。

法律合规提示：根据《中华人民共和国个人信息保护法》等相关法规，处理通讯录这类敏感个人信息，必须取得个人的“单独同意”，建议在应用内嵌入清晰、易读的隐私政策，详细说明通讯录数据的收集范围、使用目的、存储期限、共享对象以及用户权利（访问、更正、删除、撤回同意等）。

Uniapp 获取通讯录手机号的实现步骤

Uniapp 中获取通讯录主要依赖 `uni.getContacts` API（**注意**：部分非常旧版本的 Uniapp 可能使用 `uni.getAddressBook`，请务必查阅最新官方文档确认）,以下是完整的实现流程与关键细节：

第一步：配置 manifest.json 文件（权限声明基础）

不同平台对通讯录权限的配置方式差异巨大，必须在 `manifest.json` 文件中为各目标平台添加正确的权限声明：

（1）Android 平台

在 `manifest.json` 的 `app-plus` -> `android` 节点下，添加必要的通讯录读写权限（根据需求选择）：

"app-plus": {
  "android": {
    "permissions": [
      "<uses-permission android:name=\"android.permission.READ_CONTACTS\"/>", // 读取通讯录权限（必需）
      "<uses-permission android:name=\"android.permission.WRITE_CONTACTS\"/>" // 写入通讯录权限（如需保存新联系人，需添加）
    ]
  }
}

（2）iOS 平台

在 `manifest.json` 的 `app-plus` -> `distribute` -> `apple` -> `capabilities` 节点下，必须启用“Contacts”（通讯录）能力，并配置 `Privacy - Contacts Usage Description`（向用户说明用途的描述文本）：

"app-plus": {
  "distribute": {
    "apple": {
      "capabilities": {
        "Contacts": {
          "description": "需要访问您的通讯录，用于同步联系人信息并推荐好友"
        }
      }
    }
  }
}

（3）H5 平台

H5 端获取通讯录主要依赖浏览器原生 API（如 `navigator.contacts`），但**兼容性极差**，仅部分移动浏览器（如较新版本的 Chrome for Android）可能支持，且通常需要用户手动在浏览器设置中提前授权。**Uniapp 对 H5 端通讯录的支持非常有限且不稳定**。**强烈建议**：如果应用核心功能依赖通讯录访问，应优先考虑开发 App 端（iOS/Android），H5 端可作为辅助或放弃此功能。

第二步：申请通讯录权限（动态授权时机）

**关键点**：iOS 系统严格限制权限申请必须在用户主动触发的操作（如点击按钮）中发起，无法在应用启动时自动申请，最佳实践是在用户明确触发需要通讯录功能时（如点击“同步通讯录”、“查找好友”按钮）再调用权限申请 API。

Uniapp 提供了 `uni.authorize` API 用于动态申请权限,以下是封装好的权限申请函数示例：

// 封装申请通讯录权限函数
async function requestContactsPermission() {
  try {
    // 尝试申请权限（iOS/Android App端）
    await uni.authorize({
      scope: 'scope.writeContacts' // 申请写入通讯录权限（如仅需读取，使用 'scope.readContacts'）
    });
    console.log('通讯录权限授权成功');
    getContacts(); // 权限成功后，执行获取联系人操作
    return true;
  } catch (err) {
    console.error('通讯录权限授权失败:', err);
    // 权限被拒绝或未授权，引导用户手动开启
    uni.showModal({
      title: '需要通讯录权限',
      content: '为了同步联系人/推荐好友，需要访问您的通讯录，是否前往设置开启权限？',
      confirmText: '去设置',
      cancelText: '取消',
      success: (res) => {
        if (res.confirm) {
          uni.openSetting(); // 打开应用设置页
        }
      }
    });
    return false;
  }
}
// 在用户点击按钮时调用
document.getElementById('syncContactsBtn').addEventListener('click', () => {
requestContactsPermission();
});