.NET MAUI类库中访问音频资源失败问题求助

1. 清理项目文件的重复配置 #

你的类库项目文件存在重复的资源配置，这会导致打包冲突。同时纯net8.0类库默认不启用MAUI资源系统，需要显式开启。修改后的项目文件如下：

<PropertyGroup>
  <TargetFramework>net8.0</TargetFramework>
  <ImplicitUsings>enable</ImplicitUsings>
  <Nullable>enable</Nullable>
  <!-- 启用MAUI资源系统，类库才能正确处理MauiAsset -->
  <UseMaui>true</UseMaui>
</PropertyGroup>

<ItemGroup>
    <!-- 批量移除Raw文件夹下所有文件的默认None配置 -->
    <None Remove="Resources\Raw\**" />
</ItemGroup>

<ItemGroup>
    <!-- 通配符配置确保资源不带Resources\Raw前缀打包到根目录 -->
    <MauiAsset Include="Resources\Raw\**" LogicalName="%(Filename)%(Extension)" />
</ItemGroup>

2. 修正资源访问逻辑 #

核心问题点： #

• 构造函数内不能直接使用await，需将资源加载逻辑移至异步方法
• 空引用异常大概率是audioManager未初始化，或资源流返回null，必须增加检查

修改后的代码：

private IAudioPlayer playerStartSound;

// 异步初始化音频资源，在应用启动阶段调用
public async Task InitializeAudioAsync()
{
    // 先确认audioManager已初始化
    if (audioManager == null)
        throw new InvalidOperationException("audioManager未完成初始化");

    // 直接用文件名访问，因为资源已打包到包目录根路径
    using var audioStream = await FileSystem.OpenAppPackageFileAsync("record-start.mp3");
    
    if (audioStream == null)
        throw new FileNotFoundException("未找到音频文件：record-start.mp3");

    playerStartSound = audioManager.CreatePlayer(audioStream);
}

3. 排查验证步骤 #

• 检查iOS主应用的打包产物：在bin/Debug/net8.0-ios/[设备标识]/[App名称].app目录下，确认record-start.mp3是否存在
• 确保类库以ProjectReference方式被主MAUI应用引用，而非NuGet包（未打包的情况下）

4. 备选方案：嵌入式资源 #

如果MauiAsset方式仍有问题，可切换为嵌入式资源：

1. 将音频文件的生成操作改为EmbeddedResource
2. 通过类库程序集加载资源：

var assembly = typeof(SpeechHandler).Assembly;
// 资源名称格式：[类库命名空间].[文件夹层级].[文件名]
using var stream = assembly.GetManifestResourceStream("SpeechLib.Resources.Raw.record-start.mp3");

if (stream == null)
    throw new FileNotFoundException("未找到嵌入式音频资源");

playerStartSound = audioManager.CreatePlayer(stream);

内容的提问来源于stack exchange，提问作者Gratzy