帧信号对齐绘制时序,HarmonyOS 7 自定义渲染与 Canvas 调度约束
区分主动绘制和帧驱动绘制
刚接触 ArkUI 里的 Canvas 组件时,我很容易顺着原生安卓或者 Web 的思路写代码。拿到 CanvasRenderingContext 之后,想画就直接调用绘图接口,按钮点击、数据回调里面随时触发绘制。在简单的静态图形页面看不出问题,一旦放到滚动列表、跟随手势移动的画布场景,画面撕裂、跳变、掉帧就会频繁出现。之前做一个手写批注模块,手指滑动的时候,回调里直接调用 stroke 绘图,结果线条断断续续,有时候一笔画完半秒之后画面才刷新出来。
这个问题的根源,是没有对齐 ArkUI 的渲染帧信号。HarmonyOS 7 的 UI 渲染有固定的帧管线,所有组件的绘制不是调用绘图 API 就立刻刷到屏幕上。Canvas 上下文只是一个绘图缓冲区,你调用 lineTo、fill 这些接口,只是往缓冲区写入指令,真正上屏,要等到组件所在的渲染周期被调度。脱离帧信号直接绘图,会出现指令堆积在两个帧中间,前后两帧的画面混在一起,也就是我们常说的撕裂。
很多开发者会混淆两个概念:Canvas 的绘图上下文,和系统 VSync 帧信号。上下文负责接收绘图指令,帧信号决定什么时候提交缓冲区。没有帧信号约束的绘制,属于无序绘制,时序完全不可控。
不是所有绘制都必须走帧回调。静态不变的图形,在组件初始化的时候一次性绘制完成,完全没问题。但只要是跟随手势、动画、传感器、网络数据实时变化的画面,必须绑定帧回调,把绘图逻辑放进帧回调里面执行。
使用 FrameCallback 对齐 VSync 帧信号
下面这段是可直接运行的基础示例,实现跟随手指滑动的轨迹绘制,所有绘图逻辑放在帧回调内,保证每一帧只提交一次画布。
import { Component, State, Ref, Build } from '@kit.ArkUI';
import { FrameCallback, UIContext } from '@kit.ArkUI';
@Component
struct SketchCanvas {
@Ref canvasRef: CanvasRef | null = null
@State points: Array<{x: number, y: number}> = []
private ctx: CanvasRenderingContext2D | null = null
private frameId: number = -1
private uiCtx: UIContext | null = null
aboutToAppear() {
this.uiCtx = this.canvasRef?.getUIContext()
this.ctx = this.canvasRef?.getCanvasRenderingContext2D('2d')
}
// 帧回调,每一次VSync信号到来执行一次
private onFrame: FrameCallback = (timestamp: number) => {
if (!this.ctx) return
// 清空画布缓冲区
this.ctx.clearRect(0, 0, 360, 480)
this.ctx.beginPath()
if (this.points.length > 0) {
this.ctx.moveTo(this.points[0].x, this.points[0].y)
for (let i = 1; i < this.points.length; i++) {
this.ctx.lineTo(this.points[i].x, this.points[i].y)
}
this.ctx.strokeStyle = '#007DFF'
this.ctx.lineWidth = 4
this.ctx.lineCap = 'round'
this.ctx.stroke()
}
// 继续注册下一帧,持续动画
this.frameId = this.uiCtx?.requestAnimationFrame(this.onFrame) ?? -1
}
onTouchMove(event: TouchEvent) {
const touch = event.touches[0]
this.points.push({
x: touch.touchX,
y: touch.touchY
})
}
onTouchStart() {
// 启动帧循环
if (this.frameId < 0) {
this.frameId = this.uiCtx?.requestAnimationFrame(this.onFrame) ?? -1
}
}
onTouchEnd() {
// 停止帧循环,不再持续提交绘制
if (this.frameId >= 0 && this.uiCtx) {
this.uiCtx.cancelAnimationFrame(this.frameId)
this.frameId = -1
}
}
aboutToDisappear() {
// 页面销毁必须取消帧回调,防止回调继续执行
if (this.frameId >= 0 && this.uiCtx) {
this.uiCtx.cancelAnimationFrame(this.frameId)
this.frameId = -1
}
}
@Build
build() {
Column() {
Canvas(this.canvasRef)
.width(360)
.height(480)
.backgroundColor('#f5f5f5')
.onTouchStart((e) => this.onTouchStart())
.onTouchMove((e) => this.onTouchMove(e))
.onTouchEnd((e) => this.onTouchEnd())
}
.padding(16)
.width('100%')
}
}
这里最关键的一条约束:requestAnimationFrame 拿到的回调,是绑定当前 UIContext 的。如果 UIContext 失效,页面销毁之后还没 cancel,回调依旧会触发,尝试使用已经失效的 Canvas 上下文,直接抛出异常,还会造成内存泄漏。这也是为什么 aboutToDisappear 里面,一定要 cancel 掉帧 ID。
很多新手踩坑,会在 touchMove 回调里面直接写绘图代码。touchMove 的触发频率,和 VSync 帧频率并不对齐。手指滑动的时候,touchMove 回调可能一秒触发几十次,远高于屏幕 60 帧或者 120 帧的刷新上限。大量重复绘图指令塞进去,同一帧里面反复清空、重绘,白白消耗 CPU,画面还会抖动。正确做法是,触摸回调只负责收集坐标数据,绘图动作全部交给帧回调统一处理。
缓冲区复用与画布尺寸陷阱
Canvas 有两套尺寸,一套是组件布局宽高,一套是绘图缓冲区的像素尺寸,很多人在这里栽跟头。如果设备是高 DPI 屏幕,不做像素对齐,画出来的线条会发虚、边缘模糊。
// 像素适配示例,在初始化阶段执行
const dpr = this.uiCtx?.getDensity() ?? 1
const canvas = this.canvasRef
if (canvas) {
canvas.width = 360 * dpr
canvas.height = 480 * dpr
this.ctx?.scale(dpr, dpr)
}
组件上设置的 width、height 是布局尺寸,canvas.width 和 canvas.height 是离屏缓冲区像素尺寸。两个值不匹配,画面就会拉伸模糊。还有一个高频误区:每次绘制的时候反复调用 scale,scale 是累积变换,连续调用会叠加缩放,几帧之后图形直接跑出画布,甚至看不见。变换矩阵只在初始化配置一次,不要放在帧循环里面重复执行。
另外,不要频繁销毁重建 CanvasRef。Canvas 缓冲区资源开销不小,反复重建会触发 GPU 资源频繁创建释放,在低端机型上会出现闪屏。如果只是内容清空,调用 clearRect,而不是重新创建 Canvas 组件。
帧循环内的耗时控制
帧回调里面留给开发者的时间窗口是固定的,60 帧的设备,单帧预算大约 16ms。如果帧回调里面放了复杂循环、大量图片解码、复杂路径计算,超过这个时间,这一帧就会错过 VSync 信号,画面直接掉帧。
一个很常见的错误写法,在帧回调里面加载图片资源。图片加载是 IO 操作,有等待时间,放在帧回调里会阻塞整个渲染管线。图片资源必须提前预加载,缓存到内存,帧回调只负责 drawImage,不做加载动作。
// 错误写法,帧回调内部加载图片
private onFrame(timestamp: number) {
this.ctx?.drawImage(await loadImage('xxx.png'))
}
// 正确写法,提前加载,帧内只绘制
private preloadImg: ImageBitmap | null = null
async load() {
this.preloadImg = await this.ctx?.createImageBitmap('xxx.png')
}
private onFrame(timestamp: number) {
if(this.preloadImg) {
this.ctx?.drawImage(this.preloadImg, 0, 0)
}
}
如果绘图计算量本身很大,比如上千个点的粒子动画,单帧算不完,不要硬塞在帧回调。可以把计算逻辑放到 TaskPool,计算完成之后把结果放回页面状态,帧回调只读取已经算好的数据,负责绘制。计算和绘制拆分,不要在帧周期里面做重型运算。
和 ArkUI V2 状态观测的协同边界
Canvas 属于自绘组件,它的画面更新,不完全依赖 @State 标脏。很多人会试图用 @State 驱动画布,每次坐标变化就修改状态,靠组件刷新来重绘。这种方式不是不行,但粒度很粗,状态标脏的调度优先级,和 VSync 帧信号不是一套体系,高实时性场景跟不上手势。
两套机制适合不同场景:简单的、不需要高实时性的画布内容,用 @State 驱动,交给 ArkUI 自动刷新;手写、动画、跟随传感器这类低延迟画面,优先使用 requestAnimationFrame 帧循环。
这里有一个隐性冲突:如果你同时开启状态刷新和帧循环绘制,两套管线同时修改同一个 Canvas 缓冲区,画面会随机错乱。同一个画布,只选一种驱动方式,不要混用。
还有一个细节,Canvas 绘制的内容,不会经过 ArkUI 的语义树、无障碍节点。如果你的画布里面有按钮、文字,只靠 Canvas 画出来,系统无障碍朗读读不到。需要做无障碍适配的页面,不要全部塞进 Canvas,把交互控件拆成原生 ArkUI 组件叠加在画布上层。
离屏 Canvas 的资源回收规则
业务复杂的时候,我们会用到离屏 Canvas 做中间缓存,先在离屏画布绘制一层背景,再拷贝到主画布,减少重复绘制。离屏 Canvas 对应的 ImageBitmap、离屏上下文,不会自动回收。
const offscreenCanvas = new OffscreenCanvas(360,480)
const offCtx = offscreenCanvas.getContext('2d')
// 使用完成之后,手动释放
offscreenCanvas.close()
忘记 close,离屏缓冲区会持续占用 GPU 显存,页面反复进出,显存持续上涨,用一段时间之后系统会强制杀掉应用。尤其是图片编辑、画板这类重度自绘页面,离屏资源的释放,要和页面生命周期绑定,在 aboutToDisappear 统一清理。
开发层面的绘制时序准则
Canvas 自绘的核心难点,从来不是绘图 API 怎么调用,而是管住绘制的时机。
第一,实时动画、手势跟随画面,统一用 requestAnimationFrame 绑定 VSync,数据收集和绘图逻辑拆分,事件回调只更新数据,帧回调负责绘制提交。 第二,区分布局尺寸和像素缓冲区尺寸,高 DPI 屏幕做好 dpr 缩放,避免画面发虚;缩放变换只初始化一次,不要在帧循环累积。 第三,帧回调里面只做绘图,所有 IO、图片加载、复杂计算提前放到帧周期之外,或者丢到 TaskPool 异步处理,守住单帧时间预算。 第四,帧回调、离屏画布、图片位图都需要手动释放,页面销毁时取消帧循环、关闭离屏资源,防止显存泄漏。 第五,不要同时用状态刷新和帧循环两套机制驱动同一个画布,避免渲染管线冲突。
自绘组件是给开发者绕过 ArkUI 组件树、直接操作缓冲区的通道,通道越自由,时序约束就越严格。把绘制动作对齐到帧信号,画面稳定、低撕裂的问题,就能解决一大半。

更多推荐

所有评论(0)