# SetHeadphoneEQPreset (/zh-CN/api-reference/rtc/unreal-blueprint/api-irtcengine-setheadphoneeqpreset)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="api_irtcengine_setheadphoneeqpreset__prototype"></a>

```cpp
UFUNCTION(BlueprintCallable, Category = "Agora|IRtcEngine")
	int SetHeadphoneEQPreset(FENUMWRAP_HEADPHONE_EQUALIZER_PRESET preset);
```

<a id="api_irtcengine_setheadphoneeqpreset__detailed_desc"></a>

## 详情 [#详情]

该方法主要应用于空间音频场景下，你可以选择预设的耳机均衡器收听音频，以达到预期的音频体验。

:::note
注： 如果你使用的耳机已经具备良好的均衡效果，调用该方法时可能不会获得明显的体验提升效果，甚至可能导致体验下降。
:::

<a id="api_irtcengine_setheadphoneeqpreset__parameters"></a>

## 参数 [#参数]

<ParameterList>
<a id="preset"></a>
<Parameter name="preset">

预设的耳机均衡效果。详见 [FENUMWRAP_HEADPHONE_EQUALIZER_PRESET](/zh-CN/api-reference/rtc/unreal-blueprint/enum-headphoneequalizerpreset)。

</Parameter>
</ParameterList>

<a id="api_irtcengine_setheadphoneeqpreset__return_values"></a>

## 返回值 [#返回值]

- 0: 方法调用成功。
- &lt; 0: 方法调用失败

  - -1：一般性的错误（未明确归类）。

### 所属接口类 [#所属接口类]

- [IRtcEngine](/zh-CN/api-reference/rtc/unreal-blueprint/rtc-interface-class#class_irtcengine)