c++在线音乐播放器项目开发记录(2)

前言

因为放寒假了，时间比较短，想找实习也不好找，干脆在家加强一下技术栈，首先从c++学起，最适合练手的就是qt的项目了，我是根据B站视频【5个C/C++硬核简历项目实战，可直接写入简历，包含：Qt项目、音视频流媒体开发、后端开发、DPDK网络编程、KV存储、Linux内核。总有一个实战项目适合你！】来进行学习的，这篇文章主要是记录一下在跟视频做的过程中，自己的学习体会和问题的解决思路。

项目已上传至Github:https://github.com/MengFanjun020906/OnlineMusic

1.主窗口添加功能

1.1 进度条控件美化

 // 播放进度条控件美化
    ui->horizontalSlider_PlayProgress->setStyleSheet("QSlider::groove:horizontal {"
                                                     "    border: 1px solid #bbb;"
                                                     "    background: white;"
                                                     "    height: 10px;"
                                                     "    border-radius: 5px;"
                                                     "}"
                                                     "QSlider::sub-page:horizontal {"
                                                     "    background: qlineargradient(x1: 0, y1: 0, x2: 0, y2: 1, stop: 0 #66e, stop: 1 #bbf);"
                                                     "    border: 1px solid #777;"
                                                     "    height: 10px;"
                                                     "    border-radius: 5px;"
                                                     "}"
                                                     "QSlider::add-page:horizontal {"
                                                     "    background: #fff;"
                                                     "    border: 1px solid #777;"
                                                     "    height: 10px;"
                                                     "    border-radius: 5px;"
                                                     "}"
                                                     "QSlider::handle:horizontal {"
                                                     "    background: qlineargradient(x1:0, y1:0, x2:1, y2:1, stop:0 #eee, stop:1 #ccc);"
                                                     "    border: 1px solid #777;"
                                                     "    width: 18px;"
                                                     "    margin-top: -4px;"
                                                     "    margin-bottom: -4px;"
                                                     "    border-radius: 9px;"
                                                     "}");


    ui->horizontalSlider_Volume->setStyleSheet("QSlider::groove:horizontal {"
                                                     "    border: 1px solid #bbb;"
                                                     "    background: white;"
                                                     "    height: 10px;"
                                                     "    border-radius: 5px;"
                                                     "}"
                                                     "QSlider::sub-page:horizontal {"
                                                     "    background: qlineargradient(x1: 0, y1: 0, x2: 0, y2: 1, stop: 0 #66e, stop: 1 #bbf);"
                                                     "    border: 1px solid #777;"
                                                     "    height: 10px;"
                                                     "    border-radius: 5px;"
                                                     "}"
                                                     "QSlider::add-page:horizontal {"
                                                     "    background: #fff;"
                                                     "    border: 1px solid #777;"
                                                     "    height: 10px;"
                                                     "    border-radius: 5px;"
                                                     "}"
                                                     "QSlider::handle:horizontal {"
                                                     "    background: qlineargradient(x1:0, y1:0, x2:1, y2:1, stop:0 #eee, stop:1 #ccc);"
                                                     "    border: 1px solid #777;"
                                                     "    width: 18px;"
                                                     "    margin-top: -4px;"
                                                     "    margin-bottom: -4px;"
                                                     "    border-radius: 9px;"
                                                     "}");

实现的效果如下，虽然也不是特别好看，但是效果比原来的好看得多。

1.2 初始化多媒体实例

因为qt6的MediaPlayList被移除了，所以需要我们自己写playlist的相关函数和头文件，但如果是qt5的话，这个类就可以正常使用

    //将光标焦点定位到搜索歌曲名称的控件
    ui->lineEdit_InputSong->setFocus();

    //初始化
    NetworkAccessManager = new QNetworkAccessManager(this);

    iPos=0;

    //初始文本对象
    docTextObject = ui->plainTextEdit_SongList->document();

    //将控件设置为只读
    ui->plainTextEdit_SongList->setReadOnly(true);

    //初始化多媒体实例
    p_PlayerObject=new QMediaPlayer(this);
    //p_PlayerList = new
    Playlist *p_PlayList = new Playlist(this);

    //设置播放模式
    p_PlayList->setPlaybackMode(Playlist::Loop);

    //信号与槽处理如下
    connect(p_PlayerObject,SIGNAL(positionChanged(qint64)),this,SLOT(HandleLCDNumberTimeChangeFunc(qint64)));
    connect(p_PlayerObject,SIGNAL(positionChanged(qint64)),this,SLOT(HandlePositionChangeFunc(qint64)));
    connect(p_PlayerObject,SIGNAL(positionChanged(qint64)),this,SLOT(HandleProgressTimeChangeFunc(qint64)));
    connect(NetworkAccessManager,SIGNAL(finished(QNetworkReply*)),this,SLOT(HandleDataBackFunc(QNetworkReply*)));

2.搜索歌曲显示歌手功能

这个函数是 OnlineMusicWidget 类的一个槽函数，它会在 pushButton_SearchSong 按钮被点击时触发。其主要功能是根据用户在 lineEdit_InputSong 输入框中输入的歌曲名称，向网易云音乐的搜索 API 发送一个 GET 请求，以获取相关歌曲的搜索结果。

void OnlineMusicWidget::HandleDataBackFunc(QNetworkReply *pReply)
{
    //读取网络回款数据
    QByteArySearchInfo = pReply->readAll();

    QJsonParseError JSonPError;//定义错误信息对象

    //将json文本转换为json文件对象
    QJsonDocument JSonDoc_RecvData=QJsonDocument::fromJson(QByteArySearchInfo,&JSonPError);
    if(JSonPError.error!=QJsonParseError::NoError)//判断是否符合规则
    {
        QMessageBox::critical(this,"Prompt","提示：获取歌曲json出错，请重新检查",QMessageBox::Yes);
        return;
    }
    //QJsonObject使用函数object();
    QJsonObject TotalJsonObject = JSonDoc_RecvData.object();

    //列出json里面的所有key
    QStringList strKeys=TotalJsonObject.keys();

    if(strKeys.contains("result"))//与数据信息
    {
        //将带有result的数据内容提取之后转换为对象
        QJsonObject resultobject=TotalJsonObject["result"].toObject();

        //存储所有keys
        QStringList strResultKeys=resultobject.keys();

        if(strResultKeys.contains("songs"))
        {
            QJsonArray array=resultobject["songs"].toArray();

            //通过for循环查找歌曲当中的字段信息
            for(auto isong:array)
            {
                QJsonObject jsonobject1 = isong.toObject();
                //获取歌曲ID 歌名 歌手
                I_MusicID = jsonobject1["id"].toInt();
                StrMusicName = jsonobject1["name"].toString();


                QStringList strkeys = jsonobject1.keys();

                if(strkeys.contains("artists"))
                {
                    QJsonArray artitstsjsonarray= jsonobject1["artists"].toArray();
                    for(auto js:artitstsjsonarray)
                    {
                        QJsonObject jsonobject2=js.toObject();
                        StrSingerName = jsonobject2["name"].toString();
                    }
                }
            }
        }

    }
    // 生成歌曲 URL
    QString url = QString("https://music.163.com/song/media/outer/url?id=%0").arg(I_MusicID);

    // 创建一个 QVariantMap 并将歌曲 URL 存储在 "path" 键下
    QVariantMap song;
    song["path"] = url;
    // 调用 appendSong 函数将歌曲添加到播放列表
    p_PlayList->appendSong(song);

    ui->plainTextEdit_SongList->appendPlainText(StrMusicName+"-"+StrSingerName);
}
//搜索歌曲名称实现
void OnlineMusicWidget::on_pushButton_SearchSong_clicked()
{
    QString str1,str2;
    str1=ui->lineEdit_InputSong->text();


    str2="http://music.163.com/api/search/get/web?csrf_token=hlpretag=&hlposttag=&s={"+str1+"}&type=1&offset=0&total=true&limit=1";

    //定义一个请求对象
    QNetworkRequest networkRequest;
    networkRequest.setUrl(str2);

    //将请求格式设置给对应请求对象
    networkRequest.setUrl(str2);
    //使用QNetworkAccessManager类对应的API发送GET请求并获取响应数据



    NetworkAccessManager->get(networkRequest);

}

3.播放功能

3.1 播放按钮播放

从回传的id去获取歌曲的url，但是需要注意的是，VIP歌曲不能播放，网易云的网页版和APP版还不一样，网页版连试听都没有，我再搜岁歌曲的时候，发现怎么着都播放不出来，选几首比较冷门的歌，才发现原来问题是没有开vip。

//播放歌曲
void OnlineMusicWidget::on_pushButton_PlaySong_clicked()
{




    qDebug() << "播放列表内容：" << playList;
    qDebug() << "当前播放索引：" << currentIndex;
    qDebug() << "播放器状态：" << p_PlayerObject->playbackState();
    qDebug() << "[Debug] 当前播放器状态：" << p_PlayerObject->playbackState();

    // 1. 处理空播放列表
    if (playList.isEmpty()) {
        QMessageBox::warning(this, "错误", "播放列表为空");
        return;
    }

    // 2. 自动定位到第一首
    if (currentIndex == -1) {
        currentIndex = 0;
    }

    // 3. 核心逻辑
    switch (p_PlayerObject->playbackState()) {
    case QMediaPlayer::StoppedState:  // 停止状态
    case QMediaPlayer::PausedState:   // 暂停状态
        // 只有源文件变化时才重新设置
        if (p_PlayerObject->source() != playList[currentIndex]) {
            p_PlayerObject->setSource(playList[currentIndex]);
        }
        p_PlayerObject->play();
        //ui->pushButton_PlaySong->setText("暂停");
        break;

    case QMediaPlayer::PlayingState:  // 正在播放
        p_PlayerObject->pause();
        //ui->pushButton_PlaySong->setText("播放");
        break;

    default:  // 无媒体或错误状态
        p_PlayerObject->setSource(playList[currentIndex]);
        p_PlayerObject->play();
        //ui->pushButton_PlaySong->setText("暂停");
        break;
    }
}

3.2 暂停与停止功能

这里直接调用PlayerObject的函数即可

//暂停播放
void OnlineMusicWidget::on_pushButton_PauseSong_clicked()
{
    // 只有正在播放时才能暂停
    if (p_PlayerObject->playbackState() == QMediaPlayer::PlayingState) {
        p_PlayerObject->pause();
        //ui->pushButton_PlaySong->setText("播放"); // 同步更新播放按钮状态
        qDebug() << "音乐已暂停";
    }
}

//停止播放
void OnlineMusicWidget::on_pushButton_StopPlaySong_clicked()
{
    if (p_PlayerObject->playbackState() != QMediaPlayer::StoppedState) {
        p_PlayerObject->stop();
        //ui->pushButton_PlaySong->setText("播放");  // 强制更新播放按钮状态
        qDebug() << "音乐已停止";
    }
}

3.3 上一曲与下一曲的切换

//播放上一曲
void OnlineMusicWidget::on_pushButton_PreviousSong_clicked()
{

    if (playList.isEmpty()) {
        QMessageBox::warning(this, "提示", "播放列表为空");
        return;
    }


    // 计算新索引（支持循环）
    currentIndex = (currentIndex - 1 + playList.size()) % playList.size();

    // 设置新播放源
    p_PlayerObject->setSource(playList[currentIndex]);

    // 自动开始播放
    p_PlayerObject->play();
    qDebug() << "上一曲";


}

//播放下一曲
void OnlineMusicWidget::on_pushButton_NextSong_2_clicked()
{
    if (playList.isEmpty()) {
        QMessageBox::warning(this, "提示", "播放列表为空");
        return;
    }

    // 计算新索引（支持循环）
    currentIndex = (currentIndex + 1) % playList.size();

    // 设置新播放源
    p_PlayerObject->setSource(playList[currentIndex]);

    // 自动开始播放
    p_PlayerObject->play();
    qDebug() << "下一曲";

}

4.音量控制

静音实现

void OnlineMusicWidget::on_pushButton_SoundYesNo_clicked()
{
    QAudioOutput* audioOutput = p_PlayerObject->audioOutput();

    if (isMuted) {
        // 取消静音，恢复之前音量
        audioOutput->setMuted(false);
        audioOutput->setVolume(previousVolume);
        ui->horizontalSlider_Volume->setValue(previousVolume * 100);
        ui->pushButton_SoundYesNo->setIcon(QIcon(":/new/prefix1/Images/MSound.png"));
        qDebug() << "取消静音，恢复音量到：" << previousVolume;
    } else {
        // 记录当前音量并静音
        previousVolume = audioOutput->volume();
        audioOutput->setMuted(true);
        ui->pushButton_SoundYesNo->setIcon(QIcon(":/new/prefix1/Images/MNoSound.png"));
        qDebug() << "静音，原音量：" << previousVolume;
    }

    isMuted = !isMuted;  // 切换状态

}

拖动滑块改变歌曲音量

//音量控制
void OnlineMusicWidget::on_horizontalSlider_Volume_valueChanged(int value)
{
    QAudioOutput* audioOutput = p_PlayerObject->audioOutput();

    // 将滑块值（0-100）转换为浮点音量（0.0-1.0）
    qreal volume = qBound(0.0, value / 100.0, 1.0);
    audioOutput->setVolume(volume);

    // 同步静音状态
    if (volume > 0 && audioOutput->isMuted()) {
        audioOutput->setMuted(false);
        ui->pushButton_SoundYesNo->setIcon(QIcon(":/new/prefix1/Images/MSound.png"));
        isMuted = false;
    }


}

5.歌曲时间显示

在进度条右侧的LCD数字会显示歌曲的时长

//处理LCD控件时间变化
void OnlineMusicWidget::HandleLCDNumberTimeChangeFunc(qint64 duration)
{
    int int_Second=duration/1000;
    int int_Minute=int_Second/60;
    int_Second=int_Second%60;
    QString strSongTime=QString::asprintf("%d:%d",int_Minute,int_Second);
    ui->lcdNumber_PlayTime->display(strSongTime);
}

歌曲的进度条会随着播放而变化

// 处理进度条控件变化
void OnlineMusicWidget::HandleProgressTimeChangeFunc(qint64 duration)
{
    //设置进度条最大值
    ui->horizontalSlider_PlayProgress->setMaximum(duration);
}