HarmonyOS ArkTS 做动画 FPS 自适应降级的滞后窗口做法

鸿蒙上做 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 实际是关键。

相关推荐
用户978876053904812 分钟前
Canvas 处理大图时如何不卡住主线程:一次浏览器端批量压缩的调度实践
前端
鶴哥只手遮天15 分钟前
# 《Electron 45.2.3 内核解剖》第 6 章 Node.js 集成:两个事件循环的婚姻
前端·electron·开源
bai27316 分钟前
别再手动刷后台了:用原生 CDP 给 4 个内容平台做登录态保活心跳
前端
工程小白菜35 分钟前
AI 生成的代码谁来验收?从 Copilot 到 WorkBuddy 的三个实践
前端·ai编程
我不会起名字3221 小时前
仅 Web 主动 ping:30 秒读超时与各平台保活
前端·后端·websocket·go·即时通讯·im·故障排查
徐小夕1 小时前
CADViewer-Skill:让 Agent 原生支持 DWG 解析、可视化图统计、图纸导出
前端·vue.js·github
Mh1 小时前
AI 的模型能力越来越强,为什么我的编码能力越来越弱?
前端·javascript·后端
deli0071 小时前
1 万条数据渲染卡成 PPT?虚拟列表把 DOM 从 10000 降到 24
前端
jay神2 小时前
基于 YOLOv8 的传送带异物检测系统(Web 版)
前端·人工智能·深度学习·yolo·计算机视觉·计算机毕业设计