当前位置：首页 > news >正文

Qt6相册应用开发实战：从Qt5到Qt6的迁移与音频播放实现

news 2026/3/27 6:30:07

Qt6相册应用开发实战：从Qt5到Qt6的迁移与音频播放实现

项目简介

Album是一个基于Qt6开发的功能完整的相册应用，旨在提供用户友好的图片管理和查看体验。该应用支持创建相册项目、导入图片、查看图片详情、幻灯片播放等功能，同时提供背景音乐支持，为用户带来更加沉浸式的相册体验。

项目GitHub地址： https://github.com/zhiliye/qt6-album

功能特性

相册项目管理：创建、打开和管理多个相册项目
图片导入：支持批量导入图片到相册项目
图片查看：查看图片详情，支持缩放、旋转等操作
幻灯片播放：自动播放相册中的图片，支持自定义播放速度
背景音乐：在幻灯片播放时添加背景音乐，支持循环播放
图片预览：底部预览栏，方便快速切换图片
响应式设计：适配不同屏幕尺寸

技术栈

Qt 6.9.1：使用最新的Qt6框架，利用其强大的GUI和多媒体功能
C++11：使用现代C++标准，确保代码的可读性和可维护性
MSVC 2022：使用最新的Visual Studio编译器，确保编译效率和代码质量

项目结构

├── album/             # 存放项目图片
├── build/             # 构建目录
├── icon/              # 应用图标和资源文件
├── music/             # 背景音乐文件
├── style/             # 样式文件
├── *.cpp              # 源文件
├── *.h                # 头文件
├── *.ui               # UI文件
├── Album.pro          # 项目文件
├── README.md          # 项目说明文档
└── .gitignore         # Git忽略文件配置

编译与运行

前提条件

Qt 6.9.1 或更高版本
MSVC 2022 或兼容的编译器
Qt Creator（推荐）或其他支持Qt的IDE

编译步骤

克隆仓库：

git clone https://github.com/zhiliye/qt6-album.git
cd qt6-album

使用Qt Creator打开项目：
- 启动Qt Creator
- 选择"File" -> "Open File or Project"
- 浏览并选择Album.pro文件
- 点击"Open"
配置构建套件：
- 在弹出的"Configure Project"对话框中，选择合适的构建套件（如"Desktop Qt 6.9.1 MSVC2022 64bit"）
- 点击"Configure Project"
构建项目：
- 点击Qt Creator左下角的"Build"按钮（或按下Ctrl+B）
- 等待构建完成
运行应用：
- 点击Qt Creator左下角的"Run"按钮（或按下Ctrl+R）
- 应用将启动并显示主界面

使用说明

创建相册项目

点击主界面上的"创建项目"按钮
输入项目名称和保存路径
点击"确定"按钮

导入图片

选择一个相册项目
点击"导入图片"按钮
选择要导入的图片文件
点击"打开"按钮

查看图片

在相册项目中选择一张图片
图片将在右侧预览区域显示
使用鼠标滚轮或工具栏按钮进行缩放
右键点击图片可进行旋转操作

幻灯片播放

选择一个相册项目
点击"幻灯片播放"按钮
图片将自动播放
点击播放界面可暂停/继续播放
使用左右箭头键切换图片

添加背景音乐

在幻灯片播放界面点击"音乐"按钮
选择要播放的音乐文件
音乐将在幻灯片播放时循环播放

Qt6迁移重点：多媒体模块变更

QMediaPlaylist的移除

在Qt6中，QMediaPlaylist类被移除，这给相册应用的播放列表功能带来了挑战。我们通过以下方式实现了自定义播放列表：

private:QMediaPlayer *_player;QList<QUrl> _playlist;int _currentIndex;public slots:void SlotMediaStatusChanged(QMediaPlayer::MediaStatus status);

自定义播放列表实现

使用QList<QUrl>替代QMediaPlaylist，通过mediaStatusChanged信号实现循环播放：

void ProTreeWidget::SlotMediaStatusChanged(QMediaPlayer::MediaStatus status)
{if (status == QMediaPlayer::EndOfMedia && !_playlist.isEmpty()){_currentIndex = (_currentIndex + 1) % _playlist.size();_player->setSource(_playlist[_currentIndex]);_player->play();}
}

Qt6音频播放实现：QAudioOutput的使用

问题背景

在Qt 6中，QMediaPlayer的音频播放机制发生了重大变化。与Qt 5不同，Qt 6中QMediaPlayer不再内置音频输出功能，需要显式设置QAudioOutput对象才能播放声音。

解决方案

我们需要添加QAudioOutput的包含和声明：

#include <QtMultimedia/QAudioOutput>

在ProTreeWidget类中添加成员变量：

QAudioOutput *_audioOutput;

在构造函数中初始化音频输出：

_player = new QMediaPlayer(this);
_audioOutput = new QAudioOutput(this);
_player->setAudioOutput(_audioOutput);
_audioOutput->setVolume(0.5); // 设置音量为50%

错误处理和日志

为了便于调试，我们添加了详细的错误处理和日志输出：

connect(_player, &QMediaPlayer::errorOccurred, this, [=](QMediaPlayer::Error error, const QString &errorString) {qDebug() << "Media player error: " << error << " " << errorString << Qt::endl;
});
connect(_player, &QMediaPlayer::playbackStateChanged, this, [=](QMediaPlayer::PlaybackState state) {qDebug() << "Playback state changed: " << state << Qt::endl;
});