2026-03-26 01:58:45 +08:00
|
|
|
|
# SetSpatialize
|
|
|
|
|
|
|
|
|
|
|
|
**所属类**: `AudioSourceComponent`
|
|
|
|
|
|
|
|
|
|
|
|
**头文件**: `XCEngine/Components/AudioSourceComponent.h`
|
|
|
|
|
|
|
|
|
|
|
|
**描述**: 设置音频源是否启用3D空间化。
|
|
|
|
|
|
|
|
|
|
|
|
## 函数签名
|
|
|
|
|
|
|
|
|
|
|
|
```cpp
|
|
|
|
|
|
void SetSpatialize(bool spatialize);
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 参数
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 描述 |
|
|
|
|
|
|
|------|------|------|
|
|
|
|
|
|
| `spatialize` | `bool` | true 启用3D空间化，false 禁用（2D模式） |
|
|
|
|
|
|
|
|
|
|
|
|
## 使用示例
|
|
|
|
|
|
|
|
|
|
|
|
```cpp
|
|
|
|
|
|
#include <XCEngine/Components/AudioSourceComponent.h>
|
|
|
|
|
|
|
|
|
|
|
|
using namespace XCEngine::Components;
|
|
|
|
|
|
|
|
|
|
|
|
void SetupSpatialize(AudioSourceComponent* source) {
|
|
|
|
|
|
// 启用3D空间化（环境音）
|
|
|
|
|
|
source->SetSpatialize(true);
|
|
|
|
|
|
|
|
|
|
|
|
// 禁用3D空间化（UI音效）
|
|
|
|
|
|
source->SetSpatialize(false);
|
|
|
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 相关文档
|
|
|
|
|
|
|
2026-03-26 02:00:45 +08:00
|
|
|
|
- [AudioSourceComponent](audio-source-component.md) - 音频源组件
|
|
|
|
|
|
- [IsSpatialize](is-spatialize.md) - 检查是否启用空间化
|
