docs: 更新 API 文档 - 多模块修复和完善

- audio: 更新 audio-system 方法文档
- components: 新增 audio-listener/audio-source 组件方法文档，新增 remove-component 方法
- core: 更新 filewriter, types 文档
- math: 更新 box 方法文档
- memory: 更新 proxy-allocator 文档
- resources: 更新 loader 和 texture 文档
- rhi: 更新 opengl 设备、shader、swap-chain 文档
- threading: 更新 mutex 和 task-system 文档

docs/api/components/audio-source-component/get-3d-params.md

@@ -0,0 +1,38 @@
+# Get3DParams
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 获取音频源的3D音频参数。
+
+## 函数签名
+
+```cpp
+const Audio::Audio3DParams& Get3DParams() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `const Audio::Audio3DParams&` | 3D音频参数引用 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void Print3DParams(AudioSourceComponent* source) {
+    const auto& params = source->Get3DParams();
+    printf("Doppler: %.2f, Spread: %.2f, ReverbZoneMix: %.2f\n",
+           params.dopplerLevel, params.spread, params.reverbZoneMix);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [Set3DParams](./set-3d-params.md) - 设置3D参数

docs/api/components/audio-source-component/get-clip.md

@@ -0,0 +1,41 @@
+# GetClip
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 获取音频源当前播放的音频片段。
+
+## 函数签名
+
+```cpp
+Resources::AudioClip* GetClip() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `Resources::AudioClip*` | 音频片段指针，如果未设置则返回 nullptr |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void CheckCurrentClip(AudioSourceComponent* source) {
+    auto clip = source->GetClip();
+    if (clip) {
+        printf("Current clip: %s\n", clip->GetName().c_str());
+    } else {
+        printf("No clip set\n");
+    }
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [SetClip](./set-clip.md) - 设置音频片段

docs/api/components/audio-source-component/get-doppler-level.md

@@ -0,0 +1,37 @@
+# GetDopplerLevel
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 获取音频源的多普勒效应等级。
+
+## 函数签名
+
+```cpp
+float GetDopplerLevel() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 当前多普勒等级 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintDopplerLevel(AudioSourceComponent* source) {
+    float level = source->GetDopplerLevel();
+    printf("Doppler level: %.2f\n", level);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [SetDopplerLevel](./set-doppler-level.md) - 设置多普勒等级

docs/api/components/audio-source-component/get-duration.md

@@ -0,0 +1,38 @@
+# GetDuration
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 获取音频源当前音频的总时长。
+
+## 函数签名
+
+```cpp
+float GetDuration() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 音频总时长，单位秒。如果没有设置音频片段则返回 0.0 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintDuration(AudioSourceComponent* source) {
+    float duration = source->GetDuration();
+    printf("Duration: %.2f seconds\n", duration);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [GetTime](./get-time.md) - 获取当前播放位置
+- [SetClip](./set-clip.md) - 设置音频片段

docs/api/components/audio-source-component/get-output-mixer.md

@@ -0,0 +1,41 @@
+# GetOutputMixer
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 获取音频源的输出混音器。
+
+## 函数签名
+
+```cpp
+Audio::AudioMixer* GetOutputMixer() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `Audio::AudioMixer*` | 输出混音器指针，如果未设置则返回 nullptr |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void CheckOutputMixer(AudioSourceComponent* source) {
+    auto* mixer = source->GetOutputMixer();
+    if (mixer) {
+        printf("Output mixer is set\n");
+    } else {
+        printf("Using default output\n");
+    }
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [SetOutputMixer](./set-output-mixer.md) - 设置输出混音器

docs/api/components/audio-source-component/get-pan.md

@@ -0,0 +1,37 @@
+# GetPan
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 获取音频源的平移值。
+
+## 函数签名
+
+```cpp
+float GetPan() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 当前平移值，-1.0 到 1.0 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintPan(AudioSourceComponent* source) {
+    float pan = source->GetPan();
+    printf("Pan: %.2f\n", pan);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [SetPan](./set-pan.md) - 设置平移值

docs/api/components/audio-source-component/get-pitch.md

@@ -0,0 +1,37 @@
+# GetPitch
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 获取音频源的音高。
+
+## 函数签名
+
+```cpp
+float GetPitch() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 当前音高，1.0 为正常速度 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintPitch(AudioSourceComponent* source) {
+    float pitch = source->GetPitch();
+    printf("Pitch: %.2f\n", pitch);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [SetPitch](./set-pitch.md) - 设置音高

docs/api/components/audio-source-component/get-reverb-zone-mix.md

@@ -0,0 +1,37 @@
+# GetReverbZoneMix
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 获取音频源的混响区域混合比例。
+
+## 函数签名
+
+```cpp
+float GetReverbZoneMix() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 当前混响混合比例，0.0 到 1.0 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintReverbZoneMix(AudioSourceComponent* source) {
+    float mix = source->GetReverbZoneMix();
+    printf("Reverb zone mix: %.2f\n", mix);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [SetReverbZoneMix](./set-reverb-zone-mix.md) - 设置混响混合比例

docs/api/components/audio-source-component/get-spread.md

@@ -0,0 +1,37 @@
+# GetSpread
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 获取音频源的扩散角度。
+
+## 函数签名
+
+```cpp
+float GetSpread() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 当前扩散角度（度） |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintSpread(AudioSourceComponent* source) {
+    float spread = source->GetSpread();
+    printf("Spread: %.1f degrees\n", spread);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [SetSpread](./set-spread.md) - 设置扩散角度

docs/api/components/audio-source-component/get-time.md

@@ -0,0 +1,39 @@
+# GetTime
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 获取音频源当前的播放位置。
+
+## 函数签名
+
+```cpp
+float GetTime() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 当前播放位置，单位秒 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintCurrentTime(AudioSourceComponent* source) {
+    float time = source->GetTime();
+    float duration = source->GetDuration();
+    printf("%.1f / %.1f seconds\n", time, duration);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [SetTime](./set-time.md) - 设置播放位置
+- [GetDuration](./get-duration.md) - 获取总时长

docs/api/components/audio-source-component/get-volume.md

@@ -0,0 +1,37 @@
+# GetVolume
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 获取音频源的音量。
+
+## 函数签名
+
+```cpp
+float GetVolume() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `float` | 当前音量，范围 0.0 到 1.0 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void PrintVolume(AudioSourceComponent* source) {
+    float volume = source->GetVolume();
+    printf("Volume: %.2f\n", volume);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [SetVolume](./set-volume.md) - 设置音量

docs/api/components/audio-source-component/is-energy-detecting.md

@@ -0,0 +1,41 @@
+# IsEnergyDetecting
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 检查音频能量检测是否处于活跃状态。
+
+## 函数签名
+
+```cpp
+bool IsEnergyDetecting() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `bool` | true 表示正在检测能量，false 表示未检测 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void CheckEnergyDetection(AudioSourceComponent* source) {
+    if (source->IsEnergyDetecting()) {
+        float energy = source->GetEnergy();
+        printf("Current energy: %.2f\n", energy);
+    }
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [StartEnergyDetect](./start-energy-detect.md) - 开始能量检测
+- [StopEnergyDetect](./stop-energy-detect.md) - 停止能量检测
+- [GetEnergy](./get-energy.md) - 获取当前能量值

docs/api/components/audio-source-component/is-looping.md

@@ -0,0 +1,38 @@
+# IsLooping
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 检查音频源是否设置为循环播放。
+
+## 函数签名
+
+```cpp
+bool IsLooping() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `bool` | true 表示循环播放，false 表示播放一次后停止 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void CheckLoopingStatus(AudioSourceComponent* source) {
+    if (source->IsLooping()) {
+        printf("Audio is looping\n");
+    }
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [SetLooping](./set-looping.md) - 设置循环播放

docs/api/components/audio-source-component/is-paused.md

@@ -0,0 +1,38 @@
+# IsPaused
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 检查音频源是否处于暂停状态。
+
+## 函数签名
+
+```cpp
+bool IsPaused() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `bool` | true 表示已暂停，false 表示未暂停 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void CheckPausedStatus(AudioSourceComponent* source) {
+    if (source->IsPaused()) {
+        printf("Audio is paused\n");
+    }
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [IsPlaying](./is-playing.md) - 检查是否正在播放

docs/api/components/audio-source-component/is-playing.md

@@ -0,0 +1,40 @@
+# IsPlaying
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 检查音频源是否正在播放。
+
+## 函数签名
+
+```cpp
+bool IsPlaying() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `bool` | true 表示正在播放，false 表示未在播放 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void CheckPlayingStatus(AudioSourceComponent* source) {
+    if (source->IsPlaying()) {
+        printf("Audio is playing\n");
+    } else {
+        printf("Audio is not playing\n");
+    }
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [IsPaused](./is-paused.md) - 检查是否暂停

docs/api/components/audio-source-component/is-spatialize.md

@@ -0,0 +1,38 @@
+# IsSpatialize
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 检查音频源是否启用3D空间化。
+
+## 函数签名
+
+```cpp
+bool IsSpatialize() const;
+```
+
+## 返回值
+
+| 类型 | 描述 |
+|------|------|
+| `bool` | true 表示启用3D空间化，false 表示禁用 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void CheckSpatializeStatus(AudioSourceComponent* source) {
+    if (source->IsSpatialize()) {
+        printf("3D spatialization is enabled\n");
+    }
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [SetSpatialize](./set-spatialize.md) - 设置空间化

docs/api/components/audio-source-component/pause.md

@@ -0,0 +1,31 @@
+# Pause
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 暂停音频播放。
+
+## 函数签名
+
+```cpp
+void Pause();
+```
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void PauseAudio(AudioSourceComponent* source) {
+    source->Pause();
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [Play](./play.md) - 开始播放
+- [Stop](./stop.md) - 停止播放

docs/api/components/audio-source-component/play.md

@@ -0,0 +1,31 @@
+# Play
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 开始播放音频。
+
+## 函数签名
+
+```cpp
+void Play();
+```
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void StartPlayback(AudioSourceComponent* source) {
+    source->Play();
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [Pause](./pause.md) - 暂停播放
+- [Stop](./stop.md) - 停止播放

docs/api/components/audio-source-component/set-clip.md

@@ -0,0 +1,39 @@
+# SetClip
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 设置音频源播放的音频片段。
+
+## 函数签名
+
+```cpp
+void SetClip(Resources::AudioClip* clip);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `clip` | `Resources::AudioClip*` | 音频片段指针，设置为 nullptr 则清除当前片段 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+#include <XCEngine/Resources/AudioClip/AudioClip.h>
+
+using namespace XCEngine::Components;
+
+void LoadAndPlaySound(AudioSourceComponent* source) {
+    auto clip = Resources::AudioClip::Load("assets/audio/ explosion.wav");
+    source->SetClip(clip);
+    source->Play();
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [GetClip](./get-clip.md) - 获取当前音频片段

docs/api/components/audio-source-component/set-doppler-level.md

@@ -0,0 +1,36 @@
+# SetDopplerLevel
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 设置音频源的多普勒效应等级。
+
+## 函数签名
+
+```cpp
+void SetDopplerLevel(float level);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `level` | `float` | 多普勒等级，1.0 为默认值，0.0 禁用 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void SetupDoppler(AudioSourceComponent* source) {
+    source->SetDopplerLevel(1.0f);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [GetDopplerLevel](./get-doppler-level.md) - 获取多普勒等级

docs/api/components/audio-source-component/set-looping.md

@@ -0,0 +1,36 @@
+# SetLooping
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 设置音频源是否循环播放。
+
+## 函数签名
+
+```cpp
+void SetLooping(bool loop);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `loop` | `bool` | true 启用循环播放，false 播放一次后停止 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void SetupLooping(AudioSourceComponent* source, bool shouldLoop) {
+    source->SetLooping(shouldLoop);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [IsLooping](./is-looping.md) - 检查是否循环播放

docs/api/components/audio-source-component/set-pan.md

@@ -0,0 +1,43 @@
+# 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);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [GetPan](./get-pan.md) - 获取平移值

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

@@ -0,0 +1,43 @@
+# 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) - 获取音高

docs/api/components/audio-source-component/set-reverb-zone-mix.md

@@ -0,0 +1,43 @@
+# SetReverbZoneMix
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 设置混响区域混合比例。
+
+## 函数签名
+
+```cpp
+void SetReverbZoneMix(float mix);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `mix` | `float` | 混响混合比例，0.0 到 1.0，0.0 表示干声，1.0 表示完全混响 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void SetupReverbZoneMix(AudioSourceComponent* source) {
+    // 干声（无混响）
+    source->SetReverbZoneMix(0.0f);
+
+    // 半湿声
+    source->SetReverbZoneMix(0.5f);
+
+    // 完全混响
+    source->SetReverbZoneMix(1.0f);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [GetReverbZoneMix](./get-reverb-zone-mix.md) - 获取混响混合比例

docs/api/components/audio-source-component/set-spatialize.md

@@ -0,0 +1,40 @@
+# 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);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [IsSpatialize](./is-spatialize.md) - 检查是否启用空间化

docs/api/components/audio-source-component/set-spread.md

@@ -0,0 +1,43 @@
+# SetSpread
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 设置音频源的扩散角度。
+
+## 函数签名
+
+```cpp
+void SetSpread(float spread);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `spread` | `float` | 扩散角度，0.0 到 360.0 度，0 表示点声源，360 表示全向 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void SetupSpread(AudioSourceComponent* source) {
+    // 点声源
+    source->SetSpread(0.0f);
+
+    // 半全向
+    source->SetSpread(180.0f);
+
+    // 全向
+    source->SetSpread(360.0f);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [GetSpread](./get-spread.md) - 获取扩散角度

docs/api/components/audio-source-component/set-time.md

@@ -0,0 +1,41 @@
+# SetTime
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 设置音频源的当前播放位置。
+
+## 函数签名
+
+```cpp
+void SetTime(float seconds);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `seconds` | `float` | 播放位置，单位秒 |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void SeekToPosition(AudioSourceComponent* source, float seconds) {
+    source->SetTime(seconds);
+}
+
+void RewindToStart(AudioSourceComponent* source) {
+    source->SetTime(0.0f);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [GetTime](./get-time.md) - 获取当前播放位置
+- [GetDuration](./get-duration.md) - 获取总时长

docs/api/components/audio-source-component/start-energy-detect.md

@@ -0,0 +1,32 @@
+# StartEnergyDetect
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 开始音频能量检测。
+
+## 函数签名
+
+```cpp
+void StartEnergyDetect();
+```
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void BeginEnergyDetection(AudioSourceComponent* source) {
+    source->StartEnergyDetect();
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [StopEnergyDetect](./stop-energy-detect.md) - 停止能量检测
+- [IsEnergyDetecting](./is-energy-detecting.md) - 检查是否正在检测
+- [GetEnergy](./get-energy.md) - 获取当前能量值

docs/api/components/audio-source-component/stop-energy-detect.md

@@ -0,0 +1,31 @@
+# StopEnergyDetect
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 停止音频能量检测。
+
+## 函数签名
+
+```cpp
+void StopEnergyDetect();
+```
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+
+using namespace XCEngine::Components;
+
+void EndEnergyDetection(AudioSourceComponent* source) {
+    source->StopEnergyDetect();
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [StartEnergyDetect](./start-energy-detect.md) - 开始能量检测
+- [IsEnergyDetecting](./is-energy-detecting.md) - 检查是否正在检测

docs/api/components/audio-source-component/stop.md

@@ -0,0 +1,42 @@
+# Stop
+
+**所属类**: `AudioSourceComponent`
+
+**头文件**: `XCEngine/Components/AudioSourceComponent.h`
+
+**描述**: 停止音频播放。
+
+## 函数签名
+
+```cpp
+void Stop(Audio::StopMode mode = Audio::StopMode::Immediate);
+```
+
+## 参数
+
+| 参数 | 类型 | 描述 |
+|------|------|------|
+| `mode` | `Audio::StopMode` | 停止模式，默认为 Immediate（立即停止） |
+
+## 使用示例
+
+```cpp
+#include <XCEngine/Components/AudioSourceComponent.h>
+#include <XCEngine/Audio/AudioTypes.h>
+
+using namespace XCEngine::Components;
+
+void StopAudio(AudioSourceComponent* source) {
+    source->Stop(Audio::StopMode::Immediate);
+}
+
+void FadeOutAndStop(AudioSourceComponent* source) {
+    source->Stop(Audio::StopMode::FadeOut);
+}
+```
+
+## 相关文档
+
+- [AudioSourceComponent](./audio-source-component.md) - 音频源组件
+- [Play](./play.md) - 开始播放
+- [Pause](./pause.md) - 暂停播放