Qt 文档

内容

MediaPlayer QML 类型

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

导入声明导入 QtIvi.Media 1.0
实例化 QIviMediaPlayer
继承

AbstractFeature

属性

方法

详细描述

MediaPlayer 提供控制媒体播放器的各种方法。该媒体播放器可以是本地播放器，或者通过蓝牙等连接的远程设备。

默认情况下，自动发现功能设置为自动，很可能会连接到本地媒体播放器实例。

属性文档

currentTrack : 对象

以 QVariant 的形式表示当前轨道。

注意：这将很快被替代。


discoveryMode : 枚举

用于自动发现的模式

有效值包括

常量描述
NoAutoDiscovery不进行自动发现，并且需要手动设置 ServiceObject。
AutoDiscovery尝试查找具有匹配接口的生产后端，如果没有找到，则回退到模拟后端。
LoadOnlyProductionBackends仅尝试加载具有匹配接口的生产后端。
LoadOnlySimulationBackends仅尝试加载具有匹配接口的模拟后端。

如果需要，在功能创建完成后启动自动发现。

注意：如果在功能实例化后更改此属性，请确保调用 startAutoDiscovery() 以查找新的服务对象。


discoveryResult : 枚举

上次自动发现的最终结果

有效值包括

常量描述
NoResult表示没有启动自动发现，因为该功能已经分配了一个有效的ServiceObject。
ErrorWhileLoading在搜索匹配接口的后端时发生错误。
ProductionBackendLoaded由于自动发现而加载了生产后端。
SimulationBackendLoaded由于自动发现而加载了模拟后端。

duration : int

存储当前歌曲的总时长（秒）。


isInitialized : bool

表示功能是否已使用后端的所有值初始化。

一旦后端发送 QIviFeatureInterface::initializationDone 信号来指示所有值现在都已使用后端值初始化，该属性为 true。

另请参阅isValid 和 QIviFeatureInterface::initializationDone。


isValid : bool

表示功能是否准备好使用。

如果功能准备好使用，则属性为 true，否则为 false。未准备好通常表示找不到合适的服务对象，或者没有触发自动发现。

后端可能尚未发送所有属性，并且尚未完全初始化。请使用 isInitialized 以了解功能是否持有所有正确的值。

另请参阅QIviServiceObject、discoveryMode 和 isInitialized。


muted : bool

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

另请参阅volume。


playMode : 枚举

存储媒体播放器的当前播放模式。可用值包括

常量描述
Normal队列中的每个项目按顺序播放。通常，当达到队列的末尾时播放停止。
RepeatTrack始终重复当前项目。应该可能使用 next() 和 previous() 来更改当前项目，但这取决于后端的实现。
RepeatAll当到达队列末尾时，第一个项目开始播放。
Shuffle队列中的项目以随机顺序播放。

playQueue : PlayQueue

存储该媒体播放器的播放队列。

另请参阅PlayQueue。


playState : 枚举

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

常量描述
正在播放多媒体播放器正在播放项目。
暂停播放已暂停，可以在相同的位置继续。
停止播放尚未开始。启动它将始终从头开始。

position : int

持有多媒体播放器当前歌曲的位置（以秒为单位）。


serviceObject : ServiceObject

为功能设置服务对象。

由于功能仅向开发者公开面向前端的API，因此需要一个实现实际功能的调度对象。这通常是通过自动发现机制检索的。

如果已经将QIviServiceObject设置为特定实例或QIviServiceObject不受功能接受，则此属性的设置器返回false。

另请参阅discoveryMode。


volume : int

保持声音音量级别（0..100）

另请参阅muted。


方法说明

next()

跳转到播放队列playQueue中的下一曲目。

另请参阅playMode。


pause()

暂停正在进行的播放。

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


play()

开始播放当前曲目。如果playQueue为空，则由后端决定要做什么。

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


previous()

跳转到播放队列playQueue中的上一曲目。

另请参阅playMode。


seek(offset)

使用offset进行曲目定位。

偏移量可以是正数或负数，以向前或向后定位。成功的定位将导致位置属性的变化。


枚举 startAutoDiscovery()

执行自动发现尝试。

功能尝试定位实现所需接口的单个服务对象。

如果没有找到服务对象，则功能始终无效。如果找到多个服务对象，则使用第一个实例。

此函数返回已加载的后端类型；或错误。

如果将discoveryMode设置为QIviAbstractFeature::NoAutoDiscovery，则此函数不执行任何操作并返回QIviAbstractFeature::NoResult。

返回值包括

常量描述
NoResult表示未启动自动发现，因为功能已经有一个有效的服务对象分配。
ErrorWhileLoading表示在搜索具有匹配接口的后端时发生错误。
ProductionBackendLoaded由于自动发现而加载了生产后端。
SimulationBackendLoaded通过自动发现加载了模拟后端。

另请参阅动态后端系统和QIviServiceManager。


stop()

停止当前进行的播放。

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


©版权所有©2020 Qt公司有限公司。本文件内包含的文档贡献者是各自版权的拥有者。本文件提供的文档在自由软件基金会发布的GNU自由文档许可证版本1.3的条款下许可。Qt及其相应标志是Qt公司在芬兰以及/或其他国家和地区的商标。所有其他商标均为各自所有者的财产。