Files
XCEngine/docs/api/components/audio-source-component/get-duration.md
ssdfasd 8df04c120f 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 文档
2026-03-26 01:58:45 +08:00

39 lines
827 B
Markdown

# 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) - 设置音频片段