QBluetoothSocket Class

Member Function Documentation

QBluetoothSocket::QBluetoothSocket(QObject *parent = nullptr)

Constructs a Bluetooth socket with parent.

QBluetoothSocket::QBluetoothSocket(QBluetoothServiceInfo::Protocol socketType, QObject *parent = nullptr)

Constructs a Bluetooth socket of socketType type, with parent.

[signal] void QBluetoothSocket::connected()

This signal is emitted when a connection is established.

See also QBluetoothSocket::ConnectedState and stateChanged().

[signal] void QBluetoothSocket::disconnected()

This signal is emitted when the socket is disconnected.

See also QBluetoothSocket::UnconnectedState and stateChanged().

[signal] void QBluetoothSocket::error(QBluetoothSocket::SocketError error)

This signal is emitted when an error occurs.

Note: Signal error is overloaded in this class. To connect to this signal by using the function pointer syntax, Qt provides a convenient helper for obtaining the function pointer as shown in this example:

connect(bluetoothSocket, QOverload<QBluetoothSocket::SocketError>::of(&QBluetoothSocket::error),
    [=](QBluetoothSocket::SocketError error){ /* ... */ });

See also error().

[signal] void QBluetoothSocket::stateChanged(QBluetoothSocket::SocketState state)

This signal is emitted when the socket state changes to state.

See also connected(), disconnected(), state(), and QBluetoothSocket::SocketState.

[virtual] QBluetoothSocket::~QBluetoothSocket()

Destroys the Bluetooth socket.

void QBluetoothSocket::abort()

Aborts the current connection and resets the socket. Unlike disconnectFromService(), this function immediately closes the socket, discarding any pending data in the write buffer.

See also disconnectFromService() and close().

[override virtual] qint64 QBluetoothSocket::bytesAvailable() const

Reimplements: QIODevice::bytesAvailable() const.

Returns the number of incoming bytes that are waiting to be read.

See also bytesToWrite() and read().

[override virtual] qint64 QBluetoothSocket::bytesToWrite() const

Reimplements: QIODevice::bytesToWrite() const.

Returns the number of bytes that are waiting to be written. The bytes are written when control goes back to the event loop.

[override virtual] bool QBluetoothSocket::canReadLine() const

Reimplements: QIODevice::canReadLine() const.

Returns true if you can read at least one line from the device

[override virtual] void QBluetoothSocket::close()

Reimplements: QIODevice::close().

Disconnects the socket's connection with the device.

void QBluetoothSocket::connectToService(const QBluetoothServiceInfo &service, QIODevice::OpenMode openMode = ReadWrite)

Attempts to connect to the service described by service.

The socket is opened in the given openMode. The socketType() is ignored if service specifies a differing QBluetoothServiceInfo::socketProtocol().

The socket first enters ConnectingState and attempts to connect to the device providing service. If a connection is established, QBluetoothSocket enters ConnectedState and emits connected().

At any point, the socket can emit error() to signal that an error occurred.

Note that most platforms require a pairing prior to connecting to the remote device. Otherwise the connection process may fail.

On Android, only RFCOMM connections are possible. This function ignores any socket protocol indicator and assumes RFCOMM.

See also state() and disconnectFromService().

void QBluetoothSocket::connectToService(const QBluetoothAddress &address, const QBluetoothUuid &uuid, QIODevice::OpenMode openMode = ReadWrite)

Attempts to make a connection to the service identified by uuid on the device with address address.

The socket is opened in the given openMode.

For BlueZ, the socket first enters the ServiceLookupState and queries the connection parameters for uuid. If the service parameters are successfully retrieved the socket enters ConnectingState, and attempts to connect to address. If a connection is established, QBluetoothSocket enters ConnectedState and emits connected().

On Android, the service connection can directly be established using the UUID of the remote service. Therefore the platform does not require the ServiceLookupState and socketType() is always set to QBluetoothServiceInfo::RfcommProtocol.

At any point, the socket can emit error() to signal that an error occurred.

Note that most platforms require a pairing prior to connecting to the remote device. Otherwise the connection process may fail.

See also state() and disconnectFromService().

void QBluetoothSocket::connectToService(const QBluetoothAddress &address, quint16 port, QIODevice::OpenMode openMode = ReadWrite)

Attempts to make a connection with address on the given port.

The socket is opened in the given openMode.

The socket first enters ConnectingState, and attempts to connect to address. If a connection is established, QBluetoothSocket enters ConnectedState and emits connected().

At any point, the socket can emit error() to signal that an error occurred.

On Android and BlueZ (version 5.46 or above), a connection to a service can not be established using a port. Calling this function will emit a ServiceNotFoundError.

Note that most platforms require a pairing prior to connecting to the remote device. Otherwise the connection process may fail.

See also state() and disconnectFromService().

void QBluetoothSocket::disconnectFromService()

Attempts to close the socket. If there is pending data waiting to be written QBluetoothSocket will enter ClosingState and wait until all data has been written. Eventually, it will enter UnconnectedState and emit the disconnected() signal.

See also connectToService().

[protected] void QBluetoothSocket::doDeviceDiscovery(const QBluetoothServiceInfo &service, QIODevice::OpenMode openMode)

Start device discovery for service and open the socket with openMode. If the socket is created with a service uuid device address, use service discovery to find the port number to connect to.

QBluetoothSocket::SocketError QBluetoothSocket::error() const

Returns the last error.

QString QBluetoothSocket::errorString() const

Returns a user displayable text string for the error.

[override virtual] bool QBluetoothSocket::isSequential() const

Reimplements: QIODevice::isSequential() const.

QBluetoothAddress QBluetoothSocket::localAddress() const

Returns the address of the local device.

Although some platforms may differ the socket must generally be connected to guarantee the return of a valid address. In particular, this is true when dealing with platforms that support multiple local Bluetooth adapters.

QString QBluetoothSocket::localName() const

Returns the name of the local device.

Although some platforms may differ the socket must generally be connected to guarantee the return of a valid name. In particular, this is true when dealing with platforms that support multiple local Bluetooth adapters.

quint16 QBluetoothSocket::localPort() const

Returns the port number of the local socket if available, otherwise returns 0. Although some platforms may differ the socket must generally be connected to guarantee the return of a valid port number.

On Android and macOS, this feature is not supported and returns 0.

QBluetoothAddress QBluetoothSocket::peerAddress() const

Returns the address of the peer device.

QString QBluetoothSocket::peerName() const

Returns the name of the peer device.

quint16 QBluetoothSocket::peerPort() const

Return the port number of the peer socket if available, otherwise returns 0. On Android, this feature is not supported.

QBluetooth::SecurityFlags QBluetoothSocket::preferredSecurityFlags() const

Returns the security parameters used for the initial connection attempt.

The security parameters may be renegotiated between the two parties during or after the connection has been established. If such a change happens it is not reflected in the value of this flag.

On macOS, this flag is always set to QBluetooth::Secure.

This function was introduced in Qt 5.6.

See also setPreferredSecurityFlags().

[override virtual protected] qint64 QBluetoothSocket::readData(char *data, qint64 maxSize)

Reimplements: QIODevice::readData(char *data, qint64 maxSize).

void QBluetoothSocket::setPreferredSecurityFlags(QBluetooth::SecurityFlags flags)

Sets the preferred security parameter for the connection attempt to flags. This value is incorporated when calling connectToService(). Therefore it is required to reconnect to change this parameter for an existing connection.

On Bluez this property is set to QBluetooth::Authorization by default.

On macOS, this value is ignored as the platform does not permit access to the security parameter of the socket. By default the platform prefers secure/encrypted connections though and therefore this function always returns QBluetooth::Secure.

Android only supports two levels of security (secure and non-secure). If this flag is set to QBluetooth::NoSecurity the socket object will not employ any authentication or encryption. Any other security flag combination will trigger a secure Bluetooth connection. This flag is set to QBluetooth::Secure by default.

This function was introduced in Qt 5.6.

See also preferredSecurityFlags().

bool QBluetoothSocket::setSocketDescriptor(int socketDescriptor, QBluetoothServiceInfo::Protocol socketType, QBluetoothSocket::SocketState socketState = ConnectedState, QIODevice::OpenMode openMode = ReadWrite)

Set the socket to use socketDescriptor with a type of socketType, which is in state, socketState, and mode, openMode.

The set socket descriptor is considered owned by the QBluetoothSocket and may be e.g. closed once finished.

Returns true on success

See also socketDescriptor().

[protected] void QBluetoothSocket::setSocketError(QBluetoothSocket::SocketError error_)

Sets the type of error that last occurred to error_.

[protected] void QBluetoothSocket::setSocketState(QBluetoothSocket::SocketState state)

Sets the socket state to state.

int QBluetoothSocket::socketDescriptor() const

Returns the platform-specific socket descriptor, if available. This function returns -1 if the descriptor is not available or an error has occurred.

See also setSocketDescriptor().

QBluetoothServiceInfo::Protocol QBluetoothSocket::socketType() const

Returns the socket type. The socket automatically adjusts to the protocol offered by the remote service.

Android only support RFCOMM based sockets.

QBluetoothSocket::SocketState QBluetoothSocket::state() const

Returns the current state of the socket.

[override virtual protected] qint64 QBluetoothSocket::writeData(const char *data, qint64 maxSize)

Reimplements: QIODevice::writeData(const char *data, qint64 maxSize).