QBluetoothServer Class

Documentación de las funciones miembro

[explicit] QBluetoothServer::QBluetoothServer(QBluetoothServiceInfo::Protocol serverType, QObject *parent = nullptr)

Construye un servidor bluetooth con parent y serverType.

[virtual noexcept] QBluetoothServer::~QBluetoothServer()

Destruye el servidor bluetooth.

void QBluetoothServer::close()

Cierra y reinicia el socket de escucha. Cualquier QBluetoothSocket ya establecido continúa funcionando y debe ser closed por separado.

QBluetoothServer::Error QBluetoothServer::error() const

Devuelve el último error de la QBluetoothServer.

[signal, since 6.2] void QBluetoothServer::errorOccurred(QBluetoothServer::Error error)

Esta señal se emite cuando se produce un error.

Esta función se introdujo en Qt 6.2.

Véase también error() y QBluetoothServer::Error.

bool QBluetoothServer::hasPendingConnections() const

Devuelve true si hay una conexión pendiente, en caso contrario false.

bool QBluetoothServer::isListening() const

Devuelve true si el servidor está a la escucha de conexiones entrantes, en caso contrario false.

bool QBluetoothServer::listen(const QBluetoothAddress &address = QBluetoothAddress(), quint16 port = 0)

Empieza a escuchar conexiones entrantes a address en port. address debe ser una dirección de adaptador Bluetooth local y port debe ser mayor que cero y no estar tomada ya por otro objeto servidor Bluetooth. Se recomienda evitar establecer un número de puerto para permitir que el sistema elija un puerto automáticamente.

Devuelve true si la operación ha tenido éxito y el servidor está a la escucha de conexiones entrantes, en caso contrario devuelve false.

Si el objeto servidor ya está a la escucha de conexiones entrantes, esta función siempre devuelve false. Antes de llamar a esta función, debe invocarse a close().

Véase también isListening() y newConnection().

QBluetoothServiceInfo QBluetoothServer::listen(const QBluetoothUuid &uuid, const QString &serviceName = QString())

Función de conveniencia para registrar un servicio SPP con uuid y serviceName. Dado que esta función ya registra el servicio, el objeto QBluetoothServiceInfo que se devuelve ya no se puede modificar. Para apagar el servidor más tarde es necesario llamar a QBluetoothServiceInfo::unregisterService() y close() en este objeto servidor.

Devuelve una instancia registrada de QBluetoothServiceInfo si tiene éxito, en caso contrario, un QBluetoothServiceInfo inválido. Esta función siempre asume que se debe utilizar el adaptador Bluetooth por defecto.

Si el objeto servidor ya está escuchando conexiones entrantes, esta función devuelve un QBluetoothServiceInfo no válido.

Para un servidor RFCOMM esta función es equivalente al siguiente fragmento de código.

    QBluetoothServiceInfo serviceInfo;
    serviceInfo.setAttribute(QBluetoothServiceInfo::ServiceName, serviceName);
    QBluetoothServiceInfo::Sequence browseSequence;
    browseSequence << QVariant::fromValue(QBluetoothUuid(QBluetoothUuid::ServiceClassUuid::PublicBrowseGroup));
    serviceInfo.setAttribute(QBluetoothServiceInfo::BrowseGroupList,
                             browseSequence);

    QBluetoothServiceInfo::Sequence profileSequence;
    QBluetoothServiceInfo::Sequence classId;
    classId << QVariant::fromValue(QBluetoothUuid(QBluetoothUuid::ServiceClassUuid::SerialPort));
    classId << QVariant::fromValue(quint16(0x100));
    profileSequence.append(QVariant::fromValue(classId));
    serviceInfo.setAttribute(QBluetoothServiceInfo::BluetoothProfileDescriptorList,
                             profileSequence);

    classId.clear();
    //Android requires custom uuid to be set as service class
    classId << QVariant::fromValue(uuid);
    classId << QVariant::fromValue(QBluetoothUuid(QBluetoothUuid::ServiceClassUuid::SerialPort));
    serviceInfo.setAttribute(QBluetoothServiceInfo::ServiceClassIds, classId);
    serviceInfo.setServiceUuid(uuid);

    QBluetoothServiceInfo::Sequence protocolDescriptorList;
    QBluetoothServiceInfo::Sequence protocol;
    protocol << QVariant::fromValue(QBluetoothUuid(QBluetoothUuid::ProtocolUuid::L2cap));
    if (d->serverType == QBluetoothServiceInfo::L2capProtocol)
        protocol << QVariant::fromValue(serverPort());
    protocolDescriptorList.append(QVariant::fromValue(protocol));
    protocol.clear();
    protocol << QVariant::fromValue(QBluetoothUuid(QBluetoothUuid::ProtocolUuid::Rfcomm))
             << QVariant::fromValue(quint8(serverPort()));
    protocolDescriptorList.append(QVariant::fromValue(protocol));
    serviceInfo.setAttribute(QBluetoothServiceInfo::ProtocolDescriptorList,
                             protocolDescriptorList);
    bool result = serviceInfo.registerService();

Véase también isListening(), newConnection(), y listen().

int QBluetoothServer::maxPendingConnections() const

Devuelve el número máximo de conexiones pendientes.

Véase también setMaxPendingConnections().

[signal] void QBluetoothServer::newConnection()

Esta señal se emite cuando hay una nueva conexión disponible.

La ranura conectada debe llamar a nextPendingConnection() para obtener un objeto QBluetoothSocket para enviar y recibir datos a través de la conexión.

Véase también nextPendingConnection() y hasPendingConnections().

QBluetoothSocket *QBluetoothServer::nextPendingConnection()

Devuelve un puntero a QBluetoothSocket para la siguiente conexión pendiente. Es responsabilidad de quien llama eliminar el puntero.

QBluetooth::SecurityFlags QBluetoothServer::securityFlags() const

Devuelve los indicadores de seguridad de Bluetooth.

Véase también setSecurityFlags().

QBluetoothAddress QBluetoothServer::serverAddress() const

Devuelve la dirección del servidor.

quint16 QBluetoothServer::serverPort() const

Devuelve el número de puerto del servidor.

QBluetoothServiceInfo::Protocol QBluetoothServer::serverType() const

Devuelve el tipo de QBluetoothServer.

void QBluetoothServer::setMaxPendingConnections(int numConnections)

Establece el número máximo de conexiones pendientes en numConnections. Si el número de conexiones pendientes supera este límite, se rechazarán nuevas conexiones.

Véase también maxPendingConnections().

void QBluetoothServer::setSecurityFlags(QBluetooth::SecurityFlags security)

Establece los indicadores de seguridad Bluetooth en security. Esta función debe llamarse antes de llamar a listen(). El enlace Bluetooth siempre estará cifrado cuando se utilicen dispositivos Bluetooth 2.1, ya que el cifrado es obligatorio.

Android sólo soporta dos niveles de seguridad (seguro y no seguro). Si esta bandera se establece en QBluetooth::Security::NoSecurity el objeto servidor no empleará ningún tipo de autenticación o encriptación. Cualquier otra combinación de indicadores de seguridad activará una conexión Bluetooth segura.

En macOS, los indicadores de seguridad no están soportados y serán ignorados.

Véase también securityFlags().