QIviMediaPlayer类

提供控制媒体播放器的接口。更多...

头文件 #include <QIviMediaPlayer>
qmakeQT += ivimedia
由以下类实例化 MediaPlayer
继承 QIviAbstractFeature

公共类型

枚举PlayMode { 正常, 重复曲目, 重复全部, 混洗 }
枚举PlayState { 播放, 暂停, 停止 }

属性

公共函数

QIviMediaPlayer(QObject *parent = nullptr)
QVariantcurrentTrack() const
qint64duration() const
boolisMuted() const
QIviMediaPlayer::PlayModeplayMode() const
QIviPlayQueue *playQueue() const
QIviMediaPlayer::PlayStateplayState() const
qint64position() const
intvolume() const

公共槽

voidnext()
voidpause()
voidplay()
voidprevious()
voidseek(qint64 offset)
voidsetMuted(bool muted)
voidsetPlayMode(QIviMediaPlayer::PlayMode playMode)
voidsetPosition(qint64 position)
voidsetVolume(int volume)
voidstop()

信号

voidcurrentTrackChanged(const QVariant &currentTrack)
voiddurationChanged(qint64 duration)
voidmutedChanged(bool muted)
voidplayModeChanged(QIviMediaPlayer::PlayMode playMode)
voidplayStateChanged(QIviMediaPlayer::PlayState playState)
voidpositionChanged(qint64 position)
voidvolumeChanged(int volume)

重写的受保护函数

virtual voidclearServiceObject() override
virtual voidconnectToServiceObject(QIviServiceObject *serviceObject) 覆盖

详细说明

QIviMediaPlayer 提供了控制媒体播放器的各种方法。这个媒体播放器可以是本地的,甚至可以是一个远程设备,例如通过蓝牙连接的。

默认情况下,该功能的自动发现已设置为自动,可能将连接到本地媒体播放器实例。

成员类型文档

枚举 QIviMediaPlayer::PlayMode

常量说明
QIviMediaPlayer::Normal0队列中的每个项目都将按顺序播放。通常,当达到队列的末尾时,播放将停止。
QIviMediaPlayer::RepeatTrack1始终重复当前项目。应该仍然可以通过next() 和previous() 更改当前项目,但这取决于后端的实现。
QIviMediaPlayer::RepeatAll2当达到队列的末尾时,第一个项目开始播放。
QIviMediaPlayer::Shuffle3队列中的项目将随机顺序播放。

枚举 QIviMediaPlayer::PlayState

常量说明
QIviMediaPlayer::Playing0媒体播放器正在播放项目。
QIviMediaPlayer::Paused1播放被暂停,可以在相同的位置继续。
QIviMediaPlayer::Stopped2播放尚未开始。启动时,将始终从开始的位置开始。

属性文档

currentTrack : const QVariant

持有一个表示当前轨迹的 QVariant

注意:这将被替换。

访问函数

QVariantcurrentTrack() const

通知器信号

voidcurrentTrackChanged(const QVariant &currentTrack)

duration : const qint64

持有当前歌曲总时长(以秒为单位)。

访问函数

qint64duration() const

通知器信号

voiddurationChanged(qint64 duration)

muted : bool

此属性表示音频输出发是否被静音。

访问函数

boolisMuted() const
voidsetMuted(bool muted)

通知器信号

voidmutedChanged(bool muted)

另请参阅:volume.

playMode : QIviMediaPlayer::PlayMode

持有媒体播放器的当前播放模式。

访问函数

QIviMediaPlayer::PlayModeplayMode() const
voidsetPlayMode(QIviMediaPlayer::PlayMode playMode)

通知器信号

voidplayModeChanged(QIviMediaPlayer::PlayMode playMode)

playQueue : QIviPlayQueue* const

持有此媒体播放器的播放队列。

访问函数

QIviPlayQueue *playQueue() const

另请参阅:QIviPlayQueue.

playState : const QIviMediaPlayer::PlayState

持有媒体播放器的当前播放状态。

访问函数

QIviMediaPlayer::PlayStateplayState() const

通知器信号

voidplayStateChanged(QIviMediaPlayer::PlayState playState)

position : qint64

包含媒体播放器当前歌曲位置,单位为秒。

访问函数

qint64position() const
voidsetPosition(qint64 position)

通知器信号

voidpositionChanged(qint64 position)

volume : int

包含声音音量级别(0..100)

访问函数

intvolume() const
voidsetVolume(int volume)

通知器信号

voidvolumeChanged(int volume)

另请参阅 muted.

成员函数文档

QIviMediaPlayer::QIviMediaPlayer(QObject *parent = nullptr)

构造一个 QIviMediaPlayer。

parent 参数传递给 QIviAbstractFeature 基类。

[slot] void QIviMediaPlayer::next()

跳转到 playQueue 中的下一个曲目。

另请参阅 playMode.

[slot] void QIviMediaPlayer::pause()

暂停当前播放。

另请参阅 play() 和 stop()。

[slot] void QIviMediaPlayer::play()

开始播放当前曲目。如果 playQueue 为空,则后端决定如何操作。

另请参阅 pause() 和 stop()。

[slot] void QIviMediaPlayer::previous()

跳转到 playQueue 中的上一个曲目。

另请参阅 playMode.

[slot] void QIviMediaPlayer::seek(qint64 offset)

使用 offset 跳到当前曲目。

偏移量可以是正数或负数,既可以向前查找,也可以向后查找。成功的查找将导致位置属性的改变。

[slot] void QIviMediaPlayer::stop()

停止当前播放。

另请参阅 play() 和 pause()。

[override virtual protected] void QIviMediaPlayer::clearServiceObject()

重实现了 QIviAbstractFeature::clearServiceObject

[override virtual protected] void QIviMediaPlayer::connectToServiceObject(QIviServiceObject *serviceObject)

重实现了 QIviAbstractFeature::connectToServiceObject(QIviServiceObject *serviceObject)。

©2020 Qt 公司有限公司。本文件中包含的文档贡献的版权为其各自所有者的版权。本文件提供的文档是根据自由软件基金会发布的 GNU 自由文档许可证版本 1.3 的条款许可的。Qt 及相关商标是芬兰的 Qt 公司及其在全世界其他国家的商标。所有其他商标均为其各自所有者的财产。