En esta página

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.