En esta página

Qt NFC

La API NFC proporciona conectividad entre dispositivos compatibles con NFC.

Actualmente, la API es compatible con Android, iOS y Linux mediante Neard v0.14 o posterior. Este módulo también proporciona acceso limitado a lectores compatibles con la especificación PC/SC en Linux, macOS y Windows.

NFC es una tecnología inalámbrica de corto alcance (menos de 20 centímetros) con una velocidad máxima de transferencia de 424 Kbps. NFC es ideal para transferir pequeños paquetes de datos cuando se acercan dos dispositivos.

El módulo NFC proporciona API para interactuar con etiquetas y dispositivos del NFC Forum. Puede detectar objetivos y pérdidas, registrar controladores de mensajes NDEF, leer y escribir mensajes NDEF en etiquetas del NFC Forum, y enviar comandos específicos para cada etiqueta.

Uso del módulo

Para utilizar la API de C++ de un módulo Qt es necesario vincularla con la biblioteca del módulo, ya sea directamente o a través de otras dependencias. Varias herramientas de compilación ofrecen soporte específico para ello, entre ellas CMake y qmake.

Compilación con CMake

Utiliza el comando « find_package() » para localizar el componente del módulo necesario en el paquete « Qt6 »:

find_package(Qt6 REQUIRED COMPONENTS Nfc)
target_link_libraries(mytarget PRIVATE Qt6::Nfc)

Para obtener más detalles, consulta la descripción general de «Compilación con CMake ».

Compilación con qmake

Para configurar el módulo para la compilación con qmake, añade el módulo como valor de la variable QT en el archivo .pro del proyecto:

QT += nfc

Artículos y guías

Categorías de registro

El módulo « QtNfc » exporta las siguientes categorías de registro ( logging categories):

Categoría de registroDescripción
Qt NFC.neardHabilita el registro de la implementación de Neard/Linux

Ejemplos

Referencia

Consideraciones de seguridad

El contenido de una etiqueta NFC no puede considerarse una entrada fiable. Es responsabilidad del desarrollador de la aplicación validar los datos antes de utilizarlos.

URI

Funciones como QNdefNfcUriRecord::uri() y QNdefNfcSmartPosterRecord::uri() devuelven URI decodificados directamente a partir del contenido de la etiqueta. Las aplicaciones pueden, por ejemplo, verificar que el esquema sea el que la aplicación espera recibir (por ejemplo, https en lugar de file o javascript) antes de abrir, cargar o actuar sobre un URI devuelto.

Datos de iconos

Funciones como QNdefNfcIconRecord::data() y QNdefNfcSmartPosterRecord::icon() devuelven matrices de bytes sin procesar que contienen datos de iconos incrustados en la etiqueta. Dado que tanto el tipo MIME como el contenido los proporciona el autor de la etiqueta, es posible que los bytes reales no se ajusten al tipo declarado.

Las aplicaciones deben verificar el resultado tras la decodificación, en lugar de dar por sentado que los datos son válidos. A modo de ejemplo, pasar los datos directamente a QImage suele ser seguro, ya que este se encarga de la validación. Sin embargo, se recomienda realizar una validación adicional al procesar los datos manualmente o al utilizar herramientas ajenas a Qt.

Evolución del módulo

En «Cambios en Qt NFC » se enumeran los cambios importantes en la API y la funcionalidad del módulo que se han introducido para la serie Qt 6 de Qt.

Licencias

Qt NFC está disponible bajo licencias comerciales de The Qt Company. Además, está disponible bajo licencias de software libre. Desde Qt 5.4, estas licencias de software libre son la Licencia Pública General Reducida de GNU, versión 3, o la Licencia Pública General de GNU, versión 2. Consulte Licencias de Qt para obtener más detalles.

© 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.