USoundWave

好的 ✅ 我来按照你指定的 Notion 笔记格式，分别为 USoundWave 和 USoundCue 输出两份完整的笔记。

🎮 Unreal Engine - USoundWave

🏛 定义

USoundWave 是 音频数据的基本资源类，表示一段实际的声音波形数据（通常来自 .wav 文件）。它存储了音频的采样率、声道数、时长等底层信息，是引擎中最常见的 声音资产类型。

📚 类继承

UObject
└── USoundBase
    └── USoundWave

⚡ 关键特性

• 📦 存储原始音频数据（PCM 或压缩格式）
• 🎶 支持单声道、多声道音频
• 🛠️ 可用于 3D 空间定位（结合 AudioComponent）
• ⚙️ 提供波形可视化与音频分析能力
• 🔗 可以作为 Sound Cue 的输入节点

⚙️ 常见配置

• Sound Group：声音分组（UI、Music、SFX 等）
• Looping：是否循环播放
• Sample Rate：采样率（如 44100 Hz）
• Channels：声道数（Mono、Stereo）
• Duration：音频时长
• Streaming：是否以流式方式播放

🛠️ 使用方法

📦 直接播放

• 将 USoundWave 拖拽到场景中生成 AudioComponent
• 或者使用 UGameplayStatics::PlaySoundAtLocation() 直接播放

🔗 结合 Sound Cue

• 将 USoundWave 作为 输入节点，构建更复杂的音频逻辑

🏊 典型应用场景

• 🎶 背景音乐播放
• 🎵 角色语音对白
• 🎇 音效（枪声、爆炸、环境音）
• 🎧 测试与调试音频

🤖 与其他组件对比

• USoundWave vs USoundCue
  • USoundWave：存储和播放单一音频数据
  • USoundCue：组合多个声音、逻辑与效果的容器

❌ 常见问题与注意事项

• ❌ 文件过大：未压缩的 WAV 文件体积可能过大，影响打包
• ❌ 多平台兼容性：部分平台对音频格式有限制
• ✅ 建议通过 Sound Cue 管理和优化 SoundWave 使用

📝 小结

• ✅ USoundWave 是最基础的音频资源类
• ✅ 适合用于存储和播放单一音频片段
• ✅ 通常与 AudioComponent 或 Sound Cue 搭配使用
• ✅ 在游戏开发中，主要负责声音的“数据层”