鸿蒙上做 GPU 粒子渲染遇到一个新问题:同一套代码在旗舰机上 60fps 很稳,但到千元机上掉到 30-40fps ,低端机型用户看到的粒子动画像幻灯片。朴素做法是根据机型分档 (Mate 60 开 high,低端机开 low)------但机型识别不稳定(有的机型不在白名单),而且同一台设备不同场景的负载也不一样(后台跑别的 app 时 FPS 也会掉)。做某个呼吸训练 app 时用了运行时测 FPS + 滞后窗口降质 的方案自动调。记录一下,顺便分享给有需要的朋友。
一、FPS 实时采样:PerfProbe
先要知道当前帧率。鸿蒙没有直接的"getCurrentFPS" API,自己做采样:
typescript
export class PerfProbe {
private windowMs: number
private frames: number = 0
private windowStart: number = 0
private lastFps: number = 60
private isPlaying: boolean = false
constructor(windowMs: number) {
this.windowMs = windowMs
this.windowStart = Date.now()
}
tick(): void {
this.frames += 1
const now = Date.now()
const elapsed = now - this.windowStart
if (elapsed >= this.windowMs) {
this.lastFps = Math.round((this.frames * 1000) / elapsed)
this.frames = 0
this.windowStart = now
}
}
setPlaying(playing: boolean): void {
this.isPlaying = playing
if (!playing) {
this.frames = 0
this.windowStart = Date.now()
}
}
sample(): PerfSample {
return { fps: this.lastFps, isPlaying: this.isPlaying }
}
}
滑动窗口 5 秒 (new PerfProbe(5000)):每 5 秒算一次 FPS。更短的窗口(1 秒)数据抖动太大,一次掉帧就触发降质;更长的窗口(10 秒)响应太慢,用户看到卡顿时还没调过来。5 秒是经验值。
调用点 :每帧 render 之前调一次 probe.tick()。GPU 粒子的 frameTick 自增、或者 setInterval(16) 的回调里。
typescript
// 父组件
aboutToAppear() {
this.rafId = setInterval(() => {
this.frameTick += 1
this.perfProbe.tick() // 👈 每帧 tick
if (this.frameTick % 5 === 0) {
// 每 5 帧判断一次是否要调质量
const sample = this.perfProbe.sample()
this.adaptRenderProfile(sample)
}
}, 16)
}
二、三档质量:high / balanced / low
真实代码用三档质量:
typescript
export type RenderQuality = 'high' | 'balanced' | 'low'
// high: 300 粒子 + 全部光效 + GPU 渲染
// balanced: 150 粒子 + 部分光效 + GPU 渲染
// low: 50 粒子 + 简化光效 + 可能走 Canvas fallback
为什么不是 2 档:
- 2 档(high / low):切换时体验落差大,用户一秒前流畅,下一秒粒子砍半
- 3 档(high / balanced / low):中间档作为缓冲,粒子砍到 150 比直接砍到 50 温和
为什么不是 5 档:
- 每档对应不同的 GPU shader 参数、粒子数、光效开关
- 档位越多配置越复杂,QA 成本翻倍
- 3 档已经能覆盖大多数设备的 FPS 分布
三、滞后窗口:避免抖动
朴素的降质逻辑:一帧低于阈值就降档。
typescript
// ❌ 坏做法
if (sample.fps < 50) {
this.quality = 'low' // 一帧低就降
}
if (sample.fps > 55) {
this.quality = 'high' // 一帧高就升
}
问题:FPS 在阈值附近抖动,用户看到画质在 "high ↔ balanced ↔ low" 之间来回切,比"稳定 low"还难受。
滞后窗口 (hysteresis):连续多个窗口低于阈值才降档 ,连续多个窗口高于阈值才升档。关键是降档的窗口数 < 升档的窗口数------下降"敏感",上升"保守":
typescript
// RootPage.ets:197
private adaptRenderProfile(sample: PerfSample): void {
if (!sample.isPlaying) {
this.lowFpsWindows = 0
this.highFpsWindows = 0
return
}
// 1. 分类当前窗口
if (sample.fps < 50) {
this.lowFpsWindows += 1
this.highFpsWindows = 0 // 低了就清掉"升"的计数
} else if (sample.fps > 57) {
this.highFpsWindows += 1
this.lowFpsWindows = 0 // 高了就清掉"降"的计数
} else {
// 50-57 中间带:既不升也不降,但清掉两个计数
this.lowFpsWindows = 0
this.highFpsWindows = 0
}
// 2. 降质:连续 2 个窗口低
if (this.lowFpsWindows >= 2) {
this.lowFpsWindows = 0
if (this.autoQualityCap === 'high') {
this.autoQualityCap = 'balanced'
} else if (this.autoQualityCap === 'balanced') {
this.autoQualityCap = 'low'
}
this.syncRenderProfile()
return
}
// 3. 升质:连续 3 个窗口高
if (this.highFpsWindows >= 3) {
this.highFpsWindows = 0
if (this.autoQualityCap === 'low') {
this.autoQualityCap = 'balanced'
} else if (this.autoQualityCap === 'balanced') {
this.autoQualityCap = 'high'
}
this.syncRenderProfile()
}
}
三个阈值:
- FPS < 50 → 低:目标 60,差距 10 容忍。连续 2 窗口 = 10 秒持续偏低,才降
- FPS > 57 → 高:目标 60,接近即可。连续 3 窗口 = 15 秒持续偏高,才升
- 50 ≤ FPS ≤ 57 → 中间带:既不升也不降。重置两个计数器,防止之前的"偏低"状态堆积
降档 2 窗口,升档 3 窗口 :降档敏感(10 秒出手),升档保守(15 秒出手)。因为用户对卡顿的感知比对升级的感知敏感 ------你从 low 升到 high 后两秒又掉下来,用户感觉"切换到 high 把我卡了"的锅是算在你头上的。慢点升省心。
中间带的处理(50 ≤ fps ≤ 57) :既不升也不降,而且清掉两个计数 。意思是中间带就是"合理区间",之前的"偏低"状态被这里的"正常"抹掉。不这样处理的话一次短时的"偏低 + 中间带波动"会误判为长期偏低。
四、运行时决定要不要走 Canvas Fallback
更极端的降级:从 GPU 渲染切到 Canvas 渲染。GPU 粒子就算调到 low(50 粒子)如果某个设备还是跑不动,再切 Canvas 版(本质是减少粒子 + 不用 GPU):
typescript
private usingCanvasFallback: boolean = false
// 在 adaptRenderProfile 里
if (this.autoQualityCap === 'low' && this.lowFpsWindows >= 2) {
// 已经到 low 还是不行,切 Canvas
this.usingCanvasFallback = true
this.logRenderAdapt('fallback to canvas')
}
UI 层根据 usingCanvasFallback 决定渲染哪个组件:
typescript
build() {
if (this.usingCanvasFallback) {
ParticleLayer({ /* Canvas 版 */ })
} else {
GpuParticleLayer({ /* GPU 版 */ })
}
}
切换成本 :GPU → Canvas 的切换会丢一帧(GPU surface 销毁 + Canvas 组件挂载)。但只在真的卡到不行的边界 case 触发,用户感知度低。
不要反向切回 GPU。一旦走 Canvas fallback,这个 session 内就一直用 Canvas------反复 GPU/Canvas 切换的 EGL context 管理很复杂,不值得。
五、FORCE_SAFE_RENDER_MODE 的 debug 开关
真实代码的开头:
typescript
private static readonly FORCE_SAFE_RENDER_MODE: boolean = false
private adaptRenderProfile(sample: PerfSample): void {
if (RootPage.FORCE_SAFE_RENDER_MODE) {
if (!this.usingCanvasFallback) {
this.usingCanvasFallback = true
}
if (this.autoQualityCap !== 'low') {
this.autoQualityCap = 'low'
}
this.syncRenderProfile()
return
}
// 正常的自适应逻辑
// ...
}
一个硬编码开关 :true 的话强制 low + Canvas。生产环境永远 false,但有以下场景需要开:
- 自动化测试:别让 FPS 自适应干扰 UI 测试的确定性
- 调试模式:开发者想看 Canvas 版的渲染效果
- 机型兼容性问题:某个特定机型发现 GPU 粒子崩溃,紧急配一个 "Force Safe"
- A/B 测试:对比 GPU vs Canvas 的留存差异
保留这个开关的理由:不留的话紧急情况下要重新编译发版才能禁用 GPU,太慢。留一个 const 可以通过远程配置动态下发(将来需要)。
六、syncRenderProfile 下发到 UI 层
autoQualityCap 变了之后,要把新 quality 推到 GpuParticleLayer:
typescript
private syncRenderProfile(): void {
// 把 autoQualityCap 推到 @State
this.renderQuality = this.autoQualityCap
// 粒子密度跟随 quality
this.particleCount = this.particleCountForQuality(this.renderQuality)
this.enableHighEffects = this.renderQuality === 'high'
}
private particleCountForQuality(quality: RenderQuality): number {
switch (quality) {
case 'high': return 300
case 'balanced': return 150
case 'low': return 50
}
}
renderQuality 是 @State,变化自动触发 GpuParticleLayer 的重渲染(通过 @Prop @Watch)。GpuParticleLayer 的 renderFrame 调用携带新的 particleCount,C++ 侧看到参数变了就调整渲染。
踩坑清单
- FPS 采样用 5 秒滑动窗口(更短抖动大,更长响应慢)
- 质量档位 3 档刚好(high / balanced / low)------ 2 档落差大,5 档太复杂
- 滞后窗口降抖:阈值 FPS < 50 低 / FPS > 57 高 / 50-57 中间带
- 降档 2 窗口,升档 3 窗口(下降敏感,上升保守)
- 中间带要清掉两个计数,防止"短偏低+中间带波动"误判
- 从 low 再往下切 Canvas fallback,但不要反向切回 GPU
- 留一个 FORCE_SAFE_RENDER_MODE 硬编码开关,紧急禁用用
尾声
FPS 自适应降质的 pattern 不只对粒子渲染适用。想到的其他场景:
- 列表虚拟化的 overscan 数量:高 FPS 开 20 个 overscan item,低 FPS 砍到 5 个
- 图片质量:高 FPS 走 4K,低 FPS 走 1080P
- 动画 easing 曲线复杂度:高 FPS 用 cubic-bezier,低 FPS 用 linear
- 视频播放码率:低 FPS = 设备弱 = 降码率
抽象起来就是 :监控一个运行时指标 + 滞后窗口判断 + 分档调整某个资源参数 。做任何"性能敏感的 app"时都该考虑这招。
一个意外经验:滞后窗口比"阈值触发"稳得多。做了几版都是"一帧低就降"结果用户反馈"画质在跳",加了滞后窗口之后再没收到类似反馈。看起来是小 trick 实际是关键。