鸿蒙ArkTS开发：微信/系统来电通话监听功能实现

本文将介绍如何在鸿蒙应用中使用ArkTS实现通话监听和录音功能，利用`harmony-utils`工具库简化开发流程。

工具库地址

一、功能概述

本实现包含以下核心功能：

通话状态监听：检测来电、去电和通话中状态
音频流监控：通过麦克风使用情况判断是否在通话
权限管理：动态申请麦克风和通话记录权限
状态管理：15秒宽限期后执行锁定操作

二、完整实现代码

import { PermissionUtil, ToastUtil } from "@pura/harmony-utils";
import { audio } from "@kit.AudioKit";
import { call, observer } from "@kit.TelephonyKit";@Entry
@Component
struct CallMonitorPage {private stillTalking: boolean = false; // 是否在通话中aboutToDisappear() {// 释放资源let am = audio.getAudioManager();let audioStreamManager = am.getStreamManager();audioStreamManager.off('audioCapturerChange');observer.off('callStateChange')}// 检测到通话后的处理private hearPhone() {if (this.stillTalking) return;ToastUtil.showToast('检测到通话中，15秒后将锁定页面~');this.stillTalking = true;setTimeout(() => {if (this.stillTalking) {// 这里可以添加锁定页面的逻辑ToastUtil.showToast('页面已锁定，请结束通话后继续');}}, 15000);}// 申请录音监听权限async useAudioStreamManager() {// 1. 检查麦克风权限PermissionUtil.checkRequestPermissions("ohos.permission.MICROPHONE").then((res) => {if (!res) {// 2. 如果没有权限则申请PermissionUtil.requestPermissionOnSetting("ohos.permission.MICROPHONE").then((res) => {if (!res) {ToastUtil.showToast('请给予录音权限~');}this.onHear();});} else {this.onHear();}});// 3. 检查通话记录权限PermissionUtil.checkRequestPermissions("ohos.permission.READ_CALL_LOG").then(() => {// 4. 检查当前是否有通话if (call.getCallStateSync()) {this.hearPhone();}// 5. 监听主卡槽通话状态变化observer.on('callStateChange', { slotId: 0 }, (data) => {this.handleCallStateChange(data);});// 6. 监听副卡槽通话状态变化observer.on('callStateChange', { slotId: 1 }, (data) => {this.handleCallStateChange(data);});});}// 处理通话状态变化private handleCallStateChange(data) {// 来电状态if (data.state === 0) {this.stillTalking = false;return;}// 通话中状态（包括保持状态）if ([3].includes(data.state)) {this.hearPhone();}}// 监听音频流变化private onHear() {let am = audio.getAudioManager();let audioStreamManager = am.getStreamManager();// 检查当前是否有音频活动if (audioStreamManager.isActiveSync(0)) {this.hearPhone();}// 监听音频捕获变化audioStreamManager.on('audioCapturerChange', () => {setTimeout(() => {if (audioStreamManager.isActiveSync(0)) {// 通话中this.hearPhone();} else {this.stillTalking = false;}}, 500);});}build() {Column() {Button('开始监听通话').onClick(() => {this.useAudioStreamManager();}).margin(20).width('80%')}.width('100%').height('100%')}
}

其中系统来电采用observer.on('callStateChange'）监听，而微信来电使用audioStreamManager.on('audioCapturerChange'）有没有在录音来监听，理论其他APP也是可以监听到的

三、权限配置

在module.json5中添加以下权限声明：

json

{"module": {"requestPermissions": [{"name": "ohos.permission.MICROPHONE","reason": "需要录音权限"}]}
}

四、核心API说明

API	说明
`call.getCallStateSync()`	获取当前通话状态
`observer.on('callStateChange')`	监听通话状态变化
`audioStreamManager.isActiveSync(0)`	检测音频流是否活跃
`PermissionUtil.checkRequestPermissions()`	检查并申请权限
`PermissionUtil.requestPermissionOnSetting()`	二次申请权限

五、通话状态值说明

值
-1	无效状态，当获取呼叫状态失败时返回。
0	表示没有正在进行的呼叫。
1	表示来电正在振铃或等待。
2	表示至少有一个呼叫处于拨号、通话中或呼叫保持状态，并且没有新的来电振铃或等待。
3	表示来电已经接听。