在Ubuntu下编译VLC并实现播放视频

VLC官网：https://www.videolan.org/

VLC Github：https://github.com/videolan/vlc

测试环境：Ubuntu 16.04 64位系统，Qt Creator + GCC

一、下载VLC源码

下载地址：http://download.videolan.org/pub/videolan/vlc/2.2.4/vlc-2.2.4.tar.xz

二、安装VLC依赖的库

输入如下命令，安装依赖库：

sudo apt-get build-dep vlc

报错：You must put some ‘source’ URIs in your sources.list

参考第五章，进行解决。

三、VLC编译与安装

1、编译与安装

解压VLC压缩包，注意J为大写

tar -xvJf vlc-2.2.4.tar.xz

进入VLC源码目录

cd vlc-2.2.4

进行配置，先执行

./bootstrap

再执行

./configure

报错如下：error: “You cannot build VLC with Qt-5.5.0. You need to backport I78ef29975181ee22429c9bd4b11d96d9e68b7a9c”

参考第五章，进行解决之后继续。

编译

make

安装

sudo make install

编译安装后，即可在/usr/local/lib和/usr/local/include看到库和头文件。

2、库文件

VLC库文件位于/usr/local/lib。

我们程序调用VLC库运行时，依赖的so有libvlc.so、libvlc.so.5、libvlc.so.5.5.0、libvlccore.so、libvlccore.so.8、libvlccore.so.8.0.0共6个，如下：

另外，还依赖于/usr/local/lib/vlc/plugins目录下的插件。

建议打包时，直接拷贝plugins目录，并按/usr/local/lib下的相对目录结构组织，即vlc目录与so同一级，plugins目录放在vlc目录下。

3、头文件

VLC头文件位于/usr/local/include。

四、调用VLC实现播放视频

1、添加头文件、库路径

我们建立一个Qt测试工程，pro文件中加入包含头文件、库路径，如下：

unix {
# VLC相关库
LIBS += -L/usr/local/lib -lvlc

# VLC头文件目录
INCLUDEPATH += /usr/local/include
}

2、封装播放器类VLCPlayer

VLC实现一个基本的播放流程，如下：

过程也是非常的简单，我们封装一个简单的播放器类VLCPlayer。

VLCPlayer.h

#ifndef VLCPLAYER_H
#define VLCPLAYER_H

#include <QString>
#include <qwindowdefs.h>
#include <vlc/vlc.h>

class VLCPlayer
{
public:
    enum State
    {
        Stopped,	// 停止
        Playing,	// 正在播放
        Paused		// 暂停
    };

    VLCPlayer();
    ~VLCPlayer();

    void setMedia(const QString& file); // 设置视频文件路径
    void setVideoOutput(WId winId); // 设置视频播放窗口id，视频在该窗口进行播放

    void play();	// 播放
    void pause();   // 暂停
    void resume();	// 继续
    void stop();	// 停止

    State state();	// 获取当前播放器状态

private:
    libvlc_instance_t* instance;    ///>VLC实例
    libvlc_media_player_t* player;  ///>VLC媒体播放器
    libvlc_media_t* media;          ///>可以播放的媒体
};

#endif // VLCPLAYER_H

VLCPlayer.cpp

#include "VLCPlayer.h"
#include <QDir>

VLCPlayer::VLCPlayer()
    : media(nullptr)
{
    // 创建VLC实例
    instance = libvlc_new (0, nullptr);

    // 创建VLC媒体播放器
    player = libvlc_media_player_new(instance);
}

VLCPlayer::~VLCPlayer()
{
    // 释放媒体
    if (media)
    {
        libvlc_media_release(media);
        media = nullptr;
    }

    // 释放VLC媒体播放器
    libvlc_media_player_release(player);
    player = nullptr;

    // 释放VLC实例
    libvlc_release(instance);
    instance = nullptr;
}

void VLCPlayer::setMedia(const QString &file)
{
    // 将路径转换为本地系统路径风格
    // win下时，如将路径"a/b/c"转换为"a\\b\\c"形式
    // linux下时，将路径转换为"a/b/c"形式
    QString path = QDir::toNativeSeparators(file);

    // 释放旧的媒体
    if (media)
    {
        libvlc_media_release(media);
        media = nullptr;
    }

    // 创建新的媒体
    media = libvlc_media_new_path(instance, path.toStdString().c_str());
    libvlc_media_player_set_media(player, media); // 把新的媒体设置给播放器
}

void VLCPlayer::setVideoOutput(WId winId)
{
    // 设置播放句柄
#if defined(Q_OS_WIN)
    libvlc_media_player_set_hwnd(player, (void *)winId);
#elif defined(Q_OS_LINUX)
    libvlc_media_player_set_xwindow(player, winId);
#elif defined(Q_OS_MAC)
    libvlc_media_player_set_nsobject(player, (void *)winId);
#endif
}

void VLCPlayer::play()
{
    libvlc_media_player_play(player);
}

void VLCPlayer::pause()
{
    libvlc_media_player_pause(player);
}

void VLCPlayer::resume()
{
    play();
}

void VLCPlayer::stop()
{
    libvlc_media_player_stop(player);
}

VLCPlayer::State VLCPlayer::state()
{
    libvlc_state_t s = libvlc_media_player_get_state(player);
    if (s == libvlc_Ended || s == libvlc_Stopped)
    {
        return Stopped;
    }
    else if (s == libvlc_Paused)
    {
        return Paused;
    }
    else if (s == libvlc_Playing)
    {
        return Playing;
    }
    else
    {
        return Stopped;
    }
}

注意：

libvlc_media_new_path函数，第二个参数视频文件路径，在win下时，需要传入形如"D:\\video.mp4"的路径；而在linux下时，需要传入形如"/root/video.mp4"的路径。

3、测试代码

在主窗口中，添加如下测试代码。

mainwindow.h

class MainWindow : public QMainWindow
{
    Q_OBJECT

public:
    explicit MainWindow(QWidget *parent = nullptr);
    ~MainWindow();

private slots:
    void on_pushButton_play_clicked();
    void on_pushButton_pause_clicked();
    void on_pushButton_resume_clicked();
    void on_pushButton_stop_clicked();

private:
    Ui::MainWindow *ui;
    VLCPlayer player;
};

mainwindow.cpp

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

    player.setMedia(qApp->applicationDirPath() + "/video.mp4");
    player.setVideoOutput(ui->label_video->winId());
}

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

void MainWindow::on_pushButton_play_clicked()
{
    player.play();
}

void MainWindow::on_pushButton_pause_clicked()
{
    player.pause();
}

void MainWindow::on_pushButton_resume_clicked()
{
    player.resume();
}

void MainWindow::on_pushButton_stop_clicked()
{
    player.stop();
}

测试代码也十分简单，通过setMedia指定需要播放的视频文件，setVideoOutput指定在QLabel上进行播放，然后通过4个按钮进行播放控制。

执行效果如下：

五、报错解决

1、报错（You must put some ‘source’ URIs in your sources.list）

原因：找不到VLC相关的源

解决办法：修改Ubuntu服务器设置，步骤如下。

（1）选择“System Settings”菜单

（2）选择“Software & Updates”

（3）先勾选“Source code”，然后选择“Download from”中的“Other…”

（4）展开“China”，选择阿里云“mirrors.aliyun.com”，再点击“Choose Server”

（5） 点击“Close”，关闭窗口

（6）弹出软件信息过期提示，选择“Reload”

一会后就更新完毕。

再次执行：sudo apt-get build-dep vlc，进行安装。

安装一段时间后，又报错误：

E: Unable to fetch some archives, maybe run apt-get update or try with --fix-missing?
E: Failed to process build dependencies

我们按照提示，执行：sudo apt-get build-dep vlc --fix-missing

执行完毕，VLC依赖库，即可成功安装。

2、报错（error: “You cannot build VLC with Qt-5.5.0. You need to backport I78ef29975181ee22429c9bd4b11d96d9e68b7a9c”）

解决办法：在VLC源码目录下，configure.ac文件中找这一行，并注释掉

#PKG_CHECK_EXISTS([Qt5Core >= 5.5.0 Qt5Core < 5.6.0], [
#	AC_MSG_ERROR(["You cannot build VLC with Qt-5.5.0. You need to backport I78ef29975181ee22429c9bd4b11d96d9e68b7a9c"])
#])

如下：

保存后，执行如下命令：autoconf
再执行./configure命令，即可配置成功。

本文涉及工程代码：

https://gitee.com/bailiyang/cdemo/tree/master/Qt/63VLCTest/VLCPlayer

---

若对你有帮助，欢迎点赞、收藏、评论，你的支持就是我的最大动力！！！

同时，阿超为大家准备了丰富的学习资料，欢迎关注公众号“超哥学编程”，即可领取。