QBluetoothServer Class

Documentation des fonctions membres

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

Construit un serveur bluetooth avec parent et serverType.

[virtual noexcept] QBluetoothServer::~QBluetoothServer()

Détruit le serveur Bluetooth.

void QBluetoothServer::close()

Ferme et réinitialise le socket d'écoute. Tout QBluetoothSocket déjà établi continue de fonctionner et doit être séparément closed.

QBluetoothServer::Error QBluetoothServer::error() const

Renvoie la dernière erreur du site QBluetoothServer.

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

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

Cette fonction a été introduite dans Qt 6.2.

Voir aussi error() et QBluetoothServer::Error.

bool QBluetoothServer::hasPendingConnections() const

Retourne true si une connexion est en attente, sinon false.

bool QBluetoothServer::isListening() const

Retourne true si le serveur est à l'écoute des connexions entrantes, sinon false.

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

Commencez à écouter les connexions entrantes vers address sur port. address doit être une adresse d'adaptateur Bluetooth local et port doit être supérieur à zéro et ne pas être déjà pris par un autre objet serveur Bluetooth. Il est recommandé d'éviter de définir un numéro de port pour permettre au système de choisir automatiquement un port.

Renvoie true si l'opération a réussi et que le serveur est à l'écoute des connexions entrantes, sinon renvoie false.

Si l'objet serveur est déjà à l'écoute de connexions entrantes, cette fonction renvoie toujours false. close() doit être appelé avant d'appeler cette fonction.

Voir également isListening() et newConnection().

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

Fonction de commodité pour l'enregistrement d'un service SPP avec uuid et serviceName. Comme cette fonction enregistre déjà le service, l'objet QBluetoothServiceInfo renvoyé ne peut plus être modifié. Pour arrêter le serveur ultérieurement, il est nécessaire d'appeler QBluetoothServiceInfo::unregisterService() et close() sur cet objet serveur.

Renvoie une instance QBluetoothServiceInfo enregistrée en cas de succès, sinon une instance QBluetoothServiceInfo invalide. Cette fonction suppose toujours que l'adaptateur Bluetooth par défaut doit être utilisé.

Si l'objet serveur est déjà à l'écoute de connexions entrantes, cette fonction renvoie un QBluetoothServiceInfo invalide.

Pour un serveur RFCOMM, cette fonction est équivalente à l'extrait de code suivant.

    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();

Voir également isListening(), newConnection() et listen().

int QBluetoothServer::maxPendingConnections() const

Renvoie le nombre maximum de connexions en attente.

Voir aussi setMaxPendingConnections().

[signal] void QBluetoothServer::newConnection()

Ce signal est émis lorsqu'une nouvelle connexion est disponible.

Le slot connecté doit appeler nextPendingConnection() pour obtenir un objet QBluetoothSocket afin d'envoyer et de recevoir des données via la connexion.

Voir aussi nextPendingConnection() et hasPendingConnections().

QBluetoothSocket *QBluetoothServer::nextPendingConnection()

Renvoie un pointeur vers QBluetoothSocket pour la prochaine connexion en attente. Il est de la responsabilité de l'appelant de supprimer le pointeur.

QBluetooth::SecurityFlags QBluetoothServer::securityFlags() const

Renvoie les drapeaux de sécurité Bluetooth.

Voir également setSecurityFlags().

QBluetoothAddress QBluetoothServer::serverAddress() const

Renvoie l'adresse du serveur.

quint16 QBluetoothServer::serverPort() const

Renvoie le numéro de port du serveur.

QBluetoothServiceInfo::Protocol QBluetoothServer::serverType() const

Renvoie le type de l'adresse QBluetoothServer.

void QBluetoothServer::setMaxPendingConnections(int numConnections)

Fixe le nombre maximal de connexions en attente à numConnections. Si le nombre de connexions en attente dépasse cette limite, les nouvelles connexions seront rejetées.

Voir aussi maxPendingConnections().

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

Définit les drapeaux de sécurité Bluetooth sur security. Cette fonction doit être appelée avant d'appeler listen(). La liaison Bluetooth sera toujours cryptée lors de l'utilisation d'appareils Bluetooth 2.1, car le cryptage est obligatoire.

Android ne prend en charge que deux niveaux de sécurité (sécurisé et non sécurisé). Si cet indicateur est défini sur QBluetooth::Security::NoSecurity, l'objet serveur n'utilisera pas d'authentification ou de cryptage. Toute autre combinaison de drapeaux de sécurité déclenchera une connexion Bluetooth sécurisée.

Sous macOS, les indicateurs de sécurité ne sont pas pris en charge et seront ignorés.

Voir aussi securityFlags().