粒子动画
====

[粒子动画](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-particle-animation)是通过在限定区域内随机生成大量粒子的运动，进而组合成的动画效果，通过Particle组件来实现。动画的基本构成元素为单个粒子，这些粒子可以表现为圆点或图片等形式。开发者能够通过对粒子在颜色、透明度、大小、速度、加速度、自旋角度等多个维度上的动态变化做动画，以营造特定的氛围，例如模拟下雪场景时，飘舞的雪花实际上是由一个个雪花粒子的动画效果所构成。

粒子动画的简单实现如下所示。

@Entry
@Component
struct ParticleExample {
  build() {
    Stack() {
      Text()
        .width(300).height(300).backgroundColor('rgb(240, 250, 255)')
      Particle({ particles: \[
        {
          emitter: {
            particle: {
              type: ParticleType.POINT, // 粒子类型
              config: {
                radius: 5 // 圆点半径
              },
              count: 100, // 粒子总数
            },
          },
          color:{
            range:\['rgb(39, 135, 217)','rgb(0, 74, 175)'\], // 初始颜色范围
          },
        },
      \]
      }).width(250).height(250)
    }.width('100%').height('100%').align(Alignment.Center)
  }
}

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/c3/v3/K0j8SvZ1Tu2vGslzmxXjmg/zh-cn_image_0000002594668182.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073311Z&HW-CC-Expire=86400&HW-CC-Sign=0C30FA59D6DB87EBA5E63886FE15093F7CE1CAB69F8B77F54272A1F0B446D113)

#### 实现粒子发射器

粒子发射器（Particle Emitter）主要定义粒子的初始属性（如类型和位置），控制粒子的生成速率，以及管理粒子的生命周期。可通过[emitter](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-particle-animation#emitter12)方法调整粒子发射器的位置、发射速率和发射窗口的大小，实现发射器位置的动态更新。

// ...
@State emitterProperties: Array<EmitterProperty> = \[
  {
    index: 0,
    emitRate: 100,
    position: { x: 60, y: 80 },
    size: { width: 200, height: 200 }
  }
\]

Particle(...).width(300).height(300).emitter(this.emitterProperties) // 动态调整粒子发射器的位置
// ...

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/dd/v3/uog9wk93SIypKM2u0i2yVg/zh-cn_image_0000002594828110.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073311Z&HW-CC-Expire=86400&HW-CC-Sign=D168CB687ACF5A957EBDB0E566F2BE03B2DA8A13EEBAF73DD246837BE3F2C6BD)

#### 设置粒子颜色

可以通过[range](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-particle-animation#particlecolorpropertyoptions)来确定粒子的初始颜色范围，而[distributionType](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-particle-animation#particlecolorpropertyoptions)则用于指定粒子初始颜色随机值的分布方式，具体可选择均匀分布或者高斯（正态）分布。

// ...
color: {
  range: \['rgb(39, 135, 217)','rgb(0, 74, 175)'\], // 初始颜色范围
  distributionType: DistributionType.GAUSSIAN // 初始颜色随机值分布
},
// ...

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/4b/v3/gdatArOgR0S8fPbLi0MTTA/zh-cn_image_0000002625187557.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073311Z&HW-CC-Expire=86400&HW-CC-Sign=041881F2329098C77B349274A9AD17E4C57F9B30E4F87D673D938623FF120CEC)

#### 粒子的生命周期

粒子的生命周期（Lifecycle）是粒子从生成至消亡的整个过程，用于确定粒子的存活时间长度。粒子的生命周期可通过设置[EmitterParticleOptions](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-particle-animation#emitterparticleoptions18)的lifetime和lifetimeRange属性来指定。

// ...
emitter: {
  particle: {
    // ...
    lifetime: 300, // 粒子生命周期，单位ms
    lifetimeRange: 100 // 粒子生命周期取值范围，单位ms
  },
  emitRate: 10, // 每秒发射粒子数
  position: \[0, 0\],
  shape: ParticleEmitterShape.RECTANGLE // 发射器形状
},
color: {
  range: \['rgb(39, 135, 217)','rgb(0, 74, 175)'\], // 初始颜色范围
},
// ...

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/34/v3/CCb2J8GxReGPbixZPnOlrw/zh-cn_image_0000002625107701.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073311Z&HW-CC-Expire=86400&HW-CC-Sign=55A98FC50ED960236B9DA1FC4BBEB09FDDBDAE1647D6CD4AC01F7FBE3BB5DD1D)

#### 设置粒子扰动场

扰动场（Disturbance Field）是一种影响粒子运动的机制。通过在粒子所在的空间区域内施加特定的力，扰动场能够改变粒子的轨迹和行为，进而实现更为复杂和自然的动画效果。扰动场的配置可以通过[disturbanceFields](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/ts-particle-animation#disturbancefields12)方法来完成。

// ...
Particle({ particles: \[
  {
    emitter: // ...
    color: // ...
    scale: {
      range: \[0.0, 0.0\],
      updater: {
        type: ParticleUpdater.CURVE,
        config: \[
          {
            from: 0.0,
            to: 0.5,
            startMillis: 0,
            endMillis: 3000,
            curve: Curve.EaseIn
          }
        \]
      }
    },
    acceleration: { // 加速度的配置，从大小和方向两个维度变化，speed表示加速度大小，angle表示加速度方向
      speed: {
        range: \[3, 9\],
        updater: {
          type: ParticleUpdater.RANDOM,
          config: \[1, 20\]
        }
      },
      angle: {
        range: \[90, 90\]
      }
    }

  }
\]
}).width(300).height(300).disturbanceFields(\[{
  strength: 10,
  shape: DisturbanceFieldShape.RECT,
  size: { width: 100, height: 100 },
  position: { x: 100, y: 100 },
  feather: 15,
  noiseScale: 10,
  noiseFrequency: 15,
  noiseAmplitude: 5
}\])
// ...

![](https://contentcenter-vali-drcn.dbankcdn.cn/pvt_2/DeveloperAlliance_scene_100_1/d6/v3/SymQ7GToRaSRqjFsUfLgvw/zh-cn_image_0000002594668184.gif?HW-CC-KV=V1&HW-CC-Date=20260612T073311Z&HW-CC-Expire=86400&HW-CC-Sign=54782B0A7FEAEF65FC5A5266C4BD375D30CB91846918EDAC749DCE04C99DFCBE)