En esta página

QNearFieldManager Class

La clase `QNearFieldManager` permite acceder a las notificaciones de eventos NFC. Más información...

Encabezado: #include <QNearFieldManager>
CMake: find_package(Qt6 REQUIRED COMPONENTS Nfc)
target_link_libraries(mytarget PRIVATE Qt6::Nfc)
qmake: QT += nfc
Heredado de: QObject

Tipos públicos

enum class AdapterState { Offline, TurningOn, Online, TurningOff }

Funciones públicas

QNearFieldManager(QObject *parent = nullptr)
virtual ~QNearFieldManager()
(since 6.2) bool isEnabled() const
bool isSupported(QNearFieldTarget::AccessMethod accessMethod = QNearFieldTarget::AnyAccess) const
(since 6.2) void setUserInformation(const QString &message)
bool startTargetDetection(QNearFieldTarget::AccessMethod accessMethod)
void stopTargetDetection(const QString &errorMessage = QString())

Señales

void adapterStateChanged(QNearFieldManager::AdapterState state)
void targetDetected(QNearFieldTarget *target)
(since 6.2) void targetDetectionStopped()
void targetLost(QNearFieldTarget *target)

Descripción detallada

Los dispositivos del NFC Forum admiten dos modos de comunicación. El primer modo, la comunicación entre pares, se utiliza para la comunicación entre dos dispositivos del NFC Forum. El segundo modo, la comunicación maestro/esclavo, se utiliza para la comunicación entre un dispositivo del NFC Forum y una etiqueta del NFC Forum o una tarjeta sin contacto. La señal « targetDetected » () se emite cuando un dispositivo de destino entra en el alcance de comunicación. Las comunicaciones pueden iniciarse desde la ranura conectada a esta señal.

Los dispositivos del NFC Forum suelen funcionar como «maestro» en las comunicaciones «maestro/esclavo». Algunos dispositivos también pueden funcionar como «esclavo», en el denominado modo de emulación de tarjeta. En este modo, el dispositivo NFC local emula una etiqueta del NFC Forum o una tarjeta sin contacto.

Las aplicaciones pueden conectarse a las señales « targetDetected » () y « targetLost » () para recibir una notificación cuando una etiqueta del NFC Forum entre o salga del ámbito de proximidad. Antes de que se emitan estas señales, debe iniciarse la detección del objetivo con la función « startTargetDetection » (). La detección de objetivos se puede detener con la función stopTargetDetection(). Cuando ya no se necesite el objetivo, este debe eliminarse, ya que de lo contrario se podría impedir el acceso de otras aplicaciones al mismo.

NFC en Linux

El proyecto NFC para Linux proporciona software para dar soporte a NFC en plataformas Linux. El demonio «neard» permitirá el acceso al hardware compatible a través de interfaces DBus. QtNfc requiere la versión 0.14 de «neard», que puede compilarse a partir del código fuente o instalarse mediante el gestor de paquetes de Linux adecuado. Actualmente no se admiten todas las funciones de la API. Para que QtNfc pueda acceder a las interfaces DBus, el demonio «neard» debe estar en ejecución. En caso de problemas, se puede activar la salida de depuración habilitando el registro categorizado para «qt.nfc.neard».

Documentación sobre tipos de miembros

enum class QNearFieldManager::AdapterState

Esta enumeración describe los diferentes estados que puede tener un adaptador NFC.

ConstanteValorDescripción
QNearFieldManager::AdapterState::Offline1El adaptador NFC está desconectado.
QNearFieldManager::AdapterState::TurningOn2El adaptador NFC se está encendiendo.
QNearFieldManager::AdapterState::Online3El adaptador NFC está conectado.
QNearFieldManager::AdapterState::TurningOff4El adaptador NFC se está apagando.

Documentación de las funciones de miembro

[explicit] QNearFieldManager::QNearFieldManager(QObject *parent = nullptr)

Crea un nuevo gestor de campo cercano con ` parent`.

[virtual noexcept] QNearFieldManager::~QNearFieldManager()

Destruye al gestor del campo cercano.

[signal] void QNearFieldManager::adapterStateChanged(QNearFieldManager::AdapterState state)

Esta señal se emite cada vez que cambia el state del adaptador NFC.

Nota: Actualmente , esta señal solo se emite en Android.

[since 6.2] bool QNearFieldManager::isEnabled() const

Devuelve ` true ` si el dispositivo dispone de un adaptador NFC y está activado; en caso contrario, devuelve ` false`.

Esta función se introdujo en Qt 6.2.

Véase también isSupported().

bool QNearFieldManager::isSupported(QNearFieldTarget::AccessMethod accessMethod = QNearFieldTarget::AnyAccess) const

Devuelve « true » si el dispositivo subyacente dispone de un adaptador NFC; en caso contrario, devuelve « false ». Si se proporciona un « accessMethod », la función devuelve « true » solo si el adaptador NFC es compatible con el « accessMethod » indicado.

Véase también isEnabled().

[since 6.2] void QNearFieldManager::setUserInformation(const QString &message)

Establece el mensaje que el sistema muestra al usuario. Si la detección de destino está en marcha, el ` message ` se actualizará inmediatamente y podrá utilizarse como mensaje de progreso. El último mensaje establecido antes de una llamada a ` startTargetDetection()` sin un mensaje de error se utiliza como mensaje de éxito. Si la detección de objetivos no se está ejecutando, se utilizará ` message ` como mensaje inicial cuando se inicie la siguiente detección. Por defecto, no se muestra ningún mensaje al usuario.

Nota: Actualmente , esta función solo tiene efecto en iOS, ya que el sistema muestra una ventana emergente durante el escaneo. En iOS, este ` message ` se asigna al mensaje de alerta que se muestra al completarse con éxito el escaneo. Otras plataformas ignorarán ` message`.

Esta función se introdujo en Qt 6.2.

Véase también startTargetDetection() y stopTargetDetection().

bool QNearFieldManager::startTargetDetection(QNearFieldTarget::AccessMethod accessMethod)

Comienza a detectar objetivos y devuelve ` true ` si la detección de objetivos se ha iniciado correctamente; en caso contrario, devuelve ` false`. Provoca que se emita la señal ` targetDetected()` cuando un objetivo se encuentra en las proximidades. Solo se notificarán las etiquetas con el ` accessMethod ` especificado. La detección de objetivos continúa hasta que se llama a ` stopTargetDetection()`.

Para detectar objetivos con un accessMethod diferente, primero debe llamarse a stopTargetDetection().

Nota: En iOS, no es posible iniciar la detección de objetivos tanto para NdefAccess como para TagTypeSpecificAccess al mismo tiempo. Por lo tanto, si se selecciona AnyAccess, se utilizará NdefAccess en su lugar.

Nota: En plataformas que utilizan neard, la detección de objetivos se detendrá tan pronto como se haya detectado una etiqueta.

Véase también stopTargetDetection().

void QNearFieldManager::stopTargetDetection(const QString &errorMessage = QString())

Deja de detectar objetivos. La señal « targetDetected()» dejará de emitirse hasta que se realice otra llamada a « startTargetDetection()». Los objetivos detectados anteriormente siguen siendo válidos.

Nota: En iOS, los objetivos detectados dejan de ser válidos tras esta llamada (por ejemplo, cualquier intento de escribir o leer mensajes NDEF dará lugar a un error).

Si se proporciona un ` errorMessage `, se indica al sistema que no se ha alcanzado el objetivo de la aplicación. Se muestran al usuario el mensaje « errorMessage » y un icono de error correspondiente. Llamar a esta función con un ` errorMessage ` vacío implica que la operación ha finalizado con éxito; de lo contrario, se debe pasar un ` errorMessage ` a esta función.

Nota: Actualmente , errorMessage solo tiene efecto en iOS, ya que el sistema muestra una ventana emergente durante el análisis en la que se ve errorMessage. Otras plataformas ignorarán este parámetro.

Véase también setUserInformation().

[signal] void QNearFieldManager::targetDetected(QNearFieldTarget *target)

Esta señal se emite cada vez que se detecta un objetivo. El parámetro ` target ` representa el objetivo detectado.

Esta señal se emitirá para todos los objetivos detectados.

QNearFieldManager target conserva la propiedad de ; sin embargo, no se destruirá hasta que se llame al destructor de . La propiedad puede transferirse llamando a (). QNearFieldManager setParent

No elimines ` target ` desde la ranura conectada a esta señal; en su lugar, llama a ` deleteLater()`.

Nota: si se elimina target antes deque salga de la proximidad, no se emitirá la señal targetLost().

Véase también targetLost().

[signal, since 6.2] void QNearFieldManager::targetDetectionStopped()

Esta señal se emite cada vez que se detiene la detección de objetivos.

Nota: En la mayoría de los casos, esta señal se emite cuando se ha llamado a stopTargetDetection(). Además, el usuario puede detener la detección en iOS desde una ventana emergente que muestra el sistema durante el escaneo, lo que también provoca la emisión de esta señal.

Esta función se introdujo en Qt 6.2.

[signal] void QNearFieldManager::targetLost(QNearFieldTarget *target)

Esta señal se emite cada vez que un objetivo se aleja del área de proximidad. El parámetro « target » representa el objetivo perdido.

No elimines « target » de la ranura conectada a esta señal; en su lugar, utiliza « deleteLater()».

Véase también QNearFieldTarget::disconnected().

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