En esta página

QBluetoothServiceInfo Class

La clase `QBluetoothServiceInfo` permite acceder a los atributos de un servicio Bluetooth. Más información...

Encabezado: #include <QBluetoothServiceInfo>
CMake: find_package(Qt6 REQUIRED COMPONENTS Bluetooth)
target_link_libraries(mytarget PRIVATE Qt6::Bluetooth)
qmake: QT += bluetooth

Tipos públicos

class Alternative
class Sequence
enum AttributeId { ServiceRecordHandle, ServiceClassIds, ServiceRecordState, ServiceId, ProtocolDescriptorList, …, ServiceProvider }
enum Protocol { UnknownProtocol, L2capProtocol, RfcommProtocol }

Funciones públicas

QBluetoothServiceInfo()
QBluetoothServiceInfo(const QBluetoothServiceInfo &other)
~QBluetoothServiceInfo()
QVariant attribute(quint16 attributeId) const
QList<quint16> attributes() const
bool contains(quint16 attributeId) const
QBluetoothDeviceInfo device() const
bool isComplete() const
bool isRegistered() const
bool isValid() const
QBluetoothServiceInfo::Sequence protocolDescriptor(QBluetoothUuid::ProtocolUuid protocol) const
int protocolServiceMultiplexer() const
bool registerService(const QBluetoothAddress &localAdapter = QBluetoothAddress())
void removeAttribute(quint16 attributeId)
int serverChannel() const
quint8 serviceAvailability() const
QList<QBluetoothUuid> serviceClassUuids() const
QString serviceDescription() const
QString serviceName() const
QString serviceProvider() const
QBluetoothUuid serviceUuid() const
void setAttribute(quint16 attributeId, const QBluetoothServiceInfo::Alternative &value)
void setAttribute(quint16 attributeId, const QBluetoothServiceInfo::Sequence &value)
void setAttribute(quint16 attributeId, const QBluetoothUuid &value)
void setAttribute(quint16 attributeId, const QVariant &value)
void setDevice(const QBluetoothDeviceInfo &device)
void setServiceAvailability(quint8 availability)
void setServiceDescription(const QString &description)
void setServiceName(const QString &name)
void setServiceProvider(const QString &provider)
void setServiceUuid(const QBluetoothUuid &uuid)
QBluetoothServiceInfo::Protocol socketProtocol() const
bool unregisterService()
QBluetoothServiceInfo &operator=(const QBluetoothServiceInfo &other)

Descripción detallada

QBluetoothServiceInfo proporciona información sobre un servicio ofrecido por un dispositivo Bluetooth. Además, se puede utilizar para registrar nuevos servicios en el dispositivo local. Ten en cuenta que dicho registro solo afecta a las entradas SDP de Bluetooth. Cualquier servidor que esté a la escucha de conexiones entrantes (por ejemplo, un servidor RFCOMM) debe iniciarse antes de llamar a registerService(). La cancelación del registro debe realizarse en orden inverso.

`QBluetoothServiceInfo` no es un tipo de valor en el sentido tradicional. Todas las copias del mismo objeto de información de servicio comparten los mismos datos, ya que no se separan al modificarlos. Esto garantiza que dos copias puedan (des)registrar el mismo servicio Bluetooth.

En iOS, esta clase no se puede utilizar porque la plataforma no expone una API que permita el acceso a las funciones relacionadas con `QBluetoothServiceInfo`.

Documentación de los tipos de miembros

enum QBluetoothServiceInfo::AttributeId

Atributos del servicio Bluetooth. Consulta la Especificación Básica de Bluetooth para obtener una descripción más detallada de estos atributos.

ConstanteValorDescripción
QBluetoothServiceInfo::ServiceRecordHandle0x0000Especifica un registro de servicio del que se pueden recuperar atributos.
QBluetoothServiceInfo::ServiceClassIds0x0001UUID de las clases de servicio a las que se ajusta el servicio. Las clases de servicio más comunes se definen en (QBluetoothUuid::ServiceClassUuid)
QBluetoothServiceInfo::ServiceRecordState0x0002El atributo cambia cuando se añade, elimina o modifica cualquier otro atributo del servicio.
QBluetoothServiceInfo::ServiceId0x0003UUID que identifica de forma única el servicio.
QBluetoothServiceInfo::ProtocolDescriptorList0x0004Lista de protocolos utilizados por el servicio. Los UUID de protocolo más comunes se definen en QBluetoothUuid::ProtocolUuid
QBluetoothServiceInfo::BrowseGroupList0x0005Lista de grupos de exploración en los que se encuentra el servicio.
QBluetoothServiceInfo::LanguageBaseAttributeIdList0x0006Lista de identificadores de atributos de base de idioma para admitir atributos legibles por el ser humano.
QBluetoothServiceInfo::ServiceInfoTimeToLive0x0007Número de segundos durante los cuales se espera que el registro del servicio permanezca válido y sin cambios.
QBluetoothServiceInfo::ServiceAvailability0x0008Valor que indica la disponibilidad del servicio.
QBluetoothServiceInfo::BluetoothProfileDescriptorList0x0009Lista de perfiles a los que se ajusta el servicio.
QBluetoothServiceInfo::DocumentationUrl0x000AURL que apunta a la documentación del servicio.
QBluetoothServiceInfo::ClientExecutableUrl0x000BURL que remite a la ubicación de una aplicación que puede utilizarse para hacer uso del servicio.
QBluetoothServiceInfo::IconUrl0x000CURL que apunta a la ubicación del icono que representa el servicio.
QBluetoothServiceInfo::AdditionalProtocolDescriptorList0x000DProtocolos adicionales utilizados por el servicio. Este atributo amplía el atributo « ProtocolDescriptorList ».
QBluetoothServiceInfo::PrimaryLanguageBase0x0100Índice base para los descriptores de texto en el idioma principal.
QBluetoothServiceInfo::ServiceNamePrimaryLanguageBase + 0x0000Nombre del servicio Bluetooth en el idioma principal.
QBluetoothServiceInfo::ServiceDescriptionPrimaryLanguageBase + 0x0001Descripción del servicio Bluetooth en el idioma principal.
QBluetoothServiceInfo::ServiceProviderPrimaryLanguageBase + 0x0002Nombre de la empresa o entidad que proporciona el servicio Bluetooth en el idioma principal.

Nota: En Windows, ServiceClassIds y ProtocolDescriptorList se establecen automáticamente en valores predeterminados al crear un servicio. Establecer manualmente los valores de estos atributos no funcionará y podría dar lugar a resultados inesperados en esta plataforma.

enum QBluetoothServiceInfo::Protocol

Esta enumeración describe el protocolo de socket utilizado por el servicio.

ConstanteValorDescripción
QBluetoothServiceInfo::UnknownProtocol0El servicio utiliza un protocolo de socket desconocido.
QBluetoothServiceInfo::L2capProtocol1El servicio utiliza el protocolo de socket L2CAP. Este protocolo no es compatible con las conexiones directas de socket en Android.
QBluetoothServiceInfo::RfcommProtocol2El servicio utiliza el protocolo de socket RFCOMM.

Documentación de las funciones miembro

QBluetoothServiceInfo::QBluetoothServiceInfo()

Crea un nuevo objeto QBluetoothServiceInfo no válido;

QBluetoothServiceInfo::QBluetoothServiceInfo(const QBluetoothServiceInfo &other)

Crea un nuevo objeto `QBluetoothServiceInfo` que sea una copia de ` other`.

Las dos copias siguen compartiendo los mismos datos subyacentes, que no se separan al escribir.

[noexcept] QBluetoothServiceInfo::~QBluetoothServiceInfo()

Elimina el objeto « QBluetoothServiceInfo ».

QVariant QBluetoothServiceInfo::attribute(quint16 attributeId) const

Devuelve el valor del atributo « attributeId ».

Véase también ` setAttribute()`.

QList<quint16> QBluetoothServiceInfo::attributes() const

Devuelve una lista con todos los identificadores de atributos que tiene el objeto ` QBluetoothServiceInfo `.

bool QBluetoothServiceInfo::contains(quint16 attributeId) const

Devuelve «true» si el objeto ` QBluetoothServiceInfo ` contiene el atributo ` attributeId`; en caso contrario, devuelve «false».

QBluetoothDeviceInfo QBluetoothServiceInfo::device() const

Devuelve la dirección del dispositivo Bluetooth que ofrece este servicio.

Véase también setDevice().

bool QBluetoothServiceInfo::isComplete() const

Devuelve «true» si el objeto ` QBluetoothServiceInfo ` se considera completo; en caso contrario, devuelve «false».

Un objeto ` QBluetoothServiceInfo ` completo contiene un atributo ` ProtocolDescriptorList `.

bool QBluetoothServiceInfo::isRegistered() const

Devuelve «true» si la información del servicio está registrada en la implementación del Protocolo de Detección de Servicios (SDP) de la plataforma; en caso contrario, devuelve «false».

bool QBluetoothServiceInfo::isValid() const

Devuelve «true» si el objeto ` QBluetoothServiceInfo ` es válido; en caso contrario, devuelve «false».

Un objeto ` QBluetoothServiceInfo ` no válido no tendrá atributos.

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

Devuelve los parámetros del protocolo como un objeto ` QBluetoothServiceInfo::Sequence ` para el protocolo ` protocol`.

Se devuelve un objeto ` QBluetoothServiceInfo::Sequence ` vacío si no se admite el protocolo ` protocol `.

int QBluetoothServiceInfo::protocolServiceMultiplexer() const

Esta es una función de conveniencia. Devuelve el multiplexor de protocolo/servicio para los servicios que admiten el protocolo L2CAP; en caso contrario, devuelve -1.

Esta función equivale a extraer la información de ` QBluetoothServiceInfo::Sequence `, devuelta por ` QBluetoothServiceInfo::attribute` (QBluetoothServiceInfo::ProtocolDescriptorList).

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

Registra este servicio en la implementación del Protocolo de Detección de Servicios (SDP) de la plataforma, lo que permite que otros dispositivos lo encuentren cuando realizan la detección de servicios. Devuelve «true» si el servicio se registra correctamente; en caso contrario, devuelve «false». Una vez registrado, no se pueden realizar cambios en el registro. Es necesario dar de baja el servicio y volver a registrarlo con los cambios.

El parámetro « localAdapter » determina el adaptador Bluetooth local bajo el cual debe registrarse el servicio. Si « localAdapter » es « null », se utilizará el adaptador Bluetooth predeterminado. Si este objeto de información del servicio ya está registrado a través de un adaptador local y se invoca esta función utilizando un adaptador local diferente, se elimina el registro anterior y el servicio se vuelve a registrar utilizando el nuevo adaptador.

void QBluetoothServiceInfo::removeAttribute(quint16 attributeId)

Elimina el atributo « attributeId » del objeto « QBluetoothServiceInfo ».

Si la información del servicio ya está registrada en la base de datos SDP de la plataforma, la entrada de la base de datos no se actualizará hasta que se vuelva a llamar a la función registerService().

int QBluetoothServiceInfo::serverChannel() const

Esta es una función de conveniencia. Devuelve el canal del servidor para los servicios que admiten el protocolo RFCOMM; en caso contrario, devuelve -1.

Esta función equivale a extraer la información de ` QBluetoothServiceInfo::Sequence ` devuelta por ` QBluetoothServiceInfo::attribute` (QBluetootherServiceInfo::ProtocolDescriptorList).

quint8 QBluetoothServiceInfo::serviceAvailability() const

Esta es una función de conveniencia. Equivale a llamar a `attribute(QBluetoothServiceInfo::ServiceAvailability).toUInt()`.

Devuelve la disponibilidad del servicio.

Véanse también ` setServiceAvailability()` y ` attribute()`.

QList<QBluetoothUuid> QBluetoothServiceInfo::serviceClassUuids() const

Devuelve una lista de UUID que describen las clases de servicio a las que se ajusta este servicio.

Se trata de una función de conveniencia. Equivale a llamar a attribute(QBluetoothServiceInfo::ServiceClassIds).value<QBluetoothServiceInfo::Sequence>() y, a continuación, iterar sobre sus entradas QBluetoothUuid.

Véase también attribute().

QString QBluetoothServiceInfo::serviceDescription() const

Esta es una función de conveniencia. Equivale a llamar a `attribute(QBluetoothServiceInfo::ServiceDescription).toString()`.

Devuelve la descripción del servicio en el idioma principal.

Véanse también setServiceDescription() y attribute().

QString QBluetoothServiceInfo::serviceName() const

Esta es una función de conveniencia. Equivale a llamar a attribute(QBluetoothServiceInfo::ServiceName).toString().

Devuelve el nombre del servicio en el idioma principal.

Véase también setServiceName() y attribute().

QString QBluetoothServiceInfo::serviceProvider() const

Esta es una función de conveniencia. Equivale a llamar a `attribute(QBluetoothServiceInfo::ServiceProvider).toString()`.

Devuelve el proveedor de servicios en el idioma principal.

Véase también ` setServiceProvider()` y ` attribute()`.

QBluetoothUuid QBluetoothServiceInfo::serviceUuid() const

Esta es una función de conveniencia. Equivale a llamar a attribute(QBluetoothServiceInfo::ServiceId).value<QBluetoothUuid>().

Devuelve el UUID personalizado del servicio. Este UUID puede ser nulo. Los UUID basados en los estándares de Bluetooth SIG deben obtenerse mediante serviceClassUuids().

Véanse también setServiceUuid() y attribute().

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

Esta es una función de conveniencia.

Establece el atributo identificado por « attributeId » en « value ».

Si la información del servicio ya está registrada en la base de datos SDP de la plataforma, la entrada de la base de datos no se actualizará hasta que se vuelva a llamar a registerService().

Véase también ` attribute()`.

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

Esta es una función de conveniencia.

Establece el atributo identificado por ` attributeId ` en ` value`.

Si la información del servicio ya está registrada en la base de datos SDP de la plataforma, la entrada de la base de datos no se actualizará hasta que se vuelva a llamar a registerService().

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

Esta es una función de conveniencia.

Establece el atributo identificado por ` attributeId ` en ` value`.

Si la información del servicio ya está registrada en la base de datos SDP de la plataforma, la entrada de la base de datos no se actualizará hasta que se vuelva a llamar a registerService().

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

Establece el atributo identificado por « attributeId » en « value ».

Si la información del servicio ya está registrada en la base de datos SDP de la plataforma, la entrada de la base de datos no se actualizará hasta que se vuelva a llamar a registerService().

Nota: Si un atributo espera un valor codificado en bytes (por ejemplo, los servicios HID de Bluetooth), debe establecerse como ` QByteArray`.

Véase también isRegistered() y registerService().

void QBluetoothServiceInfo::setDevice(const QBluetoothDeviceInfo &device)

Establece el dispositivo Bluetooth que presta este servicio en device.

Véase también device().

void QBluetoothServiceInfo::setServiceAvailability(quint8 availability)

Esta es una función de conveniencia. Equivale a llamar a ` setAttribute(QBluetoothServiceInfo::ServiceAvailability, disponibilidad)`.

Establece la disponibilidad del servicio en « availability ».

Véase también serviceAvailability() y setAttribute().

void QBluetoothServiceInfo::setServiceDescription(const QString &description)

Esta es una función de conveniencia. Equivale a llamar a setAttribute(QBluetoothServiceInfo::ServiceDescription, description).

Establece la descripción del servicio en el idioma principal como « description ».

Véase también serviceDescription() y setAttribute().

void QBluetoothServiceInfo::setServiceName(const QString &name)

Esta es una función de conveniencia. Equivale a llamar a setAttribute(QBluetoothServiceInfo::ServiceName, nombre).

Establece el nombre del servicio en el idioma principal como « name ».

Véase también serviceName() y setAttribute().

void QBluetoothServiceInfo::setServiceProvider(const QString &provider)

Esta es una función de conveniencia. Equivale a llamar a setAttribute(QBluetoothServiceInfo::ServiceProvider, provider).

Establece el proveedor de servicios en el idioma principal como provider.

Véanse también serviceProvider() y setAttribute().

void QBluetoothServiceInfo::setServiceUuid(const QBluetoothUuid &uuid)

Esta es una función de conveniencia. Equivale a llamar a setAttribute(QBluetoothServiceInfo::ServiceId, uuid).

Establece el UUID del servicio personalizado en uuid. Esta función no debe utilizarse para establecer un UUID de servicio estandarizado.

Véase también serviceUuid() y setAttribute().

QBluetoothServiceInfo::Protocol QBluetoothServiceInfo::socketProtocol() const

Devuelve el protocolo que utiliza el objeto ` QBluetoothServiceInfo `.

bool QBluetoothServiceInfo::unregisterService()

Da de baja este servicio en la implementación del Protocolo de Detección de Servicios (SDP) de la plataforma. A partir de ese momento, los demás dispositivos ya no podrán localizar el servicio mediante la detección de servicios.

Devuelve «true» si el servicio se ha dado de baja correctamente; en caso contrario, devuelve «false».

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

Crea una copia del objeto « other » y la asigna a este objeto « QBluetoothServiceInfo ». Las dos copias siguen compartiendo los mismos datos de servicio y registro.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.