【Qt开发】Qt系统（十一）-＞ Qt 音频

文章目录

• [1 -> 概述](#1 -> 概述)
• [2 -> QSound 类基础概念](#2 -> QSound 类基础概念)
• • [2.1 -> 功能定位](#2.1 -> 功能定位)
  • [2.2 -> 格式限制](#2.2 -> 格式限制)
  • [2.3 -> 模块依赖](#2.3 -> 模块依赖)
• [3 -> QSound 核心 API 详解](#3 -> QSound 核心 API 详解)
• • [3.1 -> 构造函数](#3.1 -> 构造函数)
  • [3.2 -> 播放控制方法](#3.2 -> 播放控制方法)
  • [3.3 -> 静态方法](#3.3 -> 静态方法)
  • [3.4 -> 信号](#3.4 -> 信号)
• [4 -> 使用注意事项](#4 -> 使用注意事项)
• • [4.1 -> 音频文件准备](#4.1 -> 音频文件准备)
  • [4.2 -> 资源管理](#4.2 -> 资源管理)
  • [4.3 -> 播放时机](#4.3 -> 播放时机)
  • [4.4 -> 平台差异](#4.4 -> 平台差异)
• [5 -> 代码示例](#5 -> 代码示例)
• [6 -> 总结](#6 -> 总结)

---

1 -> 概述

在 Qt 框架中，音频处理是多媒体应用开发的重要组成部分。Qt 提供了丰富的音频类，帮助开发者轻松实现音频播放、录制、处理等功能。其中，QSound 类是用于播放简单音频文件的基础类，特别适用于播放提示音、简短音效等场景。虽然功能相对简单，但它在不需要复杂控制的场景中非常高效和易用。

Qt 音频模块（multimedia）不仅包含 QSound，还提供了如 QMediaPlayer、QAudioOutput、QAudioInput 等更强大的类，支持音频流处理、格式转换、音量控制等高级功能。不过，对于只需播放简单音频文件的场景，QSound 是一个轻量且便捷的选择。

2 -> QSound 类基础概念

2.1 -> 功能定位

QSound 类主要用于播放 .wav 格式的音频文件。它是一个高级封装类，适用于不需要精细控制播放过程（如暂停、跳转、混音）的场景。由于其实现简单，资源占用少，常用于界面交互反馈、系统提示音等场合。

2.2 -> 格式限制

需要注意的是，QSound 仅支持 WAV 格式音频 。WAV 是一种无损音频格式，通常文件体积较大，但在音质和兼容性上表现良好。如果你手头的音频文件是 MP3、AAC、OGG 等其他格式，需要先转换为 WAV 格式才能使用 QSound 播放。

2.3 -> 模块依赖

使用 QSound 类需要在 Qt 项目文件（.pro）中添加 multimedia 模块：

QT += core gui multimedia

否则编译时会提示找不到相关头文件。

3 -> QSound 核心 API 详解

3.1 -> 构造函数

QSound 提供了多种构造函数，常见形式如下：

• QSound(const QString &filename, QObject *parent = nullptr)
  通过文件路径创建音频对象，支持资源文件路径（如 ":/sound.wav"）或本地文件路径。

3.2 -> 播放控制方法

• play()

  开始播放音频。如果音频正在播放，则从头重新播放。该方法是非阻塞的，即调用后会立即返回，不会等待播放结束。

• stop()

  停止播放当前音频。

• setLoops(int number)

  设置音频循环播放次数。若设为 QSound::Infinite 则表示无限循环。

• isFinished() const

  判断音频是否播放完毕。

3.3 -> 静态方法

• static bool isAvailable()

  检查系统是否支持音频播放功能。

• static void play(const QString &filename)

  直接播放指定音频文件，无需创建对象。适用于一次性音效播放。

3.4 -> 信号

• finished()
  音频播放结束时发出此信号，可用于触发后续操作。

4 -> 使用注意事项

4.1 -> 音频文件准备

确保音频文件为 WAV 格式，且采样率、位深等参数与系统兼容。建议使用标准 PCM 编码的 WAV 文件，以保证跨平台兼容性。

4.2 -> 资源管理

如果音频文件嵌入到程序中，建议将其添加到 Qt 资源系统（.qrc 文件），便于管理和发布。

4.3 -> 播放时机

QSound 适合播放短音频（通常不超过几秒），长音频建议使用 QMediaPlayer，后者支持更多格式和播放控制功能。

4.4 -> 平台差异

在不同操作系统上，QSound 的底层实现可能不同（如 Windows 使用 PlaySound，macOS 使用 NSSound），但接口保持一致，开发者无需关心底层差异。

5 -> 代码示例

widget.h

 #ifndef WIDGET_H
#define WIDGET_H

#include <QWidget>
#include <QSound>

QT_BEGIN_NAMESPACE
namespace Ui { class Widget; }
QT_END_NAMESPACE

class Widget : public QWidget
{
    Q_OBJECT

public:
    Widget(QWidget *parent = nullptr);
    ~Widget();

private slots:
    void on_pushButton_clicked();

private:
    Ui::Widget *ui;

    QSound* sound;
};
#endif // WIDGET_H

widget.cpp

#include "widget.h"
#include "ui_widget.h"

Widget::Widget(QWidget *parent)
    : QWidget(parent)
    , ui(new Ui::Widget)
{
    ui->setupUi(this);

    sound = new QSound(":/manbo.wav", this);

}

Widget::~Widget()
{
    delete ui;
}


void Widget::on_pushButton_clicked()
{
    sound->play();
}

6 -> 总结

QSound 类是 Qt 中处理简单音频播放的理想工具，特别适合于播放界面音效、提示音等短音频场景。其优势在于：

• 使用简单，无需复杂配置
• 资源占用小
• 跨平台一致性好

然而，由于其仅支持 WAV 格式且功能较为基础，若项目中涉及音频格式转换、流媒体播放、音频可视化等高级功能，建议使用 QMediaPlayer 或 QAudioDevice 等更强大的类。

总之，在 Qt 音频编程中，根据实际需求选择合适的类至关重要。QSound 作为入门级音频播放类，为开发者提供了一个轻量、便捷的音频解决方案，是快速实现音频反馈功能的不二之选。

---

感谢各位大佬支持！！！
互三啦！！！