QMediaPlayer可以播放經過壓縮的音頻或視訊檔案，如mp3、mp4、wmv等檔案，QMediaPlayer可以播放單個檔案，也可以和QMediaPlaylist類結合，對一個播放清單進行播放。是以使用QMediaPlayer和QMediaPlaylist可以輕松地設計一個自己的音樂或視訊播放器。

1. QMediaPlayer類

QMediaPlayer的主要公共函數和槽函數見下表(省略了函數中的const關鍵字和預設參數)。

使用QMediaPlayer播放媒體檔案時，有幾個有用的信号可以反映播放狀态或檔案資訊。

stateChanged(QMediaPlayer::State state)信号，在調用play()、pause()和stop()函數時發射，反映播放器目前的狀态。枚舉類型QMediaPlayer::State有3種取值，表示播放器的狀态：
QMediaPlayer::StoppedState，停止狀态；
QMediaPlayer::PlayingState，正在播放；
QMediaPlayer::PausedState，暫停播放狀态。
durationChanged(qint64 duration)信号，在檔案的時間長度變化時發射，一般在切換播放檔案時發射。
positionChanged(qint64 position)信号，目前檔案播放位置變化時發射，可以反映檔案播放進度。

QMediaPlayer可以通過setMedia()函數設定播放單個檔案，也可以通過setPlaylist()函數設定一個QMediaPlaylist類執行個體表示的播放清單，對清單檔案進行播放，并且自動播放下一個檔案，或循環播放等。QMediaPlayer播放的檔案可以是本地檔案，也可以是網絡上的檔案。

QMediaPlaylist記錄播放媒體檔案資訊，可以添加、移除檔案，也可以設定循環播放形式，在清單檔案中自動切換檔案。在目前播放檔案切換時會發射currentIndexChanged()信号和currentMediaChange()信号。

使用QMediaPlayer和QMediaPlaylist的這些功能，可以實作一個完整功能的音樂播放器。下圖是使用QMediaPlayer和QMediaPlaylist實作的一個音樂播放器執行個體程式,它實作了一個音樂播放器的基本功能。

2.界面設計與主視窗類的定義

執行個體是一個界面基于QMainWindow的應用程式，主視窗上删除了菜單欄、工具欄和狀态欄，界面采用UI設計器設計，中間是一個QListWidget元件顯示播放清單的檔案名。其他的界面元件和布局設計不再贅述。

下面是主視窗類的定義（省略了UI設計器自動生成的界面元件的槽函數)：

class MainWindow : public QMainWindow
{
	Q_OBJECT
public:
  MainWindow(QWidget *parent = nullptr);
  ~MainWindow();
private:
  Ui::MainWindow *ui;
  QMediaPlayer *player;//播放器
  QMediaPlaylist *playlist; //播放清單
  QString durationTime;//總長度
  QString positionTime; //目前播放到的位置
private slots:
  //自定義槽函數
  void onStateChanged(QMediaPlayer::State state);
  void onPlaylistChanged(int position);
  void onDurationChanged(qint64 duration);
  void onPositionChanged(qint64 position);
};

主要是定義了4個私有變量，4個自定義槽函數。

onStateChanged()在播放器播放狀态變化時發射，以更新界面上的“播放”“暫停”“停止”按鈕的使能狀态。
onPlaylistChanged()在播放清單的目前檔案變化時發射，用以更新界面上顯示目前媒體檔案名。
onDurationChanged()在檔案時長變化時發射，用于更新界面上檔案時間長度的顯示。
onPositionChanged()在目前檔案播放位置變化時發射，用于更新界面上的播放進度顯示。

下面是MainWindow構造函數的代碼，主要功能是建立player和playlist,然後進行信号與自定義槽函數的關聯。

MainWindow::MainWindow(QWidget *parent)
: QMainWindow(parent), ui(new Ui::MainWindow)
{
  ui->setupUi(this);
  player = new QMediaPlayer(this);//播放器
  playlist = new QMediaPlaylist(this);//播放清單
  playlist->setPlaybackMode(QMediaPlaylist::Loop); //循環模式
  player->setPlaylist(playlist);
  connect(player,SIGNAL(stateChanged(QMediaPlayer::State)),
  	this, SLOT(onStateChanged(QMediaPlayer::State)));
  connect(player,SIGNAL(positionChanged(qint64)),
  	this, SLOT(onPositionChanged(qint64)));
  connect(player,SIGNAL(durationChanged(qint64)),
  	this, SLOT(onDurationChanged(qint64)));
  connect(playlist,SIGNAL(currentlndexChanged(int)),
  	this, SLOT(onPlaylistChanged(int)));
}

下面是4個自定義槽函數的代碼：

void MainWindow::onStateChanged(QMediaPlayer::State state)
{//播放器狀态變化，更新按鈕狀态
  ui->btnPlay->setEnabled(!(state==QMediaPlayer::PlayingState));
  ui->btnPause->setEnabled(state==QMediaPlayer::PlayingState);
  ui->btnStop->setEnabled(state==QMediaPlayer::PlayingState);
}

void MainWindow::onPlaylistChanged(int position)
{//播放清單變化，更新目前播放檔案名顯示
  ui->listMusic->setCurrentRow(position);
  QListWidgetItem *item=ui->listMusic->currentItem();
  if(item)
  	ui->labTitle->setText(item->text());
}

void MainWindow::onDurationChanged(qint64 duration)
{//檔案時長變化，更新進度顯示
  ui->sliderPosition->setMaximum(duration);
  int secs=duration/1000;//秒
  int mins=secs/60; //分鐘
  secs=secs % 60;//餘數秒
  durationTime=QString::asprintf("%d:%d",mins,secs);
  ui->labRatio->setText (positionTime+'/'+durationTime);
}

void MainWindow::onPositionChanged(qint64 position)
{//目前檔案播放位置變化，更新進度顯示
  if(ui->sliderPosition->isSliderDown())//正處于手動調整狀态，不處理
  	return;
  ui->sliderPosition->setSliderPosition(position);
  int secs=position/1000;//秒
  int mins=secs/60; //分鐘
  secs=secs % 60;//餘數秒
  positionTime=QString::asprintf("%d:%d",mins,secs);
  ui->labRatio->setText(positionTime+'/'+durationTime);
}

3.播放清單控制

視窗中間以一個QListWidget元件顯示播放的檔案清單，界面上顯示的檔案清單與playlist存儲的檔案清單保持同步。

視窗上方的“添加”“移除”“清空”3個按鈕的代碼如下：

void MainWindow::on_btnAdd_clicked()
{//添加檔案
  QString curPath=QDir::homePath(); //擷取使用者目錄
  QString dlgTitle="選擇音頻檔案";
  QString filter="音頻檔案(*.mp3 *.wav *.wma);;mp3檔案(*.mp3);;wav檔案(*.wav);;wma檔案(*.wma);;所有檔案(*.*)";
  QStringList fileList=QFileDialog::getOpenFileNames(this, dlgTitle, curPath, filter);
  if(fileList.count()<1)
  	return;
  for(int i=0; i<fileList.count();i++){
    QString aFile=fileList.at(i);
    playlist->addMedia(QUrl::fromLocalFile(aFile)); //添加檔案
    QFileInfo fileInfo(aFile);
    ui->listMusic->addItem(fileInfo.fileName());//添加到界面檔案清單
  }
  if(player->state()!=QMediaPlayer::PlayingState)
  	playlist->setCurrentIndex(0);
  player->play();
}

void MainWindow::on_btnRemove_clicked()
{//移除一個檔案
  int pos=ui->listMusic->currentRow();
  QListWidgetItem *item=ui->listMusic->takeItem(pos);
  delete item;//從 listWidget 裡删除
  playlist->removeMedia(pos) ; //從播放清單裡删除
  }

void MainWindow::on_btnClear_clicked()
{//清空清單
  playlist->clear();
  ui->listMusic->clear();
  player->stop();
}

用到的QMediaPlaylist的主要函數有：

addMedia()添加一個檔案；
removeMedia()移除一個檔案；
setCurrentIndex()設定目前播放檔案序号；
clear()清空播放清單。

在播放清單中前移和後移使用previous()和next()函數，移動時播放清單會發射currentIndexChanged()信号，進而自動更新界面上listWidget裡的目前條目。

void MainWindow::on_btnPrevious_clicked()
{
	playlist->previous();
}

void MainWindow::on_btnNext_clicked()
{
	playlist->next();
}

在界面上的listWidget裡輕按兩下一個條目時，切換到播放這個檔案，其實作代碼為：

void MainWindow::on_listWidget_doubleClicked(const QModelIndex &index)
{//輕按兩下時切換播放檔案
  int rowNo=index.row();
  playlist->setCurrentIndex(rowNo);
  player->play();
}

4.播放控制

播放、暫停或停止播放器，隻需調用QMediaPlayer相應函數即可，界面上3個按鈕的代碼如下:

void MainWindow::on_btnPlay_clicked()
{//播放
  if(playlist->currentIndex()<0)
  playlist->setCurrentIndex(0);
  player->play();
}

void MainWindow::on_btnPause_clicked()
{//暫停播放
  player->pause();
}

void MainWindow::on_btnStop_clicked()
{//停止播放
  player->stop();
}

播放狀态變化時會發射stateChanged()信号，在關聯的自定義槽函數onStateChanged()裡更新3個按鈕的使能狀态。

音量控制由一個“靜音”按鈕和音量滑動條控制，相關代碼如下：

void MainWindow::on_btnMute_clicked()
{//靜音控制
  bool mute=player->isMuted();
  player->setMuted(!mute);
  if(mute)
  	ui->btnMute->setText("√");
  else
  	ui->btnMute->setText("×");
}

void MainWindow::on_sliderVolume_valueChanged(int value)
{//調整音量
	player->setVolume(value);
}

檔案播放進度條在onDurationChanged()和onPositionChanged()兩個自定義槽函數裡會更新，顯示目前檔案播放進度。當拖動滑動條的滑塊可以設定檔案播放位置，代碼如下：

void MainWindow::on_sliderPosition_valueChanged(int value)
{//檔案進度調控
	player->setPosition(value);
}

————————————————

覺得有用的話請關注點贊，謝謝您的支援！

對于本系列文章相關示例完整代碼有需要的朋友，可關注并在評論區留言！

從零開始學Qt（92）：使用QMediaPlayer播放音樂檔案

1. QMediaPlayer類

2.界面設計與主視窗類的定義

3.播放清單控制

4.播放控制

繼續閱讀

從零開始學習Oracle之資料庫和資料表的基本操作

奔馳C260L可通過無線方式連接配接CarPlay。目前，蘋果手機是連接配接奔馳車機的唯一方式。第一種方法是将手機線連接配接至車内的

《領域驅動設計——精簡版》随筆

Arcengine,C#,影像資料的裁切和儲存

ArcObjects開發之Map類的了解

Javascript複習及面向對象寫法

layer彈出層不在頁面居中解決方案layer彈出層不居中解決方案

解決svn項目不能送出

layui彈出框confirm自定義樣式

從零開始···整合mybatis

Why network like internet popular and reliability

從零開始學python（十五）大廠必用feapder架構

第六章層的濾鏡

Photoshop最常見的問答集

Android遊戲引擎AndEngineE的常用子產品介紹

CSMA/CD1． CSMA/CD的概述2． CSMA 的工作原理3． CSMA/CD控制規程及特點4． CSMA/CD協定5． CSMA/CD的優點6．結束語