Modifications apportées à Qt NFC

Qt 6 résultent d'un effort délibéré visant à rendre le framework plus efficace et plus facile à utiliser.

Nous nous efforçons de maintenir la compatibilité binaire et source pour toutes les API publiques à chaque version. Cependant, certaines modifications étaient inévitables afin d’améliorer le framework Qt.

Dans cette rubrique, nous résumons ces modifications dans Qt NFC et fournissons des conseils pour les gérer.

Nouvelles fonctionnalités et méthodes

Ajout QNdefRecord::clear()

Utilisez cette méthode pour effacer un enregistrement NDEF.

Ajout QNdefFilter::match()

Utilisez cette méthode pour vérifier si un enregistrement NDEF ( QNdefMessage ) correspond au filtre spécifié. La méthode renvoie « true » en cas de correspondance et « false » dans le cas contraire.

Extension QNearFieldTarget::Type

L'énumération a été étendue avec deux types supplémentaires :

• QNearFieldTarget::NfcTagType4A
• QNearFieldTarget::NfcTagType4B

Modifications apportées aux fonctionnalités et aux méthodes

Renommage de QNearFieldManager::isAvailable()

La méthode QNearFieldManager::isAvailable() a été renommée QNearFieldManager::isEnabled().

Ajout d’un argument à la méthode d’accès QNearFieldManager::isSupported

L’argument de la méthode accessMethod permet de vérifier si une fonctionnalité spécifique est prise en charge. Ceci est important car les différentes plateformes ou versions de systèmes d’exploitation peuvent prendre en charge des options différentes.

Ajout d’un argument de méthode d’accès à QNearFieldManager::startTargetDetection

L'argument « accessMethod » permet de rechercher des balises NFC à l'aide de la méthode d'accès indiquée.

Modification de l'argument « QNdefNfcSmartPosterRecord::typeInfo » de « QByteArray » à QString

Conformément à la spécification NDEF Smart Poster, le type est une chaîne au format UTF-8. Cela affecte les méthodes ` QNdefNfcSmartPosterRecord::typeInfo()` et ` QNdefNfcSmartPosterRecord::setTypeInfo()`.

Mise à jour du type de retour de QNdefFilter::appendRecord

QNdefFilter::appendRecord effectue désormais une validation de base des paramètres d'entrée et renvoie une valeur booléenne indiquant si l'enregistrement est ajouté au filtre ou non.

Fonctionnalités et méthodes supprimées

Suppression de QNearFieldTarget::url

Cette méthode n’a jamais été implémentée dans les sous-classes existantes de QNearFieldTarget.

Suppression de QNearFieldTarget::sendCommands

Dans Qt 5, cette méthode n'était pas très utile car elle ne permettait pas de suivre les résultats des commandes intermédiaires. Normalement, une commande supplémentaire ne doit être envoyée que lorsque la commande précédente a été exécutée avec succès.

L'approche correcte consiste à créer manuellement une file d'attente de commandes, à utiliser QNearFieldTarget::sendCommand pour envoyer une commande et QNearFieldTarget::requestCompleted ou QNearFieldTarget::error pour traiter individuellement les résultats de chaque commande.

Suppression de QNearFieldTarget::keepConnection

Les méthodes QNearFieldTarget::keepConnection() et QNearFieldTarget::setKeepConnection() ont été supprimées. Le maintien de la connexion est désormais le comportement par défaut.

Suppression de QNearFieldTarget::isProcessingCommand

Cette méthode n’a jamais été implémentée et renvoyait toujours false.

La méthode QNearFieldTarget::setResponseForRequest est désormais une API privée

Cette méthode ne doit pas être exposée en tant qu’API publique. Utilisez ` QNearFieldTarget::ndefMessageRead ` ou ` QNearFieldTarget::requestResponse ` pour lire les données d’une balise NFC.

Suppression de QNearFieldTarget::handleResponse

Cette méthode a été supprimée car elle ne faisait que rediriger l'appel vers ` QNearFieldManager::setResponseForRequest`, qui est désormais une API privée.

La méthode QNearFieldTarget::reportError est désormais une API privée

Un signal QNearFieldTarget::error peut être utilisé à la place.

Suppression du signal QNearFieldTarget::ndefMessagesWritten

Le signal QNearFieldTarget::requestCompleted est utilisé à la fois pour les messages NDEF et les commandes personnalisées. Le paramètre id permet de vérifier quelle requête a effectivement été traitée.

Suppression de la méthode QNearFieldManager::(un)registerNdefMessageHandler

Les méthodes ` QNearFieldTarget::registerNdefMessageHandler ` et ` QNearFieldTarget::unregisterNdefMessageHandler ` ont été supprimées.

Utilisez QNearFieldTarget::ndefMessageRead() et QNdefFilter::match() pour détecter les messages NDEF et filtrer ceux qui sont requis.

Suppression de QNearFieldManager::TargetAccessModes

L'énumération TargetAccessModes a été supprimée, ainsi que les méthodes getter et setter (QNearFieldManager::setTargetAccessModes() et QNearFieldManager::targetAccessModes()).

Cette fonctionnalité n’est pas prise en charge sur les plateformes Android et iOS.

Suppression de QNearFieldShareManager et QNearFieldShareTarget

Le partage de fichiers via NFC est obsolète sur Android à partir de l'API 29. Il convient d'utiliser d'autres technologies à la place.

Suppression de l'API QML

La prise en charge de l’API QML est interrompue.