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.
| Constante | Valor | Descripción |
|---|---|---|
QBluetoothServiceInfo::ServiceRecordHandle | 0x0000 | Especifica un registro de servicio del que se pueden recuperar atributos. |
QBluetoothServiceInfo::ServiceClassIds | 0x0001 | UUID 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::ServiceRecordState | 0x0002 | El atributo cambia cuando se añade, elimina o modifica cualquier otro atributo del servicio. |
QBluetoothServiceInfo::ServiceId | 0x0003 | UUID que identifica de forma única el servicio. |
QBluetoothServiceInfo::ProtocolDescriptorList | 0x0004 | Lista de protocolos utilizados por el servicio. Los UUID de protocolo más comunes se definen en QBluetoothUuid::ProtocolUuid |
QBluetoothServiceInfo::BrowseGroupList | 0x0005 | Lista de grupos de exploración en los que se encuentra el servicio. |
QBluetoothServiceInfo::LanguageBaseAttributeIdList | 0x0006 | Lista de identificadores de atributos de base de idioma para admitir atributos legibles por el ser humano. |
QBluetoothServiceInfo::ServiceInfoTimeToLive | 0x0007 | Número de segundos durante los cuales se espera que el registro del servicio permanezca válido y sin cambios. |
QBluetoothServiceInfo::ServiceAvailability | 0x0008 | Valor que indica la disponibilidad del servicio. |
QBluetoothServiceInfo::BluetoothProfileDescriptorList | 0x0009 | Lista de perfiles a los que se ajusta el servicio. |
QBluetoothServiceInfo::DocumentationUrl | 0x000A | URL que apunta a la documentación del servicio. |
QBluetoothServiceInfo::ClientExecutableUrl | 0x000B | URL que remite a la ubicación de una aplicación que puede utilizarse para hacer uso del servicio. |
QBluetoothServiceInfo::IconUrl | 0x000C | URL que apunta a la ubicación del icono que representa el servicio. |
QBluetoothServiceInfo::AdditionalProtocolDescriptorList | 0x000D | Protocolos adicionales utilizados por el servicio. Este atributo amplía el atributo « ProtocolDescriptorList ». |
QBluetoothServiceInfo::PrimaryLanguageBase | 0x0100 | Índice base para los descriptores de texto en el idioma principal. |
QBluetoothServiceInfo::ServiceName | PrimaryLanguageBase + 0x0000 | Nombre del servicio Bluetooth en el idioma principal. |
QBluetoothServiceInfo::ServiceDescription | PrimaryLanguageBase + 0x0001 | Descripción del servicio Bluetooth en el idioma principal. |
QBluetoothServiceInfo::ServiceProvider | PrimaryLanguageBase + 0x0002 | Nombre 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.
| Constante | Valor | Descripción |
|---|---|---|
QBluetoothServiceInfo::UnknownProtocol | 0 | El servicio utiliza un protocolo de socket desconocido. |
QBluetoothServiceInfo::L2capProtocol | 1 | El servicio utiliza el protocolo de socket L2CAP. Este protocolo no es compatible con las conexiones directas de socket en Android. |
QBluetoothServiceInfo::RfcommProtocol | 2 | El 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.