Files
XCEngine/docs/api/resources/audio-loader/index.md
ssdfasd 6af872e9eb docs: fix Resources module API docs naming conventions and broken links
- Rename constructor/destructor files to follow template spec:
  - ctor.md → constructor.md, dtor.md → destructor.md (audioclip)
  - texture_constructor.md → constructor.md, texture_destructor.md → destructor.md (texture)
  - material-loader-constructor.md → constructor.md, material-loader-destructor.md → destructor.md

- Create missing constructor/destructor docs:
  - audio-loader: constructor.md, destructor.md
  - texture-loader: constructor.md, destructor.md

- Fix broken links to ResourceManager:
  - shader-loader/index.md
  - material-loader/index.md

- Remove duplicate folders (keep hyphenated versions):
  - Delete shaderloader/ (keep shader-loader/)
  - Delete resourcepackage/ (keep resource-package/)
  - Merge textureimportsettings/ into texture-import-settings/

- Rename audio-loader method files:
  - canload.md → can-load.md
  - getdefaultsettings.md → get-default-settings.md
  - getsupportedextensions.md → get-supported-extensions.md

- Update overview pages with proper method links and constructor/destructor entries
2026-03-22 14:42:27 +08:00

1.9 KiB

AudioLoader

命名空间

XCEngine::Resources

类型

类 (Class)

描述

音频资源加载器,负责从文件系统加载音频文件并转换为 AudioClip 资源。支持 WAV、OGG、MP3、FLAC、AIFF 等常见音频格式。

概述

AudioLoader 继承自 IResourceLoader 接口,实现音频资源的异步加载与格式解析。内部通过文件扩展名和文件头数据双重检测确定音频格式,确保加载结果的准确性。

公共方法表格

方法 返回值 描述
AudioLoader - 构造函数
~AudioLoader - 析构函数
GetResourceType ResourceType 返回资源类型 AudioClip
GetSupportedExtensions Array<String> 获取支持的扩展名列表
CanLoad bool 检查是否能够加载指定路径的资源
Load LoadResult 加载音频资源
GetDefaultSettings ImportSettings* 获取默认导入设置

使用示例

#include "Resources/AudioLoader.h"
#include "Resources/ResourceManager.h"

using namespace XCEngine::Resources;

// 通过 ResourceManager 加载音频
ResourceGUID guid = ResourceGUID::Generate("assets/audio/bgm_music.ogg");
LoadResult result = ResourceManager::Get().Load(guid, "assets/audio/bgm_music.ogg");

if (result.IsSuccess()) {
    AudioClip* clip = result.GetResource<AudioClip>();
    // 使用音频片段
}

相关文档