Android平台下Qt的SoundEffect组件无法播放WAV音效求助

问题根源 #

你遇到的E AudioSystem: invalid attributes...错误，本质是Android平台的SoundEffect组件不支持Qt资源系统（qrc://路径），必须使用设备本地文件系统的路径。MediaPlayer能播放是因为它兼容资源路径，但频繁播放时延迟过高，所以必须切换到SoundEffect并调整资源部署方式。

用CMake部署音频文件到APK #

1. 修改CMakeLists.txt #

把音频文件复制到APK的assets目录（应用安装后会自动解压到/data/data/[你的包名]/files/目录下），在项目的CMakeLists.txt中添加以下代码：

# 定义你的音频文件列表，根据实际路径调整
set(AUDIO_FILES
    audio/click.wav
    audio/beep.ogg
)

if(ANDROID)
    # 逐个复制音频文件到assets目录
    foreach(audio_file ${AUDIO_FILES})
        add_custom_command(
            OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/assets/${audio_file}
            COMMAND ${CMAKE_COMMAND} -E copy ${CMAKE_CURRENT_SOURCE_DIR}/${audio_file} ${CMAKE_CURRENT_BINARY_DIR}/assets/${audio_file}
            DEPENDS ${CMAKE_CURRENT_SOURCE_DIR}/${audio_file}
        )
        list(APPEND ASSET_OUTPUTS ${CMAKE_CURRENT_BINARY_DIR}/assets/${audio_file})
    endforeach()

    # 创建自定义目标确保编译时执行复制
    add_custom_target(copy_audio_assets ALL DEPENDS ${ASSET_OUTPUTS})
    add_dependencies(${PROJECT_NAME} copy_audio_assets)
endif()

2. 获取本地文件路径 #

在代码中获取音频文件的实际路径：

• C++方式：通过QStandardPaths获取应用数据目录，拼接文件名：

#include <QStandardPaths>

QString getAudioFilePath(const QString& relativePath) {
    return QStandardPaths::writableLocation(QStandardPaths::AppDataLocation) + "/" + relativePath;
}

可以把这个路径通过setContextProperty暴露给QML使用。

• QML方式：直接使用Qt.labs.platform模块的StandardPaths：

import Qt.labs.platform 1.1

SoundEffect {
    id: clickSound
    source: StandardPaths.writableLocation(StandardPaths.AppDataLocation) + "/audio/click.wav"
}

3. 验证SoundEffect配置 #

确保音频格式符合要求（优先用WAV、OGG这类低延迟格式，避免MP3），并检查路径是否正确：

SoundEffect {
    id: beepSound
    source: "/data/data/com.yourcompany.yourapp/files/audio/beep.ogg" // 也可以用动态获取的路径
    volume: 0.7
}

额外检查项 #

• 确认音频文件本身无损坏，用普通播放器测试能正常播放
• 检查AndroidManifest.xml是否包含必要权限（Qt 6通常自动添加，无需手动修改，若有问题可添加<uses-permission android:name="android.permission.WAKE_LOCK"/>防止播放时设备休眠）

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