QBluetoothServiceInfo Class

成员函数文档

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

如果服务信息已在平台的“服务发现协议”（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::attribute 返回的QBluetoothServiceInfo::Sequence 中提取信息（QBluetoothServiceInfo::ProtocolDescriptorList ）。

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

将该服务注册到平台的服務发现协议（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 可能为 null。基于Bluetooth SIG 标准的UUID 应通过serviceClassUuids() 获取。

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

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

这是一个便捷函数。

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

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

另请参阅 attribute()。

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

这是一个便捷函数。

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

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

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

这是一个便捷函数。

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

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

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

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

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

另请参阅 isRegistered() 和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)。

将主语言下的服务描述设置为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()

从平台的服務發現協議（SDP）实现中注销该服务。此后，其他设备将无法再通过服务发现找到该服务。

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

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

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