QMediaPlayer Class

player = new QMediaPlayer;
audioOutput = new QAudioOutput;
player->setAudioOutput(audioOutput);
connect(player, &QMediaPlayer::positionChanged, this, &MediaExample::positionChanged);
player->setSource(QUrl::fromLocalFile("/Users/me/Music/coolsong.mp3"));
audioOutput->setVolume(50);
player->play();

属性文档

activeAudioTrack : int

返回当前激活的音轨。

默认情况下，将选择第一个可用的音轨。

将index 设置为-1 可禁用所有音轨。

访问功能：

通知信号：

activeSubtitleTrack : int

返回当前激活的字幕轨道。

将index 设为-1 可禁用字幕。

字幕默认为禁用。

访问功能：

通知信号：

activeVideoTrack : int

返回当前激活的视频轨道。

默认情况下，将选择第一个可用的音频轨道。

将index 设置为-1 可禁用所有视频轨道。

访问功能：

通知信号：

[since 6.8] audioBufferOutput : QAudioBufferOutput*

该属性用于保存媒体播放器使用的输出音频缓冲区。

为媒体播放器设置音频缓冲区output 。

如果指定了QAudioBufferOutput ，且媒体源包含音频流，则媒体播放器将发出信号QAudioBufferOutput::audioBufferReceived ，并带有包含解码音频数据的音频缓冲区。在音频流结束时，QMediaPlayer 会发射一个空的QAudioBuffer 。

QMediaPlayer 如果指定了音频输出端，则在将匹配数据推送到音频输出端时，媒体播放器会同时发射输出音频缓冲区。不过，由于音频缓冲区化，声音播放可能会有少许延迟。

发射音频缓冲区的格式取自指定的output ，如果output 返回的格式无效，则取自匹配的音频流。发射的音频数据不会根据当前播放速率进行缩放。

利用QAudioBufferOutput 和QMediaPlayer 的潜在用例包括

• 音频可视化。如果媒体播放器的播放速率不是1 ，则可根据可视化器的要求缩放输出图像的尺寸或图像更新间隔。
• 任何人工智能声音处理，如语音识别。
• 将数据发送到外部音频输出。应考虑改变播放速率、与视频同步以及在停止和搜索时手动冲洗。我们不建议将音频缓冲输出用于此目的，除非您有充分的理由这样做。

此属性在 Qt 6.8 中引入。

访问功能：

Notifier 信号：

audioOutput : QAudioOutput*

此属性用于保存媒体播放器使用的音频输出设备。

播放媒体时使用的当前音频输出。设置新的音频输出将替换当前使用的输出。

将此属性设置为nullptr 将禁用任何音频输出。

访问功能：

通知信号：

[read-only] audioTracks : const QList<QMediaMetaData>

列出媒体内可用的音频轨道集。

返回的QMediaMetaData 描述了各个音轨的属性。

例如，不同的音轨可以包含不同语言的音频。

访问功能：

通知信号：

[read-only] bufferProgress : const float

该属性表示播放开始或恢复前临时缓冲区已满的百分比，从0. （空）到1. （满）。

当播放器对象正在缓冲时，该属性表示临时缓冲区已满的百分比。在播放开始或恢复之前，缓冲区需要达到 100%，此时mediaStatus() 将返回BufferedMedia 或BufferingMedia 。如果该值低于100 ，mediaStatus() 将返回StalledMedia 。

访问功能：

通知信号：

另请参阅 mediaStatus() 。

[read-only] duration : const qint64

该属性用于保存当前媒体的持续时间。

该值是当前媒体的总播放时间（以毫秒为单位）。该值可能会在QMediaPlayer 对象的整个生命周期内发生变化，初始播放开始时可能不可用，请连接到durationChanged() 信号以接收状态通知。

访问功能：

Notifier 信号：

[read-only] error : const Error

该属性包含一个字符串，描述最后一次出错的情况。

访问功能：

Notifier 信号：

另请参见 error().

[read-only] errorString : const QString

该属性包含一个字符串，详细描述了当前的错误状况。

访问功能：

通知信号：

[read-only] hasAudio : const bool

此属性表示媒体是否包含音频。

访问功能：

通知信号：

[read-only] hasVideo : const bool

此属性表示媒体是否包含视频。

访问功能：

通知信号：

loops : int

决定播放器停止播放媒体文件的频率。设置为QMediaPlayer::Infinite 可永远循环播放当前媒体文件。

默认值为1 。将此属性设置为0 没有任何作用。

访问功能：

通知信号：

[read-only] mediaStatus : const MediaStatus

该属性用于保存当前媒体流的状态。

流状态描述了当前流的播放进度。

默认情况下，此属性为QMediaPlayer::NoMedia

访问功能：

Notifier 信号：

[read-only] metaData : const QMediaMetaData

返回媒体播放器使用的当前媒体的元数据。

元数据可包含视频标题或创建日期等信息。

访问功能

通知信号

playbackRate : qreal

此属性用于保存当前媒体的播放速率。

该值是媒体标准播放速度的乘数。默认情况下，该值为 1.0，表示媒体以标准速度播放。高于 1.0 的值会提高播放速度，而介于 0.0 和 1.0 之间的值则会降低播放速度。不支持负播放速度。

并非所有播放服务都支持更改播放速率。快进或倒带时音频和视频的状态和质量由框架定义。

访问功能：

通知信号：

[read-only] playbackState : const PlaybackState

返回PlaybackState 。

访问功能：

Notifier 信号：

另请参阅 playing 。

[read-only, since 6.5] playing : const bool

此属性表示媒体是否正在播放。

此属性在 Qt 6.5 中引入。

访问函数：

Notifier 信号：

另请参阅 playbackState 和PlayingState 。

position : qint64

该属性用于保存当前媒体的播放位置。

该值是当前的播放位置，以媒体开始后的毫秒为单位。位置的周期性变化将通过positionChanged() 信号显示。

如果seekable 属性为 true，则可将此属性设置为毫秒。

访问功能：

Notifier 信号：

[read-only] seekable : const bool

该属性表示当前媒体的可寻状态。

如果支持寻道，则此属性为 true；否则为 false。该属性的状态可能会在QMediaPlayer 对象的整个生命周期内发生变化，请使用seekableChanged 信号监控变化。

访问功能：

通知信号：

source : QUrl

该属性用于保存播放器对象正在使用的活动媒体源。

播放器对象将使用QUrl 选择要播放的内容。

默认情况下，该属性为空QUrl 。

将此属性设置为空QUrl 将导致播放器丢弃与当前媒体源相关的所有信息，并停止与该媒体相关的所有 I/O 操作。

访问功能：

Notifier 信号：

另请参阅 QUrl 。

[read-only] subtitleTracks : const QList<QMediaMetaData>

列出媒体中可用的字幕轨道集。

返回的QMediaMetaData 描述了各个轨道的属性。

访问功能：

通知信号：

videoOutput : QObject*

该属性用于保存媒体播放器使用的视频输出。

一个媒体播放器只能连接一个视频输出端，因此设置此属性将替换之前连接的视频输出端。

将此属性设置为nullptr 将禁用视频输出。

访问功能：

通知信号：

[read-only] videoTracks : const QList<QMediaMetaData>

列出媒体内可用的视频轨道集。

返回的QMediaMetaData 描述了各个轨道的属性。

访问功能：

Notifier 信号：