更新记录

1.0.2（2026-05-11）

更新了来电铃声调用和停止

1.0.1（2026-05-11）

更新了弹窗调用方法

1.0.0（2026-05-06）

1.0.0插件上传

平台兼容性

其他

trtc-keep-alive 保活 + 来电通知插件

适用平台

仅 Android（iOS 暂未适配）

API

import {
  startKeepAliveService,
  showCallNotification,
  stopCallRingtone
} from '@/uni_modules/trtc-keep-alive';

1. startKeepAliveService()

启动保活服务，在 App.vue 的 onLaunch 中调用一次。

// App.vue onLaunch
startKeepAliveService();

2. showCallNotification(title?, text?)

弹出来电通知 + 持续循环响铃 + 震动。

// 收到来电时调用
showCallNotification('📞 远程执法呼叫', '来自 xxx 的紧急通话');

3. stopCallRingtone()

停止铃声 + 移除通知 + 恢复保活，接听或挂断时调用。

stopCallRingtone();

通知栏效果

• heads-up 横幅弹出
• 锁屏全屏显示
• 持续循环电话铃声
• 震动
• 点击通知拉起 App
• 状态栏显示电话手柄图标

接入步骤

1. App.vue 启动保活

import { startKeepAliveService } from '@/uni_modules/trtc-keep-alive';

export default {
  onLaunch() {
    startKeepAliveService();
  }
}

2. 监听到来电时弹通知

import { showCallNotification } from '@/uni_modules/trtc-keep-alive';

showCallNotification('📞 远程执法呼叫', '来自 xxx 的紧急通话');

3. 接听/挂断后停止铃声

import { stopCallRingtone } from '@/uni_modules/trtc-keep-alive';

stopCallRingtone();

注意事项

• 首次安装后建议重启设备，确保通知渠道生效
• 部分国产手机（小米/OPPO/华为等）默认关闭"横幅通知"，需引导用户在系统通知设置中手动开启
• Android 13+ 需要授予通知权限

通知渠道说明

文件结构

uni_modules/trtc-keep-alive/
├── README.md
├── package.json
├── changelog.md
└── utssdk/app-android/
    ├── index.uts                    ← 导出函数
    ├── AndroidManifest.xml          ← 权限声明
    └── src/KeepAliveService.kt      ← 通知 + 铃声逻辑

权限说明

在 AndroidManifest.xml 中已声明：

• FOREGROUND_SERVICE — 前台保活服务
• FOREGROUND_SERVICE_DATA_SYNC — Android 14+ 前台服务类型
• USE_FULL_SCREEN_INTENT — 强制横幅/锁屏显示
• POST_NOTIFICATIONS — Android 13+ 通知权限