更新记录

1.1.1（2026-07-11）

更新插件使用说明

1.1.0（2026-07-11）

插件简介

aiko-call-recorder 是一款 Android UTS 原生插件，面向 uni-app / uni-app x 项目，提供系统通话录音获取、通话状态监听、通话记录、短信、通讯录、拨打接听挂断等能力。

本插件不自行录制通话音频，而是引导用户开启各厂商「通话自动录音」，在来电/去电/挂断时监听状态，挂断后从系统录音目录匹配并返回录音文件路径，并可按需自动或手动转码为标准 MP3/WAV/M4A。

适配品牌：华为、荣耀、小米、OPPO、vivo、一加、三星、魅族、联想、中兴等（机型与 ROM 差异较大，请真机验证）。

平台与运行要求

• 仅支持 App-Android（不支持 iOS / 小程序 / Web）
• 支持 uni-app（Vue2/Vue3、vue/nvue）与 uni-app x
• 需 HBuilderX 4.25+，修改原生代码后需制作自定义调试基座
• 付费插件云打包需 HBuilderX 3.7.2+，仅支持云端传统打包

引入方式

import * as module from '@/uni_modules/aiko-call-recorder'

统一回调结构：{ code: number, message: string, data: any }，code === 0 表示成功。

一、权限与环境

二、系统通话自动录音

三、通话状态监听

registerListener 状态码（data.status）

挂断（status=3）回调字段

四、拨打 / 接听 / 挂断

五、通话记录

六、短信

七、通讯录

八、录音文件与音频处理

convertAudio 参数说明

• fromFilename 或 path：源文件绝对路径
• toFilename：输出路径（不传则在同目录生成 *_converted.mp3/wav/m4a）
• format：目标格式，mp3（默认）/ wav / m4a

九、前台保活

推荐使用流程

1. requestPermissions 申请相关权限
2. checkAllFilesPermission / toAllFilesPermissionPage（Android 11+）
3. checkCallAutoRecorder / toCallAutoRecorderPage 开启系统通话自动录音
4. startForeground 提升后台存活（可选）
5. setAutoConvertConfig({ enable: true, format: 'mp3' }) 开启挂断自动转 MP3（可选）
6. registerListener 注册监听，挂断后读取 audioPath / convertedPath

权限声明

插件已在 AndroidManifest.xml 声明以下权限，请在应用隐私政策中说明用途：

电话状态 / 通话记录 / 拨打接听、麦克风（部分 ROM 要求）、存储 / 所有文件访问、短信读写发送、通讯录、通知 / 前台服务。

常见问题

1. 挂断后没有 audioPath：确认系统通话自动录音已开；Android 11+ 需所有文件访问权限；部分 ROM 录音落盘较慢。
2. 系统目录文件无法上传：先用 copyFile / moveFile 复制到应用可访问目录。
3. 锁屏后无回调：开启 startForeground，并按厂商要求打开自启动。
4. 录音格式无法播放：开启自动转 MP3，或手动调用 convertAudio。

合规提示

请遵守当地法律法规，录音前告知对方并取得同意。上架应用商店时请按商店政策申报敏感权限。

授权与加密

• utssdk/interface.uts 保留明文 API 声明
• utssdk/app-android/index.uts 及 Kotlin 混编文件上架后加密
• 联系 QQ：1074699502

历史版本

1.0.3 — 新增 setAutoConvertConfig / getAutoConvertConfig；挂断回调增加转码字段

1.0.2 — convertAudio 默认格式改为 MP3（LAME）

1.0.1 — 新增 convertAudio 音频格式转换

1.0.0 — 首发：通话/短信监听、系统录音检测与获取

平台兼容性

uni-app(4.23)

uni-app x(4.62)

aiko-call-recorder

Android 通话录音 / 电话短信监听 UTS 插件。

能力说明

本插件不自行录制通话音频，而是：

1. 引导用户开启各厂商「通话自动录音」
2. 监听来电 / 去电 / 挂断状态
3. 挂断后从系统录音目录匹配并返回录音文件路径
4. 提供通话记录、短信、通讯录、拨打/接听/挂断、文件复制移动、前台保活等配套能力

适配品牌：华为、荣耀、小米、OPPO、vivo、一加、三星、魅族、联想、中兴等（机型差异较大，请真机验证）。

仅支持

• App-Android
• uni-app / uni-app x

安装

将本插件放入项目 uni_modules/aiko-call-recorder，制作自定义调试基座后运行。

引入

import * as module from '@/uni_modules/aiko-call-recorder'

推荐使用流程

1. requestPermissions 申请电话/短信/存储等相关权限
2. checkAllFilesPermission / toAllFilesPermissionPage（Android 11+ 读取系统录音目录需要）
3. checkCallAutoRecorder / toCallAutoRecorderPage 开启系统通话自动录音
4. startForeground 提升锁屏后存活率（可配合保活方案）
5. registerListener 注册通话监听，挂断后 status=3 时读取 audioPath
6. （可选）setAutoConvertConfig({ enable: true, format: 'mp3' }) 开启挂断后自动转码

核心 API

统一回调结构

{
  "code": 0,
  "message": "",
  "data": {}
}

code === 0 表示成功。

registerListener 状态码

示例

// 开启：通话结束后自动转 MP3（配置会持久化）
module.setAutoConvertConfig({
  enable: true,
  format: 'mp3',
  outputDir: '/storage/emulated/0/aiko_call_recorder'
}, (res) => {
  console.log(res)
})

module.registerListener((res) => {
  console.log(res)
  // status=3 时：
  // data.audioPath 原始录音
  // data.convertedPath 自动转码结果（开启后才有）
  // data.converted / data.convertFormat / data.convertMessage
})

module.callPhone({ number: '10086', slot: 1 }, (res) => {
  console.log(res)
})

module.copyFile({
  fromFilename: '/storage/emulated/0/Sounds/CallRecord/xxx.m4a',
  toFilename: '/storage/emulated/0/aiko_call/xxx.m4a'
}, (res) => {
  console.log(res)
})

// 也可手动转换
module.convertAudio({
  fromFilename: '/storage/emulated/0/Sounds/CallRecord/xxx.amr',
  toFilename: '/storage/emulated/0/aiko_call/xxx.mp3',
  format: 'mp3'
}, (res) => {
  console.log(res)
})

自动转码回调字段（status=3）

权限

插件已在 AndroidManifest.xml 声明常用权限，请在应用隐私政策中说明用途。涉及：

• 电话状态 / 通话记录 / 拨打接听
• 麦克风（部分 ROM 要求）
• 存储 / 所有文件访问
• 短信读写发送
• 通讯录
• 通知 / 前台服务

常见问题

1. 挂断后没有 audioPath：先确认系统通话自动录音已开；Android 11+ 需所有文件访问权限；部分 ROM 录音落盘较慢。
2. 系统目录文件无法上传：先 copyFile / moveFile 到应用可访问目录再上传。
3. 锁屏后无回调：开启 startForeground，并按厂商要求打开自启动。
4. 录音格式无法播放：系统录音可能非标准封装，开启 setAutoConvertConfig 自动转 mp3，或手动调用 convertAudio。

合规提示

请遵守当地法律法规，录音前告知对方并取得同意。上架应用商店时请按商店政策申报敏感权限，勿滥用无障碍/通话能力。