更新记录

2.0.0（2025-11-27）

1、支持鸿蒙NEXT;

1.0.2（2025-05-28）

1、优化接口;

1.0.1（2025-01-23）

2、添加 iOS 通讯录获取;

平台兼容性

uni-app(4.85)

uni-app x(4.85)

kaka-contacts

此插件用于获取设备通讯录信息.

所需权限：

Android

<uses-permission android:name="android.permission.READ_CONTACTS"/>

iOS

<key>NSContactsUsageDescription</key>
<string>访问通讯录</string>

使用

• 导入

  import {getContacts} from '@/uni_modules/kaka-contacts'

• 使用

  import {getContacts} from '@/uni_modules/kaka-contacts'
  export default {
  data() {
      return {
          contacts: []
      }
  },
  methods: {
      getContactsInfo() {
          getContacts({
              onSuccess: (contact) => {
                  console.log("onSuccess: ", contact);
                  this.contacts.push(contact);
              },
              onFail: (msg) => {
                  console.log("onFail: ", msg);
              }
          });
      }
  }
  }

通讯录信息说明

获取到的信息为 Contacts 对象,Contacts 信息如下：

/// 联系人
export type Contacts = {
    contactName: string,        // 联系人名称
    phoneNumbers: string[]  // 手机号,可能多个
}