HarmonyOS NEXT 使用Canvas实现模拟时钟案例

介绍

本示例介绍利用 Canvas 和定时器实现模拟时钟场景，该案例多用于用户需要显示自定义模拟时钟的场景。

效果图预览

使用说明

无需任何操作，进入本案例页面后，所见即模拟时钟的展示。

使用说明

无需任何操作，进入本案例页面后，所见即模拟时钟的展示。

实现思路

本例的的主要实现思路如下：

利用CanvasRenderingContext2D中的drawImage将表盘和表针绘制出来；
利用定时器每秒刷新一次，计算好时针、分针、秒针对应的偏移量，重新绘制表盘和表针，实现表针的转动。

本例中代码详情可参考AnalogClock.ets和TimeChangeListener.ets

1.在aboutToAppear中执行init函数，初始化表盘和表针对应的pixelMap，并首次绘制表盘和表针，保证进入页面即展示时钟。

// 初始化表盘和表针对应的变量，并首次绘制。
private init() {let clockBgSource = image.createImageSource(this.resourceDir + '/' + CLOCK_BG_PATH);let hourSource = image.createImageSource(this.resourceDir + '/' + CLOCK_HOUR_PATH);let minuteSource = image.createImageSource(this.resourceDir + '/' + CLOCK_MINUTE_PATH);let secondSource = image.createImageSource(this.resourceDir + '/' + CLOCK_SECOND_PATH);const now = new Date();const currentHour = now.getHours();const currentMinute = now.getMinutes();const currentSecond = now.getSeconds();this.time = this.getTime(currentHour, currentMinute, currentSecond);// 创建表盘对应的PixelMap并绘制。let paintDial = clockBgSource.createPixelMap().then((pixelMap: image.PixelMap) => {this.clockPixelMap = pixelMap;this.paintDial();}).catch((err: BusinessError) => {logger.error(`[error]error at clockBgSource.createPixelMap:${err.message}`);});// 创建时针对应的PixelMap并绘制。hourSource.createPixelMap().then(async (pixelMap: image.PixelMap) => {await paintDial;const hourOffset = currentMinute / 2;this.paintPin(ANGLE_PRE_HOUR * currentHour + hourOffset, pixelMap);this.hourPixelMap = pixelMap;}).catch((err: BusinessError) => {logger.error(`[error]error at hourSource.createPixelMap:${err.message}`);});...
}

2.为表盘和表针的绘制注册监听，每秒钟重新绘制一次，实现时钟的转动。

// 2.监听时间变化，每秒重新绘制一次
this.timeListener = new TimeChangeListener((hour: number, minute: number, second: number) => {this.renderContext.clearRect(-this.clockRadius, -this.clockRadius, this.canvasSize, this.canvasSize);this.paintDial();this.timeChanged(hour, minute, second);this.time = this.getTime(hour, minute, second);},
);

3.表针的绘制逻辑也是关键的一部分，因表针的绘制涉及旋转场景，需每次在旋转前先保存当前的绘制状态，旋转绘制结束后再恢复，防止多次旋转导致时间错乱。

// 绘制表针
private paintPin(degree: number, pinImgRes: image.PixelMap | null) {// TODO：知识点：先将当前绘制上下文保存再旋转画布，先保存旋转前的状态，避免状态混乱。this.renderContext.save();const angleToRadian = Math.PI / 180;let theta = degree * angleToRadian;this.renderContext.rotate(theta);this.renderContext.beginPath();if (pinImgRes) {this.renderContext.drawImage(pinImgRes,-IMAGE_WIDTH / 2,-this.clockRadius,IMAGE_WIDTH,this.canvasSize);} else {logger.error('PixelMap is null!');}this.renderContext.restore();
}

高性能知识点

不涉及

工程结构&模块类型

analogclock                             // har类型
|---src/main/ets/pages
|   |---AnalogClock.ets                 // 页面及时钟绘制的主要逻辑
|   |---TimeChangeListener.ets          // 时间变化监听文件