← 返回定时任务组件参考 · 全部使用指导

定时任务使用指导

• 定时任务使用指导
  • 快速上手：每天 8 点打卡提醒
  • 工作日提醒与取消
  • 闹钟：到点打开界面
  • 搭建与测试
  • 属性、方法与事件速查
  • 常见问题与验收
  • 完整 .aia 源码与操作指导
    • 设备定时提醒
  • 推荐测试顺序

不可见组件：到指定时刻触发到点时（编号，是否补发）（Fired）事件——某个时刻一次、每天几点、每周几的几点、每隔几分钟。 设置了通知标题（NotificationTitle）或通知文字（NotificationText）时，App 不在前台也会到点弹一条通知。

积木只能在 App 运行时执行，所以到点时分两种情况：

排定的任务会保存下来：App 被关掉、手机重启后照样到点。每个任务用一个编号（整数）区分，编号在每个屏幕内独立； 同一编号再排就替换原来的任务，所以在 Screen1.Initialize 里排任务不会越排越多。 勾选到点打开屏幕（OpenScreen）可以做闹钟：到点亮屏、直接打开这个屏幕并显示在锁屏上方。 做不到的事：App 关掉后在后台跑积木（例如定时上传数据）。 本组件合并了第三方拓展 UrsAI2Alarm 的常用功能。

快速上手：每天 8 点打卡提醒

拖一个定时任务到屏幕，通知标题填「打卡」、通知文字填「该打卡了」：

各案例独立使用；组合到同一屏幕时，将同名事件的处理合并到一个事件积木中。

when Screen1.Initialize() {
  定时任务1.ScheduleDaily(1, 8, 0)
}

when 定时任务1.Fired(编号, 是否补发) {
  if 是否补发 {
    标签1.Text = "你错过了今天 8 点的打卡提醒"
  } else {
    对话框1.ShowAlert("该打卡了")
  }
}

工作日提醒与取消

星期列表用 1（周一）到 7（周日）。下面每个工作日 21:30 提醒写日报，开关控制开启或取消：

when 开关1.Changed() {
  if 开关1.On {
    定时任务1.ScheduleWeekly(2, [1, 2, 3, 4, 5], 21, 30)
  } else {
    定时任务1.Cancel(2)
  }
}

某个时刻提醒一次：用计时器的「由元件建时间点」生成时刻，例如 2026 年 10 月 1 日 9 点：

when 按钮1.Click() {
  定时任务1.ScheduleOnce(3, 计时器1.MakeInstantFromParts(2026, 10, 1, 9, 0, 0))
}

闹钟：到点打开界面

到点打开屏幕勾选为真，通知文字填「该吃药了」。安卓 10 起要先让用户允许后台打开界面（小米手机会打开应用权限页， 请用户同时打开「后台弹出界面」和「显示悬浮窗」）：

when 按钮_设闹钟.Click() {
  if 定时任务1.HasLaunchPermission() {
    定时任务1.ScheduleDaily(1, 7, 30)
    对话框1.ShowAlert("已设好每天 7:30 的闹钟")
  } else {
    定时任务1.RequestLaunchPermission()
  }
}

when 定时任务1.LaunchPermissionResult(已授权) {
  if 已授权 {
    定时任务1.ScheduleDaily(1, 7, 30)
  } else {
    对话框1.ShowAlert("没有授权时只在锁屏或熄屏状态下打开界面")
  }
}

when 定时任务1.Fired(编号, 是否补发) {
  if not(是否补发) {
    音效1.Play()
    标签1.Text = "该吃药了"
  }
}

到点时屏幕被拉起、点亮并盖在锁屏上方，「到点」事件里的积木负责响铃和显示内容；用户离开这个界面后恢复正常锁屏。

搭建与测试

在设计器拖入本组件和案例涉及的按钮、标签、布局等组件，按案例中的名称重命名。先运行最小案例，确认事件返回，再增加业务逻辑。示例中的素材先上传到项目，服务器地址、令牌、文件路径换成自己的值。

可见组件需要有非零宽高；不可见工具组件必须由属性或方法启动。设计器展示样式不等于运行时已加载数据或绑定目标。联机测试应使用包含本组件的 AI 伴侣；涉及系统入口或权限的行为还要编译安装后验证。

属性、方法与事件速查

完整参数类型、默认值和平台说明见组件参考。下表按调用入口列出用途；有完成事件的方法在事件中读取结果。

常见问题与验收

完整 .aia 源码与操作指导

下载 .aia 源码

设备检查提醒的一次、每天、每周和间隔排期，全部由明确按钮创建，首次打开仅读取已有计划。建议先保持前台测试30秒一次提醒，确认真实事件后再测试通知和后台恢复。

导入 ScheduledTaskAllFeatures.aia，连接最新伴侣，或编译独立安装包。真机／伴侣运行尚未实测。

所有返回值均用于界面反馈，错误由底部错误区展示。设计器采用明确非默认配置，初始化与界面同步。API 覆盖检查按最终 AIA 检查方法、事件、属性读取与设置及设计器配置，不能替代真实设备验证。

设备定时提醒

导入方法：项目 → 导入项目（.aia）→ 选择下载的 .aia 源码文件。 设备检查提醒的一次、每天、每周和间隔排期，全部由明确按钮创建，首次打开仅读取已有计划。建议先保持前台测试30秒一次提醒，确认真实事件后再测试通知和后台恢复。 覆盖检查 26/26。首次载入及保存重开均0个错误，真实后台导入、安装包编译通过；真机／伴侣／硬件联调尚未实测。全部属性读写、方法与事件的操作入口和预期结果见组件指导。

推荐测试顺序

1. 不勾选准点和打开界面，点击30秒一次提醒，保持应用前台等待。到点区应显示编号101、真实接收时间和补发标志。
2. 将每天时分设为下一分钟，读取计划。相同编号重复排定是替换；测试完取消102。星期编号1为周一、7为周日。
3. 根据系统提示允许通知，申请所需权限，再勾选相关选项并重新排定。准点权限申请没有统一完成事件，返回后点击读取权限。
4. 鸿蒙退后台可能冻结前台定时器；系统提醒与本应用事件是两条路径。返回应用后已到期任务可能补发。间隔任务关闭应用期间仅保证已排定的下一次系统提醒，回来后继续排期，不承诺后台每15分钟持续运行。
5. 测完取消101—104；“全部取消”会影响当前屏幕的全部排期，伴侣多项目测试时谨慎使用。编译独立安装更适合测试系统入口；无设备环境未验证系统通知及自动打开界面。