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

以QBluetoothServiceInfo::Sequence 的形式返回协议参数，用于协议protocol 。

如果不支持protocol ，则返回空QBluetoothServiceInfo::Sequence 。

int QBluetoothServiceInfo::protocolServiceMultiplexer() const

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

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

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::Sequence 中提取QBluetoothServiceInfo::attribute （QBluetootherServiceInfo::ProtocolDescriptorList）返回的信息。

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 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 对象。这两个副本继续共享相同的服务和注册详细信息。