XCEngine/docs/api/components/audio-source-component/set-pitch.md

# SetPitch

**所属类**: `AudioSourceComponent`

**头文件**: `XCEngine/Components/AudioSourceComponent.h`

**描述**: 设置音频源的音高。

## 函数签名

```cpp
void SetPitch(float pitch);
```

## 参数

| 参数 | 类型 | 描述 |
|------|------|------|
| `pitch` | `float` | 音高，0.5 表示半速，1.0 表示正常速度，2.0 表示双倍速度 |

## 使用示例

```cpp
#include <XCEngine/Components/AudioSourceComponent.h>

using namespace XCEngine::Components;

void SetupPitch(AudioSourceComponent* source) {
    // 正常音高
    source->SetPitch(1.0f);

    // 低八度
    source->SetPitch(0.5f);

    // 高八度
    source->SetPitch(2.0f);
}
```

## 相关文档

- [AudioSourceComponent](audio-source-component.md) - 音频源组件
- [GetPitch](get-pitch.md) - 获取音高