2026-03-26 01:58:45 +08:00
|
|
|
|
# SetPan
|
|
|
|
|
|
|
|
|
|
|
|
**所属类**: `AudioSourceComponent`
|
|
|
|
|
|
|
|
|
|
|
|
**头文件**: `XCEngine/Components/AudioSourceComponent.h`
|
|
|
|
|
|
|
|
|
|
|
|
**描述**: 设置音频源的平移值（左右声道分布）。
|
|
|
|
|
|
|
|
|
|
|
|
## 函数签名
|
|
|
|
|
|
|
|
|
|
|
|
```cpp
|
|
|
|
|
|
void SetPan(float pan);
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 参数
|
|
|
|
|
|
|
|
|
|
|
|
| 参数 | 类型 | 描述 |
|
|
|
|
|
|
|------|------|------|
|
|
|
|
|
|
| `pan` | `float` | 平移值，-1.0 表示完全左声道，0.0 表示居中，1.0 表示完全右声道 |
|
|
|
|
|
|
|
|
|
|
|
|
## 使用示例
|
|
|
|
|
|
|
|
|
|
|
|
```cpp
|
|
|
|
|
|
#include <XCEngine/Components/AudioSourceComponent.h>
|
|
|
|
|
|
|
|
|
|
|
|
using namespace XCEngine::Components;
|
|
|
|
|
|
|
|
|
|
|
|
void SetupPan(AudioSourceComponent* source) {
|
|
|
|
|
|
// 居中
|
|
|
|
|
|
source->SetPan(0.0f);
|
|
|
|
|
|
|
|
|
|
|
|
// 偏左
|
|
|
|
|
|
source->SetPan(-0.5f);
|
|
|
|
|
|
|
|
|
|
|
|
// 偏右
|
|
|
|
|
|
source->SetPan(0.5f);
|
|
|
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 相关文档
|
|
|
|
|
|
|
2026-03-26 02:00:45 +08:00
|
|
|
|
- [AudioSourceComponent](audio-source-component.md) - 音频源组件
|
|
|
|
|
|
- [GetPan](get-pan.md) - 获取平移值
|
