Files
XCEngine/docs/api/resources/audio-loader/index.md

1.8 KiB

AudioLoader

命名空间

XCEngine::Resources

类型

类 (Class)

描述

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

概述

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

公共方法表格

方法 返回值 描述
AudioLoader() - 构造函数
~AudioLoader() - 析构函数
GetResourceType() ResourceType 返回资源类型 AudioClip
GetSupportedExtensions() Array<String> 获取支持的扩展名列表
CanLoad(path) bool 检查是否能够加载指定路径的资源
Load(path, settings) 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>();
    // 使用音频片段
}

相关文档