更新记录

1.0.8（2026-09-06）

• 修复 iOS 安装自定义基座后，调用接口或退出示例页提示插件不存在的问题；同时修复 uni-app x 的 iOS 导入失败。
• iOS 拨号和短信编辑器按系统实际结果返回回调，短信正文会预填；打开编辑器成功不代表短信已经发送。
• iOS 不支持的能力会返回明确错误，成功或失败后均执行完成回调；无需修改配置或调用代码。
• 升级后需要重新制作并安装 iOS 自定义基座；本次不需要重新制作 Android 自定义基座。

1.0.6（2026-08-25）

• 修复 getRecorderDirectories 已生成录音目录数组、但成功回调仅返回 list，导致客户通过语义字段 res.directories 取不到目录的问题。
• Android 与非 Android 降级结果统一返回 directories；同时保留 list 作为历史兼容别名，旧调用无需修改。
• 补充录音目录获取示例、字段含义和 Android 厂商私有目录权限边界。

1.0.5（2026-06-24）

• 修复 uni-app x Android 示例页 options 强转崩溃：页面局部 DemoOptions 不再通过 as CallKitBaseOptions / as PermissionOptions 传入插件 API。
• 示例页改为直接构造 CallKitBaseOptions 和 PermissionOptions 强类型对象，避免 Android 运行时出现 DemoOptions cannot be cast to CallKitBaseOptions。
• 已在 Android 自定义基座中通过 USB/ADB 点击“能力”“检查权限”“通话状态”复检，相关 API 均返回 success，未再出现 lizhao-call-kit 相关 ClassCastException。
• 本版本仅修改 uni-app x 示例和发布资料，不修改公共接口、Android 原生实现、web/mp/app-plus/iOS 实现或 uni-app 示例。

平台兼容性

uni-app(4.84)

uni-app x(4.84)

lizhao-call-kit

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

从简单到复杂

完整示例源码位于 uni_modules/lizhao-call-kit/example/uniapp/callKit.vue 和 uni_modules/lizhao-call-kit/example/uniappx/index.uvue。

最小可运行示例

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

// 第一步先探测能力，按平台显示可用功能。
getCallKitCapabilities({
  success(res) {
    console.log('lizhao-call-kit 能力矩阵', res)
  }
})

// Android 真机建议再做机型适配检测，用于展示系统限制和权限建议。
checkDeviceCompatibility({
  success(res) {
    console.log('机型适配诊断', res)
  }
})

// 简单拨号优先使用系统拨号页，避免直接拨号权限门槛。
dialPhone({
  phoneNumber: '10086',
  success(res) {
    console.log('已打开拨号页', res)
  }
})

// 多端短信建议先走系统短信页。
sendSmsIntent({
  phoneNumber: '10086',
  message: '测试短信',
  success(res) {
    console.log('已打开短信页', res)
  }
})

Android 权限与自定义基座

requestPermissions 会按应用的 targetSdkVersion 归一化媒体权限。即使设备低于 Android 13，targetSdkVersion 33+ 的基座也不会再向 HBuilderX 权限桥提交已废弃的 READ_EXTERNAL_STORAGE。

通话监听

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

const handleEnded = (event) => {
  console.log('通话结束事件', event)
}

// 请求电话状态权限后再注册监听。
requestPermissions({
  permissions: ['READ_PHONE_STATE', 'READ_CALL_LOG'],
  success() {
    registerCallListener({
      includePhoneNumber: true,
      matchRecorderOnEnd: true,
      success(res) {
        console.log('通话监听已注册', res)
      }
    })
  }
})

// 事件过滤：只接收 ended 事件；传 null 可接收全部事件。
onCallKitEvent('ended', handleEnded)

// 页面卸载时释放。
offCallKitEvent('ended', handleEnded)

指定 SIM 卡拨号

Android 系统限制

callPhone 支持传入 simSlotIndex，Android 会优先使用 TelecomManager.EXTRA_PHONE_ACCOUNT_HANDLE 指定通话卡槽，并同时写入部分厂商拨号器兼容字段。该能力需要 CALL_PHONE 权限；如果当前设备没有对应卡槽、ROM 不接受指定卡槽参数或系统策略拦截，系统可能回退到默认通话卡。

import {
  requestPermissions,
  callPhone
} from '@/uni_modules/lizhao-call-kit'

// 示例使用 SIM1 直接拨号；SIM2 通常传 1。
requestPermissions({
  permissions: ['CALL_PHONE', 'READ_PHONE_STATE'],
  success() {
    callPhone({
      phoneNumber: '10086',
      simSlotIndex: 0,
      success(res) {
        console.log('已发起指定 SIM 拨号', res)
      }
    })
  }
})

通话录音文件匹配

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

import {
  checkCallAutoRecorder,
  getRecorderDirectories,
  getAllRecorderFiles,
  matchCallRecordings
} from '@/uni_modules/lizhao-call-kit'

checkCallAutoRecorder({
  success(res) {
    console.log('系统自动录音状态', res)
  }
})

getRecorderDirectories({
  success(res) {
    // 标准字段为 directories；list 仅作为历史版本兼容别名保留。
    console.log('录音目录候选项', res.directories)
  }
})

getAllRecorderFiles({
  includeDuration: true,
  limit: 50,
  success(res) {
    console.log('录音文件列表', res)
  }
})

matchCallRecordings({
  windowMs: 180000,
  limit: 20,
  success(res) {
    // 每条结果包含 score、matchedBy、timeDeltaMs、phoneScore、timeScore、confidence 和 reason。
    console.log('匹配可信度', res)
  }
})

getRecorderDirectories 返回的每一项包含 path / exists / writable / source。exists 表示当前应用在现有系统权限下能看到该候选目录；如果设备使用了其他厂商目录，可先通过 setRecorderDirectories 配置实际路径。Android 11 及以上的厂商私有目录仍可能需要用户开启所有文件访问权限，系统加密目录或其他应用沙箱目录无法由普通第三方应用读取。

短信监听与短信回执

sendSmsSilent 会把短信提交给系统，最终发送和送达状态通过 onCallKitEvent('sent')、onCallKitEvent('delivered') 返回。送达回执依赖运营商、SIM 卡、系统短信策略和用户授权。

import {
  registerSmsListener,
  sendSmsSilent,
  onCallKitEvent
} from '@/uni_modules/lizhao-call-kit'

onCallKitEvent('received', (event) => {
  console.log('收到短信', event.payload)
})

onCallKitEvent('sent', (event) => {
  console.log('短信发送回执', event.payload)
})

onCallKitEvent('delivered', (event) => {
  console.log('短信送达回执', event.payload)
})

registerSmsListener({
  includeBody: true,
  success(res) {
    console.log('短信监听已注册', res)
  }
})

sendSmsSilent({
  phoneNumber: '10086',
  message: '静默短信测试',
  requestCode: 904001,
  success(res) {
    console.log('短信已提交系统', res)
  }
})

通讯录读取与新增

import {
  getContacts,
  addContact
} from '@/uni_modules/lizhao-call-kit'

getContacts({
  keyword: '张',
  limit: 20,
  success(res) {
    // Android 返回 displayName、phoneNumbers、emails 和 note。
    console.log('联系人列表', res)
  }
})

addContact({
  displayName: '测试客户',
  phoneNumbers: ['***'],
  emails: ['customer@example.com'],
  note: '由 lizhao-call-kit 写入的测试备注',
  success(res) {
    console.log('联系人已新增', res)
  }
})

前台服务

import {
  startForegroundService,
  stopForegroundService
} from '@/uni_modules/lizhao-call-kit'

startForegroundService({
  title: '电话短信监听服务运行中',
  content: 'lizhao-call-kit 正在按系统策略保持监听'
})

stopForegroundService()

API 查询

getCallKitCapabilities(options)

checkDeviceCompatibility(options)

说明 检测当前 Android 设备、系统版本、targetSdkVersion、录音媒体权限、SIM 卡槽拨号基础条件和常见 ROM 风险。非 Android 平台返回明确降级结果。

参数

返回值

requestPermissions(options)

registerCallListener(options)

matchCallRecordings(options)

sendSmsSilent(options)

getContacts(options) / addContact(options)

支持平台

错误码

注意事项

• iOS 需制作并安装包含本插件的自定义基座；升级涉及原生实现时需重新制作。dialPhone / callPhone 的成功表示系统已接受打开拨号请求，不代表已接通；iOS 不支持指定 SIM 或静默拨号。sendSmsIntent 的成功表示短信编辑器已展示，发送或取消由使用者决定，不代表短信已发送或送达；无法发短信、无法展示编辑器时会触发 fail / complete。

• iOS 的 success / fail / complete 异步返回，complete 在成功或失败回调后触发。不支持的操作返回 9040001；查询和取消监听仍可返回明确的未注册、未运行或空列表状态。

• 静默短信、短信读取、通话记录、通讯录读取均属于高敏能力，发布前需要准备隐私政策和应用场景说明。

• Android 10+ 对后台启动、通话录音和默认电话应用限制明显，接听/挂断只按 best-effort 返回，不承诺所有设备可用。

• 插件不会绕过系统权限，也不会直接录制蜂窝通话。

• 修改 Android 平台 UTS、权限、Manifest 或前台服务后，需要重新运行 Android 原生联编或重新打 Android 自定义基座。

发布门禁

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

真机验收全部完成后再运行严格发布门禁：

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

作者系列 UTS 插件

以下为已在 DCloud 插件市场上架的作者系列 UTS 插件，可按业务场景组合使用。未列出的插件表示当前未确认公开市场页，后续上架后再补充。