更新记录

1.0.1（2026-06-12）

• 修复 Harmony 真机运行时报 lizhaoCallKit_utsProxy.onCallKitEvent is not a function 的问题。
• Harmony 平台入口补齐完整 API 占位导出、能力探测、权限状态和事件监听占位；不支持的 Android 高敏能力返回明确降级，不伪造成功。
• 同步升级 package.json 与 uni_modules.json 版本和插件市场描述。

平台兼容性

uni-app(4.84)

uni-app x(4.84)

lizhao-call-kit

lizhao-call-kit 是电话、短信、通讯录与通话录音文件扫描 UTS API 插件。Android 首版提供真实原生能力；iOS / Harmony / Web / 小程序提供能力探测和明确降级，不支持能力会触发 fail / complete，不会伪造成功。

支持平台

权限与自定义基座

Android 端涉及以下高敏权限：

通话录音不由插件直接录制。插件只检测系统/OEM 自动录音设置、跳转设置页、扫描录音文件，并按号码和时间与通话记录匹配。

API 列表

getCallKitCapabilities(options)

说明 获取当前平台能力矩阵。

支持平台 Android / iOS / Harmony / Web / 微信小程序 / 支付宝小程序

参数

返回值

checkPermissions(options) / requestPermissions(options)

说明 检查或请求 Android 权限。非 Android 平台返回降级说明。

参数

registerCallListener(options) / unregisterCallListener(options)

说明 注册或取消 Android 通话监听。监听事件通过 onCallKitEvent 返回。

参数

getCallLogs(options) / getCallLogsByFilter(options)

说明 读取 Android 通话记录，并可按号码、类型、时间过滤。

参数

dialPhone(options) / callPhone(options)

说明 打开系统拨号页或直接拨打电话。

参数

checkCallAutoRecorder(options) / openCallAutoRecorderSettings(options)

说明 检测常见系统/OEM 自动录音目录，或跳转可能的录音设置页。

参数

setRecorderDirectories(options) / getAllRecorderFiles(options) / searchRecorderFiles(options)

说明 配置录音扫描目录、读取全部录音文件或按条件搜索。

参数

matchCallRecordings(options)

说明 按号码片段和时间窗口匹配通话记录与录音文件。

参数

registerSmsListener(options) / getSmsList(options) / sendSmsSilent(options) / sendSmsIntent(options)

说明 Android 支持短信监听、短信读取和静默发送；多端支持系统短信意图或明确降级。

参数

getContacts(options) / addContact(options)

说明 Android 支持读取和新增通讯录。iOS / Harmony / Web / 小程序首版会返回不支持错误，后续版本再接入对应平台原生实现。

参数

onCallKitEvent(eventName, callback) / offCallKitEvent(eventName, callback?)

说明 订阅或取消插件事件。持续监听需配合 offCallKitEvent 释放。

参数

uni-app 示例

import {
  checkPermissions,
  requestPermissions,
  registerCallListener,
  onCallKitEvent,
  getAllRecorderFiles
} from '@/uni_modules/lizhao-call-kit'

// 先检查高敏权限，未授权时引导用户授权。
checkPermissions({
  success(res) {
    console.log('权限状态', res)
  }
})

// Android 端请求电话、短信、通讯录等权限。
requestPermissions({
  success(res) {
    console.log('授权完成', res)
  },
  fail(err) {
    console.log('授权失败', err)
  }
})

// 注册事件监听，页面卸载时应调用 offCallKitEvent。
onCallKitEvent(null, (event) => {
  console.log('电话短信事件', event)
})

// 注册通话监听，挂断后尝试匹配系统自动录音文件。
registerCallListener({
  matchRecorderOnEnd: true,
  success(res) {
    console.log('通话监听已开启', res)
  }
})

// 扫描常见系统/OEM 通话录音目录。
getAllRecorderFiles({
  includeDuration: true,
  success(res) {
    console.log('录音文件', res)
  }
})

uni-app x 示例

import { getCallKitCapabilities, sendSmsIntent } from '@/uni_modules/lizhao-call-kit'

// 先按能力矩阵判断当前平台，不支持能力不要误判为失败业务。
getCallKitCapabilities({
  success(res) {
    console.log('能力矩阵', res)
  }
})

// 多端优先使用系统短信意图，Android 才可按授权使用 sendSmsSilent。
sendSmsIntent({
  phoneNumber: '10086',
  message: '测试短信',
  success(res) {
    console.log('已打开系统短信页', res)
  }
})

错误码

注意事项

• 静默短信、短信读取、通话记录、通讯录读取均属于高敏能力，发布前需要准备隐私政策和应用场景说明。
• Android 10+ 对后台启动、通话录音和默认电话应用限制明显，接听/挂断只按 best-effort 返回，不承诺所有设备可用。
• 修改 utssdk/app-android/index.uts、AndroidManifest.xml、权限或前台服务后，必须重新打 Android 自定义基座或重新运行原生联编。

发布前检查

发布源码包前建议在项目根目录运行：

D:\HBuilderX\plugins\node\node.exe scripts\check-lizhao-call-kit-release-gate.js

该命令会检查目录结构、根入口导出、API 契约、Android 权限、iOS 首版能力边界、README 和演示页入口。

如果要确认当前 Android 模拟器或真机安装的自定义基座是否已经包含 lizhao-call-kit 原生运行时，运行：

D:\HBuilderX\plugins\node\node.exe scripts\check-lizhao-call-kit-installed-runtime.js

该命令会检查设备端 uni_modules/lizhao-call-kit/utssdk/app-android/classes.dex。如果只存在 index.kt / config.json 而没有 classes.dex，说明当前基座尚未完成 Android 原生联编，页面可以打开但原生 API 无法作为发布运行态证据。

如果要在真机验收全部完成后再做严格发布判断，运行：

D:\HBuilderX\plugins\node\node.exe scripts\check-lizhao-call-kit-release-gate.js --require-runtime-verified

严格模式要求 verification-checklist.md 中 Android 自定义基座、通话监听、短信、通讯录、前台服务和降级平台验收项都已按真实设备结果确认。仅导出 appResource 或热更新资源不能替换已编译进基座的 UTS 原生逻辑；涉及 Android 原生 UTS、Manifest、权限或前台服务变更时，最终验收必须安装最新 Android 自定义基座。