Qt 文档

内容

MediaIndexerControl QML 类型

提供了一个控制媒体索引器的接口。 更多...

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

AbstractFeature

属性

方法

详细描述

MediaIndexerControl 控制媒体索引器。它提供了暂停和恢复索引的手段，以及查询索引操作当前状态和进度的方法。

MediaIndexerControl 预期可用的后端为单个。建议使用时将 discoveryMode 设置为 AbstractFeature.AutoDiscovery。

属性文档

discoveryMode : 枚举

包含用于自动发现的模式

支持的值有

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

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

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


discoveryResult : 枚举

上次自动发现的结果

支持的值有

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

isInitialized : bool

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

一旦后端向 QIviFeatureInterface::initializationDone 信号发送通知，表示现在所有值已使用后端值初始化，则属性值为 true。

另请参阅 isValid 和 QIviFeatureInterface::initializationDone。


isValid : bool

指示该功能是否已准备好使用。

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

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

另请参阅 QIviServiceObject、discoveryMode 和 isInitialized。


progress : real

包含索引操作的进度。

该值介于 0 和 1 之间。


serviceObject : ServiceObject

设置功能的对象。

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

此属性的设置器在 QIviServiceObject 已设置为特定实例或该 QIviServiceObject 不是功能接受的时返回 false。

另请参阅 discoveryMode。


state : 枚举

包含索引器的当前状态。

它可以有以下以下值之一

常量描述
闲置索引器当前空闲，正在等待新文件进行索引。
活动索引器当前正在索引。
暂停由于调用 pause() 而暂停。
错误索引操作期间发生错误。

方法说明

pause()

暂停当前进行的索引操作。

另请参阅 resume() 和 state。


resume()

从暂停状态恢复并继续索引操作。

另请参阅 pause() 和 state。


枚举 startAutoDiscovery()

执行自动发现尝试。

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

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

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

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

返回值包括

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

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


©2020 The Qt Company Ltd. 本文档中包含的文档贡献是各自所有者的版权。提供的文档依据自由软件基金会发布的GNU 自由文档许可版本 1.3 的条款许可。Qt及其相关徽标是芬兰及其它国家/地区的 The Qt Company Ltd. 的商标。所有其他商标均为其各自所有者的财产。