Particle 挂载 ≠ 显示：emitRate/count 真实语义与同帧黑缝（HarmonyOS ArkUI）
现象： 做粒子消散效果时时间对不上------"图片消失跑在飞散粒子前面"；去掉底图垫底后，波浪经过的每一行都闪一下黑。
原因： emitRate 默认 5（每秒产生 5 个粒子），emitRate:1 + count:1 时唯一颗粒子挂载后 ∈0,\~1s 才出生；粒子组件挂载 ≠ 首帧渲染（下个 vsync 才绘制，滞后 1-2 帧）；静态行与飞行行同帧交接必闪黑。
解决： "挂载即显示"要求 emitRate ≥100（首粒 ≤10ms 出生）；黑缝两解------静态行延迟 50ms 卸载（换防交接缓冲），或粒子速度 0,0 出生静止 + 加速度曲线延迟点火。
坑11：emitRate 的出生延迟
emitRate 的定义在 particle.d.ts:725------每秒产生的粒子数，默认 5。
三个易混参数的真实语义：
| 参数 | 真实语义 | 易混点 |
|---|---|---|
| emitRate | 每秒出生 N 个粒子（默认 5） | 被误当"每次发射数" |
| count | 发射总数上限 | 被误当"每次发射数"------B 卡 emitRate:15 + count:120 若按"每次发射数"算是 1800 粒/秒，荒谬 |
| lifetime | 每颗粒子的寿命 | ------ |
时间错位实案：emitRate:1 + count:1 时，唯一颗粒子按"每秒 1 个"的节奏消耗预算，出生延迟 0~1000ms；而消散三预设的波浪间隔（waveGap）只有 50~120ms------出生延迟量级碾压波浪间隔，时间必然错位。emitRate 提到 100（首粒 ≤10ms 出生，≈挂载同帧）并保持 count:1 封顶防糊面，真机确认"同步了"。
实用公式：发射持续时间 = count ÷ emitRate------emitRate 100 + count 3 = 30ms 爆发；emitRate 20 + count 6 = 300ms 连喷。想要"挂载即显示"，emitRate ≥100。
坑12：同帧交接黑缝
消散效果去底图垫底（纯碎片）后，波浪经过的每一行闪黑。根因：粒子组件挂载 ≠ 首帧渲染------发射 ≤10ms 完成，但粒子系统下个 vsync 才绘制（滞后 1-2 帧）；静态行同帧卸载，该行就黑 1-2 帧。有底图垫底时黑帧被盖住，纯属掩盖而非解决（对照层会掩盖时序缺陷）。
两条修复路线，均真机验收通过：
- 延迟卸载（换防交接缓冲）：静态行滞后波浪 50ms（约 3 帧）卸载，重叠期静态/飞行两份渲染像素完全重合------肉眼零闪缝
- 延迟点火：单粒子速度 0,0 出生即静止，加速度 CURVE 按行序点火（梯形 A=4V，起始 startMillis=行延迟 D），从结构上消灭换防
两条路线的选型对比与延迟点火细节，见华为社区篇《HarmonyOS 照片消散特效：延迟卸载 vs 延迟点火双路线真机对照》。
标签
#HarmonyOS #ArkUI #Particle #emitRate #粒子特效 #时序
📹 效果演示 ：本文的「粒子消散」动态效果实录会发在抖音------号 581821159（天行健之初九），截图看不出的粒子细节，视频一眼就懂。
懿路向前 · AI辅助整理 · 2026-10-12