更新记录

1.0.0(2026-05-21)

  • 初始发布
  • Android 电话通话监听(来电、去电、挂断)
  • 获取通话录音文件(全部/条件搜索/音频时长)
  • 获取通话记录(全部/条件筛选)
  • 拨打电话、挂断电话、接听电话
  • 短信监听、取消监听
  • 静默发送短信、获取短信列表
  • 获取手机通讯录、添加通讯录
  • 检测/跳转通话自动录音设置
  • 文件操作(复制/移动/删除)
  • 双卡检测、获取本机号码
  • 所有文件访问权限检测/跳转
  • 前台通知服务(启动/停止/权限管理)
  • 设备适配检测

平台兼容性

uni-app(3.7.7)

Vue2 Vue3 Chrome Safari app-vue app-nvue Android iOS 鸿蒙
× × - 5.0 - -
微信小程序 支付宝小程序 抖音小程序 百度小程序 快手小程序 京东小程序 鸿蒙元服务 QQ小程序 飞书小程序 小红书小程序 快应用-华为 快应用-联盟
× × × × × × × × - - × ×

uni-app x(4.0)

Chrome Safari Android iOS 鸿蒙 微信小程序
- - 5.0 12 - -

ly028-PhoneTracker

安卓电话通话短信监听原生插件

功能列表

电话通话监听

  • ✅ 注册/取消电话监听(来电/去电/挂断)
  • ✅ 获取通话记录(全部/条件筛选)
  • ✅ 拨打电话 / 挂断电话 / 接听电话
  • ✅ 获取当前通话状态

录音文件

  • ✅ 获取所有录音文件
  • ✅ 条件搜索录音文件
  • ✅ 获取音频时长
  • ✅ 检测/跳转通话自动录音设置

短信

  • ✅ 注册/取消短信监听
  • ✅ 静默发送短信
  • ✅ 获取短信列表(收件箱/已发送等)

通讯录

  • ✅ 获取手机通讯录
  • ✅ 添***人

设备信息

  • ✅ 双卡检测
  • ✅ 获取本机号码
  • ✅ 设备适配检测

文件操作

  • ✅ 复制/移动/删除文件或目录

权限管理

  • ✅ 所有文件访问权限检测/跳转
  • ✅ 通知权限检测/跳转

前台通知服务

  • ✅ 启动/停止前台通知服务

快速开始

npm install
# 或直接在 HBuilderX 中导入插件

使用方法

import {
  registerPhoneListener,
  getCallRecords,
  getAllAudioRecords,
  registerSmsListener,
  getContacts
} from '@/uni_modules/ly028-PhoneTracker'

// 注册电话监听
registerPhoneListener({
  onRing: (number) => console.log('来电:', number),
  onDialing: (number) => console.log('去电:', number),
  onConnected: (number) => console.log('接通:', number),
  onDisconnected: (result) => {
    console.log('挂断:', result.phoneNumber, '时长:', result.duration)
  }
})

// 获取通话记录
const records = getCallRecords(100, 0)

// 获取短信列表
const smsList = getSmsList({ type: 'inbox', limit: 50 })

// 获取通讯录
const contacts = getContacts()

权限说明

权限 用途
READ_PHONE_STATE 读取电话状态
READ_CALL_LOG 读取通话记录
PROCESS_OUTGOING_CALLS 监听去电
ANSWER_PHONE_CALLS 接听电话
RECORD_AUDIO 录音相关
READ_SMS / RECEIVE_SMS 短信监听
SEND_SMS 发送短信
READ_CONTACTS / WRITE_CONTACTS 通讯录
FOREGROUND_SERVICE 前台服务
POST_NOTIFICATIONS 通知权限(Android 13+)
MANAGE_EXTERNAL_STORAGE 所有文件访问(Android 11+)

版本要求

  • Android: API 21+
  • HBuilderX: ^3.7.2
  • uni-app: ^3.7.7

隐私、权限声明

1. 本插件需要申请的系统权限列表:

Android:READ_PHONE_STATE、READ_CALL_LOG、PROCESS_OUTGOING_CALLS、RECORD_AUDIO、READ_SMS、RECEIVE_SMS、SEND_SMS、READ_CONTACTS、WRITE_CONTACTS、READ_EXTERNAL_STORAGE、WRITE_EXTERNAL_STORAGE、FOREGROUND_SERVICE、POST_NOTIFICATIONS

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

插件不主动采集任何数据,所有功能需用户主动调用

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率: