Files

ssdfasd 161a0896d5 docs: 添加 Audio 模块和 Components 模块 API 文档

- 新增 Audio 模块文档 (54 个文件)
  - AudioSystem 单例类及 20 个方法页
  - AudioMixer 混音器类及 11 个方法页
  - IAudioBackend、IAudioEffect 接口
  - FFTFilter、Reverbation、Equalizer、HRTF 效果类
  - WASAPIBackend Windows 后端
  - AudioConfig、Audio3DParams 等结构体
  - 9 个枚举类型文档
- 新增 Components 模块文档 (3 个文件)
  - AudioSourceComponent 音频源组件
  - AudioListenerComponent 音频监听器组件
- 更新 docs/api/main.md 添加模块导航

2026-03-22 01:56:16 +08:00

2.0 KiB

Raw Blame History

HRTF

命名空间: XCEngine::Audio

类型: class

头文件: XCEngine/Audio/HRTF.h

描述: 基于头部相关传输函数（Head-Related Transfer Function）的 3D 空间音频处理器。

概述

HRTF 实现了基于头部相关传输函数（Head-Related Transfer Function）的 3D 空间音频算法。它通过计算声音的耳间时间差（ITD）、耳间电平差（ILD）和耳廓线索（Pinna Cues），在双耳耳机或扬声器上重现逼真的 3D 空间音效。支持多普勒效应、交叉馈送（Cross-feed）调节和质量级别设置。

公共方法

方法	描述
`HRTF`	构造函数
`~HRTF`	析构函数
`ProcessAudio`	处理 3D 空间化音频
`SetEnabled`	设置启用状态
`IsEnabled`	检查启用状态
`SetHRTFEnabled`	设置 HRTF 处理启用状态
`IsHRTFEnabled`	检查 HRTF 处理启用状态
`SetQualityLevel`	设置质量级别
`GetQualityLevel`	获取质量级别
`SetCrossFeed`	设置交叉馈送值
`GetCrossFeed`	获取交叉馈送值
`SetDopplerShiftEnabled`	设置多普勒效应启用状态
`IsDopplerShiftEnabled`	检查多普勒效应启用状态
`SetSpeedOfSound`	设置声速
`GetSpeedOfSound`	获取声速

使用示例

#include <XCEngine/Audio/HRTF.h>

using namespace XCEngine::Audio;

void SetupHRTF() {
    HRTF* hrtf = new HRTF();
    hrtf->SetHRTFEnabled(true);
    hrtf->SetQualityLevel(2);
    hrtf->SetCrossFeed(0.2f);
    hrtf->SetDopplerShiftEnabled(true);
    hrtf->SetSpeedOfSound(343.0f);
}

2.0 KiB Raw Blame History Unescape Escape

HRTF

概述

公共方法

使用示例

相关文档

2.0 KiB

Raw Blame History