Cambios en Qt NFC
Qt 6 son el resultado de un esfuerzo deliberado por hacer que el marco sea más eficiente y fácil de usar.
Intentamos mantener la compatibilidad binaria y de código fuente para todas las API públicas en cada versión. Sin embargo, algunos cambios eran inevitables con el fin de mejorar Qt como marco de trabajo.
En este tema resumimos esos cambios en Qt NFC y ofrecemos orientación para gestionarlos.
Nuevas características y métodos
Añadido QNdefRecord::clear()
Utiliza este método para borrar un registro NDEF.
Añadido QNdefFilter::match()
Utilice este método para comprobar si un objeto ` QNdefMessage ` coincide con el filtro indicado. El método devuelve ` true ` en caso de coincidencia y ` false ` en caso contrario.
Ampliado QNearFieldTarget::Type
Se ha ampliado la enumeración con dos tipos más:
Cambios en las características y métodos
Se ha cambiado el nombre de QNearFieldManager::isAvailable()
El método QNearFieldManager::isAvailable() ha pasado a denominarse QNearFieldManager::isEnabled().
Se ha añadido un argumento al método de acceso QNearFieldManager::isSupported
El argumento de ` accessMethod ` permite comprobar si se admite una función específica. Esto es relevante porque las diferentes plataformas o versiones de los sistemas operativos pueden admitir distintas opciones.
Se ha añadido el argumento de método de acceso a QNearFieldManager::startTargetDetection
El argumento « accessMethod » permite buscar etiquetas NFC con el método de acceso indicado.
Se ha cambiado « QNdefNfcSmartPosterRecord::typeInfo » de « QByteArray » a QString
Según la especificación NDEF Smart Poster, el tipo es una cadena con formato UTF-8. Esto afecta a los métodos QNdefNfcSmartPosterRecord::typeInfo() y QNdefNfcSmartPosterRecord::setTypeInfo().
Se ha actualizado el tipo de retorno de QNdefFilter::appendRecord
QNdefFilter::appendRecord ahora realiza una validación básica de los parámetros de entrada y devuelve un valor booleano que indica si el registro se añade al filtro o no.
Características y métodos eliminados
Se ha eliminado QNearFieldTarget::url
Este método nunca se implementó en las subclases existentes de QNearFieldTarget.
Se ha eliminado QNearFieldTarget::sendCommands
En Qt 5, el método no resultaba muy útil, ya que no ofrecía una forma de realizar un seguimiento de los resultados de los comandos intermedios. Normalmente, solo es necesario enviar un comando adicional cuando el comando anterior se ha ejecutado correctamente.
El enfoque correcto sería crear manualmente una cola de comandos, utilizar QNearFieldTarget::sendCommand para enviar un comando y QNearFieldTarget::requestCompleted o QNearFieldTarget::error para gestionar los resultados de cada comando de forma individual.
Se ha eliminado QNearFieldTarget::keepConnection
Se han eliminado los métodos QNearFieldTarget::keepConnection() y QNearFieldTarget::setKeepConnection(). Mantener la conexión es el comportamiento predeterminado por el momento.
Se ha eliminado QNearFieldTarget::isProcessingCommand
Este método nunca se implementó y siempre devolvía « false ».
Se ha convertido QNearFieldTarget::setResponseForRequest en una API privada
Este método no debe exponerse como API pública. Utiliza QNearFieldTarget::ndefMessageRead o QNearFieldTarget::requestResponse para leer los datos de una etiqueta NFC.
Se ha eliminado QNearFieldTarget::handleResponse
Se ha eliminado el método, ya que simplemente reenviaba la llamada a QNearFieldManager::setResponseForRequest, que ahora es una API privada.
Se ha convertido QNearFieldTarget::reportError en una API privada
En su lugar, se puede utilizar una señal de QNearFieldTarget::error.
Se ha eliminado la señal `QNearFieldTarget::ndefMessagesWritten`
La señal ` QNearFieldTarget::requestCompleted ` se utiliza tanto para mensajes NDEF como para comandos personalizados. Se puede utilizar el parámetro ` id ` para comprobar qué solicitud se ha completado realmente.
Se ha eliminado QNearFieldManager::(un)registerNdefMessageHandler
Se han eliminado los métodos QNearFieldTarget::registerNdefMessageHandler y QNearFieldTarget::unregisterNdefMessageHandler.
Utiliza QNearFieldTarget::ndefMessageRead() y QNdefFilter::match() para detectar los mensajes NDEF y filtrar los que sean necesarios.
Nota: La aplicación aún puede iniciarse automáticamente al tocar la etiqueta NDEF. El ejemplo «URL anotada » muestra cómo hacerlo en Android.
Se ha eliminado QNearFieldManager::TargetAccessModes
Se ha eliminado la enumeración TargetAccessModes junto con los métodos getter y setter (QNearFieldManager::setTargetAccessModes() y QNearFieldManager::targetAccessModes()).
Esta función no es compatible con las plataformas Android e iOS.
Se han eliminado QNearFieldShareManager y QNearFieldShareTarget
El intercambio de archivos mediante NFC ha quedado obsoleto en Android a partir de la API 29. En su lugar, deben utilizarse otras tecnologías.
Se ha eliminado la API de QML
Se ha dejado de ofrecer soporte para la API de QML.
© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.