QBluetoothServiceInfo 类

成员函数文档

QBluetoothServiceInfo::QBluetoothServiceInfo()

构造一个新的无效 QBluetoothServiceInfo；

QBluetoothServiceInfo::QBluetoothServiceInfo(const QBluetoothServiceInfo &other)

构造一个新的 QBluetoothServiceInfo，它是 other 的副本。

两个副本继续共享相同的基本数据，不会在写入时分离。

[noexcept] QBluetoothServiceInfo::~QBluetoothServiceInfo()

销毁QBluetoothServiceInfo对象。

QVariant QBluetoothServiceInfo::attribute(quint16 attributeId) const

返回属性 attributeId 的值。

另请参阅：setAttribute().

QList<quint16> QBluetoothServiceInfo::attributes() const

返回 QBluetoothServiceInfo 对象具有的所有属性 ID 的列表。

bool QBluetoothServiceInfo::contains(quint16 attributeId) const

如果 QBluetoothServiceInfo 对象包含属性 attributeId，则返回 true，否则返回 false。

QBluetoothDeviceInfo QBluetoothServiceInfo::device() const

返回提供此服务的蓝牙设备的地址。

另请参阅：setDevice().

bool QBluetoothServiceInfo::isComplete() const

如果 QBluetoothServiceInfo 对象被认为是完整的，则返回 true，否则返回 false。

一个完整的 QBluetoothServiceInfo 对象包含一个 ProtocolDescriptorList 属性。

bool QBluetoothServiceInfo::isRegistered() const

如果服务信息已注册到平台的 Service Discovery Protocol (SDP) 实现，则返回 true，否则返回 false。

bool QBluetoothServiceInfo::isValid() const

如果 QBluetoothServiceInfo 对象是有效的，则返回 true，否则返回 false。

无效的 QBluetoothServiceInfo 对象将没有属性。

QBluetoothServiceInfo::Sequence QBluetoothServiceInfo::protocolDescriptor(QBluetoothUuid::ProtocolUuid protocol) const

返回协议 protocol 的协议参数作为 QBluetoothServiceInfo::Sequence。

如果 protocol 不受支持，将返回一个空的 QBluetoothServiceInfo::Sequence。

int QBluetoothServiceInfo::protocolServiceMultiplexer() const

这是一个方便函数。如果服务支持 L2CAP 协议，则返回协议/服务多路复用器，否则返回 -1。

此函数等同于从 QBluetoothServiceInfo::Sequence 提取信息，该信息由 QBluetoothServiceInfo::attribute(QBluetoothServiceInfo::ProtocolDescriptorList) 返回。

bool QBluetoothServiceInfo::registerService(const QBluetoothAddress &localAdapter = QBluetoothAddress())

将此服务注册到平台的 Service Discovery Protocol (SDP) 实现，使其在执行服务发现时可以被其他设备找到。如果服务成功注册，则返回 true，否则返回 false。一旦注册，就不能再修改记录。必须先注销服务，然后再使用更改重新注册。

localAdapter 参数确定服务应在其中注册的本地蓝牙适配器。如果 localAdapter 为 null，则使用默认蓝牙适配器。如果此服务信息对象已通过本地适配器注册，并且使用不同本地适配器调用此函数，则将删除以前的注册，并使用新适配器重新注册服务。

void QBluetoothServiceInfo::removeAttribute(quint16 attributeId)

从 QBluetoothServiceInfo 对象中删除属性 attributeId。

如果服务信息已与平台的 SDP 数据库注册，则直到再次调用 registerService() 前，都不会更新数据库条目。

int QBluetoothServiceInfo::serverChannel() const

这是一个方便函数。如果服务支持 RFCOMM 协议，则返回服务器通道，否则返回 -1。

此函数等同于从 QBluetoothServiceInfo::attribute(QBluetootherServiceInfo::ProtocolDescriptorList) 返回的 QBluetoothServiceInfo::Sequence 中提取信息。

quint8 QBluetoothServiceInfo::serviceAvailability() const

这是一个方便函数。它等同于调用 attribute(QBluetoothServiceInfo::ServiceAvailability).toUInt()。

返回服务的可用性。

另请参阅setServiceAvailability() 和 attribute()。

QList<QBluetoothUuid> QBluetoothServiceInfo::serviceClassUuids() const

返回描述服务类 UUID 的列表，该服务等遵从这些服务类。

这是一个便利函数。它等同于调用attribute(QBluetoothServiceInfo::ServiceClassIds)().value(<QBluetoothServiceInfo::Sequence>)，然后遍历其QBluetoothUuid条目。

另请参阅 attribute。

QString QBluetoothServiceInfo::serviceDescription() const

这是一个便利函数。它等同于调用attribute(QBluetoothServiceInfo::ServiceDescription)().toString()。

返回主语言的业务描述。

另请参阅 setServiceDescription和attribute。

QString QBluetoothServiceInfo::serviceName() const

这是一个便利函数。它等同于调用attribute(QBluetoothServiceInfo::ServiceName)().toString()。

返回主语言的业务名称。

另请参阅 setServiceName和attribute。

QString QBluetoothServiceInfo::serviceProvider() const

这是一个便利函数。它等同于调用attribute(QBluetoothServiceInfo::ServiceProvider)().toString()。

返回主语言的业务提供商。

另请参阅 setServiceProvider和attribute。

QBluetoothUuid QBluetoothServiceInfo::serviceUuid() const

这是一个便利函数。它等同于调用attribute(QBluetoothServiceInfo::ServiceId)().value(<QBluetoothUuid>())。

返回服务的自定义UUID。此UUID可能为空。基于蓝牙SIG标准的UUID应通过serviceClassUuids()检索。

另请参阅 setServiceUuid和attribute。

void QBluetoothServiceInfo::setAttribute(quint16 attributeId, const QVariant &value)

将attributeId标识的属性设置为value。

如果服务信息已注册到平台的SDP数据库中，则不会更新数据库条目，直到再次调用registerService()。

另请参阅 attribute，isRegistered和registerService。

void QBluetoothServiceInfo::setAttribute(quint16 attributeId, const QBluetoothUuid &value)

这是一个便利函数。

将attributeId标识的属性设置为value。

如果服务信息已注册到平台的SDP数据库中，则不会更新数据库条目，直到再次调用registerService()。

void QBluetoothServiceInfo::setAttribute(quint16 attributeId, const QBluetoothServiceInfo::Sequence &value)

这是一个便利函数。

将attributeId标识的属性设置为value。

如果服务信息已注册到平台的SDP数据库中，则不会更新数据库条目，直到再次调用registerService()。

void QBluetoothServiceInfo::setAttribute(quint16 attributeId, const QBluetoothServiceInfo::Alternative &value)

这是一个便利函数。

将attributeId标识的属性设置为value。

如果服务信息已注册到平台的SDP数据库中，则不会更新数据库条目，直到再次调用registerService()。

void QBluetoothServiceInfo::setDevice(const QBluetoothDeviceInfo &device)

将提供此服务的蓝牙设备设置为device。

另请参阅 device()。

void QBluetoothServiceInfo::setServiceAvailability(quint8 availability)

这是一个便利函数。它与调用setAttribute(QBluetoothServiceInfo::ServiceAvailability, availability)等价。

将服务的可用性设置为availability。

另请参阅 serviceAvailability() 和 setAttribute。

void QBluetoothServiceInfo::setServiceDescription(const QString &description)

这是一个便利函数。它与调用setAttribute(QBluetoothServiceInfo::ServiceDescription, description)等价。

将主要语言的-service描述设置为description。

另请参阅 serviceDescription() 和 setAttribute。

void QBluetoothServiceInfo::setServiceName(const QString &name)

这是一个便利函数。它与调用setAttribute(QBluetoothServiceInfo::ServiceName, name)等价。

将主要语言的服务名称设置为name。

另请参阅 serviceName() 和 setAttribute。

void QBluetoothServiceInfo::setServiceProvider(const QString &provider)

这是一个便利函数。它与调用setAttribute(QBluetoothServiceInfo::ServiceProvider, provider)等价。

将主要语言的服务提供者设置为provider。

另请参阅 serviceProvider() 和 setAttribute。

void QBluetoothServiceInfo::setServiceUuid(const QBluetoothUuid &uuid)

这是一个便利函数。它与调用setAttribute(QBluetoothServiceInfo::ServiceId, uuid)等价。

将自定义服务UUID设置为uuid。此函数不应用于设置标准化的服务UUID。

另请参阅 serviceUuid() 和 setAttribute。

QBluetoothServiceInfo::Protocol QBluetoothServiceInfo::socketProtocol() const

返回QBluetoothServiceInfo对象使用的协议。

bool QBluetoothServiceInfo::unregisterService()

此函数将从平台的Service Discovery Protocol (SDP) 实现中注销此服务。之后，服务将无法通过服务发现被其他设备找到。

如果服务成功注销，则返回true，否则返回false。

QBluetoothServiceInfo &QBluetoothServiceInfo::operator=(const QBluetoothServiceInfo &other)

复制other并将其分配给此QBluetoothServiceInfo对象。这两个副本将继续共享相同的服务和注册详细信息。