# AlarmClock

**Repository Path**: wangwenbo55/AlarmClock

## Basic Information

- **Project Name**: AlarmClock
- **Description**: 基于HarmonyOS通知能力，实现进度条通知的案例。
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2024-08-01
- **Last Updated**: 2024-08-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 闹钟

## 简介

基于ArkTS的声明式开发范式及HarmonyOS的后台代理提醒能力，实现简单的闹钟提醒功能。

最终效果图如图所示：

![](screenshots/device/AlarmClock.gif)

## 相关概念

- Canvas：提供画布组件，用于自定义绘制图形。

- CanvasRenderingContext2D：使用RenderingContext在Canvas组件上进行绘制，绘制对象可以是矩形、文本、图片等。

- 后台代理提醒：开发应用时，开发者可以调用后台提醒发布的接口创建定时提醒，包括倒计时、日历、闹钟三种提醒类型。使用后台代理提醒能力后，应用可以被冻结或退出，计时和弹出提醒的功能将被后台系统服务代理。本应用中主要使用到后台代理提醒的两个接口：

  - **publishReminder**

        发布一个后台代理提醒，使用callback方式实现异步调用，该方法需要申请通知弹窗Notification.requestEnableNotification后才能调用。

  - **cancelReminder**

        取消指定id的提醒，使用callback方式实现异步调用。

## 相关权限

本篇Codelab需要在module.json5中配置如下权限：

```
"requestPermissions": [
  {
    "name": "ohos.permission.PUBLISH_AGENT_REMINDER",
    "reason": "$string:reason",
    "usedScene": {
      "abilities": [
        "EntryAbility"
      ],
      "when": "inuse"
    }
  }
]
```

## 使用说明

1. 打开应用，添加一个闹钟，闹钟到设定的时间后弹出提醒。
2. 修改闹钟的时间，闹钟到设定的时间后弹出提醒。
3. 删除闹钟。
4. 展示闹钟列表，并可打开和关闭单个闹钟。

## 约束与限制

1. 本示例仅支持标准系统上运行，支持设备：华为手机。
2. HarmonyOS系统：HarmonyOS NEXT Developer Beta1及以上。
3. DevEco Studio版本：DevEco Studio NEXT Developer Beta1及以上。
4. HarmonyOS SDK版本：HarmonyOS NEXT Developer Beta1 SDK及以上。