HarmonyOS鸿蒙Next现在是否可以获取通话记录？

小伙伴你好，可以通过 contact.selectContacts API 来调起系统联系人选择器，让用户选择联系人。

详细说明

使用 contact.selectContacts 调起联系人选择器

方案说明：HarmonyOS Contacts Kit 提供了 selectContacts 接口，可以调起系统联系人列表界面供用户选择联系人，返回所选联系人数据。使用 Picker 的好处是只需用户选择，无需在应用内部申请高敏权限读取所有联系人数据。详细使用指南请参考：使用 picker 选择联系人。

实现步骤：

1. 导入 contact 模块

导入语句：

import { contact } from '@kit.ContactsKit';
import { BusinessError } from '@kit.BasicServicesKit';

说明：在 HarmonyOS Next API 10+ 中，推荐使用 @kit.ContactsKit 导入方式。如果使用 API 9 及以下版本，可以使用 import contact from '@ohos.contact' 方式。

2. 调用 selectContacts 接口

代码示例：

回调方式：

/**
 * 选择单个联系人
 * 
 * @param callback 选择完成后的回调函数
 */
function selectSingleContact(callback: (contacts: Array<contact.Contact>) => void): void {
  contact.selectContacts(
    { isMultiSelect: false },
    (err: BusinessError, data: Array<contact.Contact>) => {
      if (err) {
        console.error(`selectContacts callback: err code = ${err.code}, message = ${err.message}`);
        return;
      }
      console.info(`selectContacts callback: success, data = ${JSON.stringify(data)}`);
      callback(data);
    }
  );
}

Promise 方式：

/**
 * 选择多个联系人
 * 
 * @returns Promise<Array<Contact>> 返回选中的联系人数组
 */
async function selectMultipleContacts(): Promise<Array<contact.Contact>> {
  try {
    const contacts = await contact.selectContacts({ isMultiSelect: true });
    console.info(`selectContacts success, data = ${JSON.stringify(contacts)}`);
    return contacts;
  } catch (err) {
    const be = err as BusinessError;
    console.error(`selectContacts failed: code = ${be.code}, message = ${be.message}`);
    throw err;
  }
}

完整组件示例：

import { contact } from '@kit.ContactsKit';
import { BusinessError } from '@kit.BasicServicesKit';

@ComponentV2
struct ContactPickerPage {
  @State selectedContacts: Array<contact.Contact> = [];

  /**
   * 调起联系人选择器（单选）
   */
  selectContact(): void {
    contact.selectContacts(
      { isMultiSelect: false },
      (err: BusinessError, data: Array<contact.Contact>) => {
        if (err) {
          console.error(`选择联系人失败: code = ${err.code}, message = ${err.message}`);
          return;
        }
        this.selectedContacts = data;
        console.info(`已选择联系人: ${JSON.stringify(data)}`);
      }
    );
  }

  /**
   * 调起联系人选择器（多选）
   */
  async selectMultipleContacts(): Promise<void> {
    try {
      const contacts = await contact.selectContacts({ isMultiSelect: true });
      this.selectedContacts = contacts;
      console.info(`已选择 ${contacts.length} 个联系人`);
    } catch (err) {
      const be = err as BusinessError;
      console.error(`选择联系人失败: code = ${be.code}, message = ${be.message}`);
    }
  }

  build() {
    Column() {
      Button('选择单个联系人')
        .onClick(() => {
          this.selectContact();
        })
      
      Button('选择多个联系人')
        .onClick(() => {
          this.selectMultipleContacts();
        })
      
      if (this.selectedContacts.length > 0) {
        Text(`已选择 ${this.selectedContacts.length} 个联系人`)
          .margin({ top: 20 })
      }
    }
    .width('100%')
    .height('100%')
    .padding(20)
  }
}

关键 API 说明：

• contact.selectContacts(options, callback)：调起联系人选择器，支持回调方式
  • options: ContactSelectionOptions：选择器配置选项（必填）
  • callback: AsyncCallback<Array<Contact>>：回调函数，返回错误或联系人数组
• contact.selectContacts(options): Promise<Array>：调起联系人选择器，支持 Promise 方式
  • options?: ContactSelectionOptions：选择器配置选项（可选）
  • 返回 Promise<Array<Contact>>：成功时返回联系人数组，失败时抛出 BusinessError
• ContactSelectionOptions：选择器配置选项
  • isMultiSelect: boolean：是否支持多选，false 为单选，true 为多选

返回数据结构：

联系人对象（Contact）包含以下常用字段：

interface Contact {
  id: number;                    // 联系人ID
  key: string;                   // 联系人唯一标识
  name: {
    fullName: string;            // 全名
  };
  nickName?: {
    nickName: string;            // 昵称
  };
  phoneNumbers?: Array<{
    phoneNumber: string;         // 电话号码
    labelName: string;            // 标签名称（如"手机"、"工作"等）
    labelId: number;             // 标签ID
  }>;
  emails?: Array<{
    emailAddress: string;        // 邮箱地址
    labelName: string;
  }>;
  portrait?: {
    uri: string;                 // 头像URI
  };
  note?: {
    noteContent: string;         // 备注
  };
  organizations?: {
    name: string;                // 组织名称
  };
}

注意事项

• 权限说明：
  • 调起联系人 Picker 本身不需要预先申请读取联系人权限
  • 但如果要读取联系人详细信息（如电话号码、邮箱等），应用仍需在 module.json5 中声明 ohos.permission.READ_CONTACTS 权限
  • 对于写入操作（新增、修改、删除联系人），需要 ohos.permission.WRITE_CONTACTS 权限（system_basic 级别）
• API 版本差异：
  • selectContacts 从 API 10 开始支持，推荐使用
  • 注意检查应用的最低 API 版本要求
• 错误处理：
  • 主要错误包括参数错误、权限拒绝、用户取消选择等
  • 错误码可在回调的 BusinessError.code 中获取
  • 建议添加完整的错误处理逻辑
• 用户体验：
  • isMultiSelect 参数用于控制是否能选择多个联系人
  • 设为 false 时只能选择一个联系人
  • 设为 true 时支持多选
• 返回数据：
  • 返回的联系人数据可能受权限控制影响
  • 如果应用没有读取联系人权限，返回的数据可能不完整
  • 建议兼容权限被拒绝或返回数据不全的情况

参考文档

• contact API 参考
• 使用 picker 选择联系人
• 联系人管理概述

是无法获取到通话记录