QT多媒体播放器类：QMediaPlayer

QMediaPlayer 是 Qt Multimedia 模块中的核心类，用于播放音频和视频媒体文件。它支持本地文件、网络流媒体以及及时数据源，具备播放控制、状态管理、元数据访问等功能。QMediaPlayer的基本用法大概包括设置媒体源、控制播放（播放、停息、停止）、调整音量、监听播放状态变化等。
1. 信号（Signals）

信号用于通知外部对象播放器状态、媒体属性和错误变乱的变化。
（1）媒体改变

void mediaChanged(const QMediaContent &media);

• ​触发时机：当播放器的媒体内容被显式设置（如调用 setMedia()）时触发。
  
• ​参数：QMediaContent 对象表现新加载的媒体内容。
  
• ​用途：检测媒体是否成功加载，可用于预加载验证或界面元素更新。
  

void currentMediaChanged(const QMediaContent &media);

• ​触发时机：当播放列表中的当前媒体切换时触发（如自动播放下一曲）。
  
• ​参数：QMediaContent 对象表现当前播放的媒体。
  
• ​用途：结合 QMediaPlaylist 利用，实现播放列表切换的逻辑。
  

（2）状态变化 

void stateChanged(QMediaPlayer::State newState);

• 触发时机：播放器状态改变时触发（如播放→停息→停止）。
  
• ​参数：newState 是枚举值，大概的值包括：
  
  
  
  • QMediaPlayer:layingState
    
  • QMediaPlayer:ausedState
    
  • QMediaPlayer::StoppedState
    
  
  
• ​用途：更新界面按钮图标（播放/停息）、体现状态栏信息。
  

void mediaStatusChanged(QMediaPlayer::MediaStatus status)

• 触发时机：媒体资源的状态变化（如加载中、已加载、缓冲中、播放结束）。
  
• 参数：status 表现媒体状态：
  
  
  
  • QMediaPlayer:oadingMedia：正在加载媒体。
    
  • QMediaPlayer:oadedMedia：媒体加载完成。
    
  • QMediaPlayer::BufferingMedia：缓冲中（网络流媒体常见）。
    
  • QMediaPlayer::EndOfMedia：播放完成。
    
  
  

（3）媒体播放进度

void durationChanged(qint64 duration);

• ​触发时机：媒体元数据加载完成后触发（如歌曲总时长）。
  
• ​参数：duration 是媒体的总毫秒时长。
  
• ​用途：更新进度条最大值或体现歌曲总时长。
  

void positionChanged(qint64 position);

• ​触发时机：播放进度改变时（如用户拖动进度条或自动播放）。
  
• ​参数：position 是当前播放位置的毫秒数。
  
• ​用途：及时更新进度条位置或体现当前播放时间。
  

（4）音频/视频可用性 

void audioAvailableChanged(bool available);

• ​触发时机：音频数据是否可用的状态变化。
  
• ​参数：available 为 true 表现有音频数据可播放。
  
• ​用途：处理无音频输出的非常环境（如仅视频文件）。
  

​void videoAvailableChanged(bool videoAvailable);

• ​触发时机：视频数据是否可用的状态变化。
  
• ​参数：videoAvailable 为 true 表现有视频数据可播放。
  
• ​用途：切换视频窗口可见性或处理纯音频文件
  

（5）其他常用信号

void playbackRateChanged(qreal rate);

• ​触发时机：播放速率改变时（如用户调整倍速）。
  
• ​参数：rate 是新的播放速率（1.0=正常，0.5=0.5倍速）。
  

void seekableChanged(bool seekable);

• ​触发时机：媒体是否支持随机跳转（如MP3支持，某些流媒体不支持）。
  
• ​参数：seekable 为 true 表现可以跳转。
  

void mutedChanged(bool muted);

• ​触发时机：静音状态切换时。
  
• ​参数：muted 为 true 表现已静音。
  

1. Q_SIGNALS:
2.     void mediaChanged(const QMediaContent &media);
3.     void currentMediaChanged(const QMediaContent &media);
5.     void stateChanged(QMediaPlayer::State newState);
6.     void mediaStatusChanged(QMediaPlayer::MediaStatus status);
8.     void durationChanged(qint64 duration);
9.     void positionChanged(qint64 position);
11.     void volumeChanged(int volume);
12.     void mutedChanged(bool muted);
13.     void audioAvailableChanged(bool available);
14.     void videoAvailableChanged(bool videoAvailable);
16.     void bufferStatusChanged(int percentFilled);
18.     void seekableChanged(bool seekable);
19.     void playbackRateChanged(qreal rate);
21.     void audioRoleChanged(QAudio::Role role);
22.     void customAudioRoleChanged(const QString &role);
24.     void error(QMediaPlayer::Error error);

复制代码

 2. 槽函数（Slots）

槽函数用于接收外部指令（如用户点击按钮）来控制播放器举动。

1. public Q_SLOTS:
2.     void play();
3.     void pause();
4.     void stop();
6.     void setPosition(qint64 position); //跳转到指定时间位置
7.     void setVolume(int volume);
8.     void setMuted(bool muted);
10.     void setPlaybackRate(qreal rate);
12.     void setMedia(const QMediaContent &media, QIODevice *stream = nullptr);
13.     void setPlaylist(QMediaPlaylist *playlist);

复制代码

3. 枚举（enum）

1. enum State
2. {
3.     StoppedState,       // 停止状态
4.     PlayingState,      // 播放状态
5.     PausedState         // 暂停状态
6. };

复制代码

1. enum MediaStatus
2. {
3.     UnknownMediaStatus,   // 未知状态（初始化值）
4.     NoMedia,              // 无媒体关联
5.     LoadingMedia,          // 正在加载媒体
6.     LoadedMedia,           // 媒体已加载完成
7.     StalledMedia,          // 播放卡顿（解码阻塞）
8.     BufferingMedia,        // 缓冲中（网络流场景）
9.     BufferedMedia,         // 已缓冲部分（可跳过前奏）
10.     EndOfMedia,            // 到达媒体末尾
11.     InvalidMedia            // 媒体格式/内容无效
12. };

复制代码

1. enum Flag
2. {
3.     LowLatency = 0x01,       // 低延迟模式（实时性优化）
4.     StreamPlayback = 0x02,   // 流式播放模式（边下边播）
5.     VideoSurface = 0x04       // 指定视频渲染表面（GPU加速）
6. };
7. Q_DECLARE_FLAGS(Flags, Flag) // 允许位运算组合

复制代码

1. enum Error
2. {
3.     NoError,               // 无错误（默认值）
4.     ResourceError,          // 资源不可用（内存不足/文件损坏）
5.     FormatError,            // 格式不支持（如非MP4/WAV）
6.     NetworkError,           // 网络连接问题（断网/CORS）
7.     AccessDeniedError,       // 权限被拒绝（存储权限/DRM）
8.     ServiceMissingError,    // 依赖服务缺失（如云播放服务）
9.     MediaIsPlaylist          // 试图播放播放列表项（需选择具体媒体）
10. };

复制代码

免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！更多信息从访问主页：qidao123.com:ToB企服之家，中国第一个企服评测及商务社交产业平台。