Files
XCEngine/docs/api/audio/audio-system/get-stats.md

40 lines
1.1 KiB
Markdown
Raw Normal View History

# AudioSystem::GetStats
获取音频系统统计信息。
```cpp
const Stats& GetStats() const;
```
返回包含音频系统运行时统计信息的结构体,包括活跃源数量、总源数量、内存使用量和 CPU 使用率。
**返回:** `const Stats&` - 统计信息结构体引用
**Stats 结构体:**
| 成员 | 类型 | 描述 |
|------|------|------|
| `activeSources` | `uint32_t` | 当前正在播放的音频源数量 |
| `totalSources` | `uint32_t` | 注册的音频源总数 |
| `memoryUsage` | `uint64_t` | 音频系统内存使用量(字节) |
| `cpuUsage` | `float` | CPU 使用率估算值 |
**示例:**
```cpp
#include <XCEngine/Audio/AudioSystem.h>
using namespace XCEngine::Audio;
void PrintAudioStats() {
const auto& stats = AudioSystem::Get().GetStats();
printf("Active sources: %u / %u\n", stats.activeSources, stats.totalSources);
printf("Memory usage: %.2f MB\n", stats.memoryUsage / (1024.0 * 1024.0));
printf("CPU usage: %.1f%%\n", stats.cpuUsage * 100.0f);
}
```
## 相关文档
- [AudioSystem 总览](audio-system.md)