QBluetoothSocket Class

Documentation des fonctions membres

[explicit] QBluetoothSocket::QBluetoothSocket(QObject *parent = nullptr)

Construit une prise Bluetooth avec parent.

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

Construit une prise Bluetooth de type socketType, avec parent.

[virtual noexcept] QBluetoothSocket::~QBluetoothSocket()

Détruit la prise Bluetooth.

void QBluetoothSocket::abort()

Abandonne la connexion en cours et réinitialise la socket. Contrairement à disconnectFromService(), cette fonction ferme immédiatement la socket, en supprimant toutes les données en attente dans le tampon d'écriture.

Voir également disconnectFromService() et close().

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

Réimplémente : QIODevice::bytesAvailable() const.

Renvoie le nombre d'octets entrants en attente de lecture.

Voir aussi bytesToWrite() et read().

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

Réimplémente : QIODevice::bytesToWrite() const.

Renvoie le nombre d'octets en attente d'écriture. Les octets sont écrits lorsque le contrôle revient à la boucle d'événements.

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

Réimplémente : QIODevice::canReadLine() const.

Retourne vrai si vous pouvez lire au moins une ligne sur le périphérique

[override virtual] void QBluetoothSocket::close()

Réimplémente : QIODevice::close().

Déconnecte la connexion de la socket avec l'appareil.

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

Tente de se connecter au service décrit par service.

Le socket est ouvert dans l'adresse openMode. Le socketType() est ignoré si le service spécifie un QBluetoothServiceInfo::socketProtocol() différent.

La socket entre d'abord dans ConnectingState et tente de se connecter au périphérique fournissant service. Si une connexion est établie, QBluetoothSocket entre dans ConnectedState et émet connected().

À tout moment, la socket peut émettre errorOccurred() pour signaler qu'une erreur s'est produite.

Notez que la plupart des plateformes exigent un appairage avant de se connecter à l'appareil distant. Dans le cas contraire, le processus de connexion peut échouer.

Sur Android, seules les connexions RFCOMM sont possibles. Cette fonction ignore tout indicateur de protocole de socket et suppose qu'il s'agit de RFCOMM.

Voir aussi state() et disconnectFromService().

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

Tente d'établir une connexion avec le service identifié par uuid sur le périphérique dont l'adresse est address.

Le socket est ouvert dans l'adresse openMode.

Pour BlueZ, le socket entre d'abord dans ServiceLookupState et demande les paramètres de connexion pour uuid. Si les paramètres de service sont récupérés avec succès, le socket entre dans ConnectingState et tente de se connecter à address. Si une connexion est établie, QBluetoothSocket entre dans ConnectedState et émet connected().

Sur Android, la connexion au service peut être établie directement en utilisant l'UUID du service distant. Par conséquent, la plateforme n'a pas besoin de ServiceLookupState et socketType() est toujours défini sur QBluetoothServiceInfo::RfcommProtocol.

À tout moment, le socket peut émettre errorOccurred() pour signaler qu'une erreur s'est produite.

Notez que la plupart des plateformes exigent un appairage avant de se connecter à l'appareil distant. Dans le cas contraire, le processus de connexion peut échouer.

Voir également state() et disconnectFromService().

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

Tente d'établir une connexion avec address sur le site port.

La socket est ouverte dans l'adresse openMode.

La socket entre d'abord dans ConnectingState et tente de se connecter à address. Si une connexion est établie, QBluetoothSocket entre dans ConnectedState et émet connected().

À tout moment, le socket peut émettre errorOccurred() pour signaler qu'une erreur s'est produite.

Sur Android et BlueZ (version 5.46 ou supérieure), une connexion à un service ne peut pas être établie en utilisant un port. L'appel de cette fonction émettra un message ServiceNotFoundError.

Notez que la plupart des plateformes exigent un appairage avant de se connecter à l'appareil distant. Dans le cas contraire, le processus de connexion risque d'échouer.

Voir également state() et disconnectFromService().

[signal] void QBluetoothSocket::connected()

Ce signal est émis lorsqu'une connexion est établie.

Voir aussi QBluetoothSocket::SocketState::ConnectedState et stateChanged().

void QBluetoothSocket::disconnectFromService()

Tente de fermer le socket. S'il y a des données en attente d'écriture, QBluetoothSocket entrera dans ClosingState et attendra que toutes les données aient été écrites. Finalement, il entrera dans UnconnectedState et émettra le signal disconnected().

Voir aussi connectToService().

[signal] void QBluetoothSocket::disconnected()

Ce signal est émis lorsque la prise est déconnectée.

Voir aussi QBluetoothSocket::SocketState::UnconnectedState et stateChanged().

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

Lancez la recherche de périphériques pour service et ouvrez le socket avec openMode. Si le socket est créé avec une adresse de périphérique uuid de service, utilisez la recherche de services pour trouver le numéro de port auquel se connecter.

QBluetoothSocket::SocketError QBluetoothSocket::error() const

Renvoie la dernière erreur.

[signal, since 6.2] void QBluetoothSocket::errorOccurred(QBluetoothSocket::SocketError error)

Ce signal est émis lorsqu'un error se produit.

Cette fonction a été introduite dans Qt 6.2.

Voir aussi error().

QString QBluetoothSocket::errorString() const

Renvoie une chaîne de texte affichable par l'utilisateur pour l'erreur.

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

Réimplémente : QIODevice::isSequential() const.

QBluetoothAddress QBluetoothSocket::localAddress() const

Renvoie l'adresse du périphérique local.

Bien que certaines plates-formes puissent différer, le socket doit généralement être connecté pour garantir le retour d'une adresse valide. Ceci est particulièrement vrai lorsqu'il s'agit de plates-formes qui supportent plusieurs adaptateurs Bluetooth locaux.

QString QBluetoothSocket::localName() const

Renvoie le nom du périphérique local.

Bien que certaines plates-formes puissent différer, le socket doit généralement être connecté pour garantir le retour d'un nom valide. C'est notamment le cas lorsqu'il s'agit de plateformes qui prennent en charge plusieurs adaptateurs Bluetooth locaux.

quint16 QBluetoothSocket::localPort() const

Renvoie le numéro de port du socket local s'il est disponible, sinon renvoie 0. Bien que certaines plateformes puissent différer, le socket doit généralement être connecté pour garantir le retour d'un numéro de port valide.

Sur Android et macOS, cette fonctionnalité n'est pas supportée et renvoie 0.

QBluetoothAddress QBluetoothSocket::peerAddress() const

Renvoie l'adresse de l'appareil homologue.

QString QBluetoothSocket::peerName() const

Renvoie le nom de l'appareil homologue.

quint16 QBluetoothSocket::peerPort() const

Renvoie le numéro de port de la socket homologue s'il est disponible, sinon renvoie 0. Sur Android, cette fonctionnalité n'est pas supportée.

QBluetooth::SecurityFlags QBluetoothSocket::preferredSecurityFlags() const

Renvoie les paramètres de sécurité utilisés pour la première tentative de connexion.

Les paramètres de sécurité peuvent être renégociés entre les deux parties pendant ou après l'établissement de la connexion. Si un tel changement se produit, il n'est pas reflété dans la valeur de cet indicateur.

Sous macOS, cet indicateur a toujours la valeur QBluetooth::Security::Secure.

Voir également setPreferredSecurityFlags().

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

Réimplémente : QIODevice::readData(char *data, qint64 maxSize).

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

Définit le paramètre de sécurité préféré pour la tentative de connexion à flags. Cette valeur est incorporée lors de l'appel à connectToService(). Il est donc nécessaire de se reconnecter pour modifier ce paramètre pour une connexion existante.

Sur Bluez, cette propriété est définie par défaut sur QBluetooth::Security::Authorization.

Sur macOS, cette valeur est ignorée car la plateforme ne permet pas d'accéder au paramètre de sécurité de la socket. Par défaut, la plateforme préfère les connexions sécurisées/chiffrées et cette fonction renvoie donc toujours QBluetooth::Security::Secure.

Android ne supporte que deux niveaux de sécurité (sécurisé et non sécurisé). Si ce drapeau est défini sur QBluetooth::Security::NoSecurity, l'objet socket n'utilisera pas d'authentification ou de cryptage. Toute autre combinaison d'indicateur de sécurité déclenchera une connexion Bluetooth sécurisée. Cet indicateur est fixé à QBluetooth::Security::Secure par défaut.

Voir aussi preferredSecurityFlags().

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

Définit la socket pour utiliser socketDescriptor avec un type de socketType, qui est dans l'état socketState, et le mode openMode.

Le descripteur de socket appartient à l'instance QBluetoothSocket et peut être fermé une fois l'opération terminée.

Retourne true en cas de succès.

Voir aussi socketDescriptor().

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

Définit le type d'erreur qui s'est produit en dernier lieu à error_.

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

Définit l'état de la socket à state.

int QBluetoothSocket::socketDescriptor() const

Renvoie le descripteur de socket spécifique à la plate-forme, s'il est disponible. Cette fonction renvoie -1 si le descripteur n'est pas disponible ou si une erreur s'est produite.

Voir aussi setSocketDescriptor().

QBluetoothServiceInfo::Protocol QBluetoothSocket::socketType() const

Renvoie le type de socket. La socket s'adapte automatiquement au protocole proposé par le service distant.

Android ne prend en charge que les sockets basées sur RFCOMM.

QBluetoothSocket::SocketState QBluetoothSocket::state() const

Renvoie l'état actuel de la socket.

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

Ce signal est émis lorsque l'état de la socket passe à state.

Voir aussi connected(), disconnected(), state(), et QBluetoothSocket::SocketState.

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

Réimplémente : QIODevice::writeData(const char *data, qint64 maxSize).