更新记录

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 示例。

1.0.4（2026-06-17）

• 修复 Android 控制台 deprecated warning：PhoneStateListener、onCallStateChanged、SubscriptionInfo.getNumber()、TelephonyManager.getLine1Number() 不再直接出现在 UTS 入口中。
• 新增 Kotlin 原生桥 CallKitPhoneStateBridge.kt，Android 12+ 使用 TelephonyCallback.CallStateListener，Android 12 以下在桥内部保留 PhoneStateListener 兼容分支。
• 静默短信发送改为通过 Kotlin 桥封装 sendTextMessage()，UTS 文件移除 SmsManager.getDefault() 直接调用。
• 修复短信 PDU 解析 helper 返回动态类型导致 getOriginatingAddress / getMessageBody / getTimestampMillis 无法识别的问题。
• 本版本仅调整 Android 平台实现和发布资料，不修改公共接口、web/mp/app-plus/iOS 实现或 uni-app 示例。

1.0.2（2026-06-15）

• 新增 Android 静默短信发送回执：sendSmsSilent 提交系统后，通过 onCallKitEvent('sent') 和 onCallKitEvent('delivered') 返回发送/送达状态。
• 新增事件过滤能力：onCallKitEvent(eventName, callback) 支持按 incoming / ended / received / sent / delivered 等事件名单独订阅。
• 增强通话录音匹配结果，返回 matchedBy / timeDeltaMs / phoneScore / timeScore / confidence，方便客户判断匹配可信度。
• 增强 Android 通讯录读写，读取联系人时返回邮箱和备注，新增联系人时支持写入邮箱和备注。
• 补齐 scripts/check-lizhao-call-kit-release-gate.js 发布门禁，并新增 scripts/check-lizhao-call-kit-enhancements.js 增强守卫。
• 重写 README 接入顺序，按“最小接入 -> 通话监听 -> 录音匹配 -> 短信回执 -> 通讯录 -> 前台服务 -> API 查询”循序渐进说明。
• 示例页新增短信监听、静默短信回执、事件过滤、录音匹配、新增联系人和权限设置页测试入口。

平台兼容性

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，不会伪造成功。

当前版本：1.0.5

1.0.5 uni-app x 示例 options 强转修复

本版本修复 uni-app x Android 示例页中页面局部 DemoOptions 强转为插件导出 options 类型导致的运行时崩溃。示例页现在直接构造 CallKitBaseOptions 和 PermissionOptions 强类型对象，避免 Android 运行时出现 DemoOptions cannot be cast to CallKitBaseOptions。

1.0.4 Android deprecated warning 收口

本版本将 Android 通话监听、号码读取和静默短信发送中的 deprecated 符号收敛到 Kotlin 原生桥内部，UTS 入口不再直接暴露 PhoneStateListener、SmsManager.getDefault() 等 warning 来源。Android 12+ 使用 TelephonyCallback，低版本在 Kotlin 桥内保留兼容分支。

从简单到复杂

完整示例源码路径：uni_modules/lizhao-call-kit/example/index.vue。

最小可运行示例

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 权限与自定义基座

通话监听

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,
  getAllRecorderFiles,
  matchCallRecordings
} from '@/uni_modules/lizhao-call-kit'

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

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)
  }
})

短信监听与短信回执

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)

支持平台

错误码

注意事项

• 静默短信、短信读取、通话记录、通讯录读取均属于高敏能力，发布前需要准备隐私政策和应用场景说明。
• 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 插件，可按业务场景组合使用。未列出的插件表示当前未确认公开市场页，后续上架后再补充。