唯一合规方案是Android跳转系统闹钟设置页预填参数、iOS引导用户手动设置并本地通知兜底。Android用AlarmClock.ACTION_SET_ALARM Intent预设时间与备注,无需权限;iOS无公开接口,只能弹窗引导+本地通知,后台响铃不可靠。

uni-app 在 App 端无法直接调用系统级闹钟接口,但可以跳转到系统原生闹钟设置页并预填参数——这是唯一合规、稳定、无需签名/权限审批的方案。其他所谓“后台唤醒+响铃”的插件,要么依赖用户保持 App 前台,要么在 Android 8+ / iOS 13+ 上被系统静默拦截。
Android 调用 AlarmClock.ACTION_SET_ALARM 跳转设置页
这是官方支持的 Intent 方式,不需任何权限声明,也不触发安全警告。系统会打开自带闹钟 App,并自动填入小时、分钟、备注等字段。
-
AlarmClock.EXTRA_HOUR和AlarmClock.EXTRA_MINUTES必须传整数,不能为 null 或字符串 -
AlarmClock.EXTRA_MESSAGE支持中文,长度建议 ≤ 30 字,过长可能被截断 -
AlarmClock.EXTRA_SKIP_UI设为true可跳过中间确认页(部分厂商 ROM 不支持,如华为 EMUI 12) - 必须检查
intent.resolveActivity(),否则在无系统闹钟 App 的设备(如某些定制 ROM)上会崩溃
setAlarm(hour, minutes, message) {
const Intent = plus.android.importClass('android.content.Intent');
const AlarmClock = plus.android.importClass('android.provider.AlarmClock');
const intent = new Intent(AlarmClock.ACTION_SET_ALARM);
intent.putExtra(AlarmClock.EXTRA_HOUR, hour);
intent.putExtra(AlarmClock.EXTRA_MINUTES, minutes);
intent.putExtra(AlarmClock.EXTRA_MESSAGE, message);
intent.putExtra(AlarmClock.EXTRA_SKIP_UI, true);
intent.setFlags(Intent.FLAG_ACTIVITY_NEW_TASK);
const main = plus.android.runtimeMainActivity();
if (intent.resolveActivity(main.getPackageManager())) {
main.startActivity(intent);
} else {
uni.showToast({ title: '未找到系统闹钟应用', icon: 'none' });
}
}
iOS 无法跳转系统闹钟,只能退而求其次
iOS 没有公开的系统闹钟 Intent 接口,UNNotificationRequest 仅支持本地通知,且 App 被杀掉后无法触发响铃。所谓“调用系统闹钟”在 iOS 上本质是伪命题。
- 不能跳转到 Clock App 并预设时间(Apple 未开放 URL Scheme)
-
uni.addLocalNotification的trigger.type === 'calendar'仅在 App 后台存活时有效,锁屏后大概率不响 - 若真需响铃,必须配合
sound: 'default'+ Background Modes 开启audio,再播放极低音量音频保活——但这属于 hack,iOS 17 后成功率大幅下降
实际可行做法:弹窗引导用户手动设置,并附上图文指引(比如“点击右上角 + → 输入时间 → 开启重复与铃声”)。
为什么不要自己写 AlarmManager 插件
看似能 setExact + BroadcastReceiver 实现“真闹钟”,但落地时几乎全部失效:
- Android 9+ 强制限制后台启动 Activity,BroadcastReceiver 收到广播后无法弹窗或播放铃声(除非 App 已在前台)
- 小米/OPPO/Vivo 等厂商系统默认禁止非白名单 App 使用 AlarmManager,需用户手动开启“自启动”和“允许后台弹出界面”
- iOS 上
UIApplication.shared.beginBackgroundTask最多延长运行 30 秒,根本不够完成播放逻辑 - 所有方案都绕不开用户授权,而“设置闹钟”权限(
SET_ALARM)在 Android 中是 normal 级权限,但 Google Play 审核时会拒收滥用该权限的 App
真正能交付的方案只有两个:Android 用 AlarmClock.ACTION_SET_ALARM 跳转预设;iOS 老老实实做引导+本地通知兜底。别在“后台唤醒响铃”上浪费调试时间——系统策略比代码更硬。











