En esta página

QNearFieldTarget Class

La clase `QNearFieldTarget` proporciona una interfaz para comunicarse con un dispositivo de destino. Más información...

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

Tipos públicos

class RequestId
enum AccessMethod { UnknownAccess, NdefAccess, TagTypeSpecificAccess, AnyAccess }
flags AccessMethods
enum Error { NoError, UnknownError, UnsupportedError, TargetOutOfRangeError, NoResponseError, …, UnsupportedTargetError }
enum Type { ProprietaryTag, NfcTagType1, NfcTagType2, NfcTagType3, NfcTagType4, …, MifareTag }

Funciones públicas

QNearFieldTarget(QObject *parent = nullptr)
virtual ~QNearFieldTarget()
QNearFieldTarget::AccessMethods accessMethods() const
bool disconnect()
bool hasNdefMessage()
int maxCommandLength() const
QNearFieldTarget::RequestId readNdefMessages()
QVariant requestResponse(const QNearFieldTarget::RequestId &id) const
QNearFieldTarget::RequestId sendCommand(const QByteArray &command)
QNearFieldTarget::Type type() const
QByteArray uid() const
bool waitForRequestCompleted(const QNearFieldTarget::RequestId &id, int msecs = 5000)
QNearFieldTarget::RequestId writeNdefMessages(const QList<QNdefMessage> &messages)

Señales

void disconnected()
void error(QNearFieldTarget::Error error, const QNearFieldTarget::RequestId &id)
void ndefMessageRead(const QNdefMessage &message)
void requestCompleted(const QNearFieldTarget::RequestId &id)

Descripción detallada

QNearFieldTarget proporciona una interfaz genérica para comunicarse con un dispositivo de destino NFC. Esta clase es compatible tanto con dispositivos del NFC Forum como con etiquetas del NFC Forum. Todas las clases específicas de destino son subclases de esta clase.

La función ` type()` se puede utilizar para obtener el tipo del dispositivo de destino. La función ` uid()` devuelve el identificador único del dispositivo de destino. Los indicadores ` AccessMethods ` que devuelve la función ` accessMethods()` se pueden comprobar para determinar qué métodos de acceso son compatibles con el dispositivo de destino.

Si el dispositivo de destino admite « NdefAccess », se puede llamar a « hasNdefMessage()» para comprobar si el dispositivo tiene un mensaje NDEF almacenado; las funciones « readNdefMessages()» y « writeNdefMessages()» se pueden utilizar para obtener y establecer el mensaje NDEF.

Si el dispositivo es compatible con TagTypeSpecificAccess, se puede utilizar sendCommand() para enviar un único comando propio al dispositivo y recuperar la respuesta.

Documentación sobre los tipos de miembro

enum QNearFieldTarget::AccessMethod
flags QNearFieldTarget::AccessMethods

Esta enumeración describe los métodos de acceso que admite un objetivo de campo cercano.

ConstanteValorDescripción
QNearFieldTarget::UnknownAccess0x00El objetivo admite un tipo de acceso desconocido.
QNearFieldTarget::NdefAccess0x01El objetivo admite la lectura y escritura de mensajes NDEF mediante readNdefMessages() y writeNdefMessages().
QNearFieldTarget::TagTypeSpecificAccess0x02El objetivo admite el envío de comandos específicos del tipo de etiqueta mediante sendCommand().
QNearFieldTarget::AnyAccess0xffEl destino admite cualquiera de los tipos de acceso conocidos.

El tipo `AccessMethods` es un `typedef` para ` QFlags<AccessMethod>`. Almacena una combinación OR de valores de `AccessMethod`.

enum QNearFieldTarget::Error

Esta enumeración describe los códigos de error que notifica un objetivo de campo cercano.

ConstanteValorDescripción
QNearFieldTarget::NoError0No se ha producido ningún error.
QNearFieldTarget::UnknownError1Se ha producido un error no identificado.
QNearFieldTarget::UnsupportedError2Esta operación solicitada no es compatible con este objetivo de campo cercano.
QNearFieldTarget::TargetOutOfRangeError3El objetivo ya no se encuentra dentro del alcance.
QNearFieldTarget::NoResponseError4El objetivo no ha respondido.
QNearFieldTarget::ChecksumMismatchError5La suma de comprobación ha detectado una respuesta dañada.
QNearFieldTarget::InvalidParametersError6Se han pasado parámetros no válidos a una función específica del tipo de etiqueta.
QNearFieldTarget::ConnectionError7No se ha podido conectar con el objetivo.
QNearFieldTarget::NdefReadError8No se han podido leer los mensajes NDEF del objetivo.
QNearFieldTarget::NdefWriteError9No se han podido escribir mensajes NDEF en el destino.
QNearFieldTarget::CommandError10No se ha podido enviar un comando al destino.
QNearFieldTarget::TimeoutError11No se ha podido completar la solicitud en el tiempo especificado en ` waitForRequestCompleted()`.
QNearFieldTarget::UnsupportedTargetError12El destino utilizado no es compatible. Por ejemplo, esto puede ocurrir si faltan los permisos necesarios y/o la configuración de privacidad en la aplicación cliente.

enum QNearFieldTarget::Type

Esta enumeración describe el tipo de etiqueta que se ha detectado en el objetivo.

ConstanteValorDescripción
QNearFieldTarget::ProprietaryTag0Una etiqueta de destino propietaria no identificada.
QNearFieldTarget::NfcTagType11Un objetivo de etiqueta NFC de tipo 1.
QNearFieldTarget::NfcTagType22Un objetivo de etiqueta NFC de tipo 2.
QNearFieldTarget::NfcTagType33Un objetivo de etiqueta NFC de tipo 3.
QNearFieldTarget::NfcTagType44Una etiqueta NFC de tipo 4. Este valor se utiliza si el NfcTagType4 no puede especificarse con mayor detalle mediante los valores NfcTagType4A o NfcTagType4B que figuran a continuación.
QNearFieldTarget::NfcTagType4A5Un objetivo de etiqueta NFC de tipo 4 basado en la norma ISO/IEC 14443-3A.
QNearFieldTarget::NfcTagType4B6Un objetivo de etiqueta NFC de tipo 4 basado en la norma ISO/IEC 14443-3B.
QNearFieldTarget::MifareTag7Un objetivo Mifare.

Documentación de las funciones de miembro

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

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

[virtual noexcept] QNearFieldTarget::~QNearFieldTarget()

Destruye el objetivo cercano.

QNearFieldTarget::AccessMethods QNearFieldTarget::accessMethods() const

Devuelve los métodos de acceso compatibles con este objetivo de campo cercano.

bool QNearFieldTarget::disconnect()

Cierra la conexión con el dispositivo de destino para permitir la comunicación con este desde otra instancia. La conexión también se cerrará cuando se destruya el objeto « QNearFieldTarget ». Se (re)crea una conexión con el dispositivo de destino para procesar un comando o leer/escribir mensajes NDEF.

Devuelve ` true ` solo si se ha cerrado correctamente una conexión existente; en caso contrario, devuelve ` false`.

[signal] void QNearFieldTarget::disconnected()

Esta señal se emite cuando el objetivo del campo cercano se aleja.

[signal] void QNearFieldTarget::error(QNearFieldTarget::Error error, const QNearFieldTarget::RequestId &id)

Esta señal se emite cuando se produce un error al procesar la solicitud id. El parámetro error describe el error.

bool QNearFieldTarget::hasNdefMessage()

Devuelve ` true ` si hay al menos un mensaje NDEF almacenado en el dispositivo de campo cercano; en caso contrario, devuelve ` false`.

int QNearFieldTarget::maxCommandLength() const

Devuelve el número máximo de bytes que se pueden enviar con ` sendCommand`. Se devolverá 0 si el destino no admite el envío de comandos específicos del tipo de etiqueta.

Véase también ` sendCommand()`.

[signal] void QNearFieldTarget::ndefMessageRead(const QNdefMessage &message)

Esta señal se emite cuando se ha leído un archivo NDEF completo message del dispositivo de destino.

Véase también ` readNdefMessages()`.

QNearFieldTarget::RequestId QNearFieldTarget::readNdefMessages()

Inicia la lectura de los mensajes NDEF almacenados en el objetivo de campo cercano. Devuelve un identificador de solicitud que puede utilizarse para realizar un seguimiento del estado de finalización de la solicitud. Se devolverá un identificador de solicitud no válido si el objetivo no admite la lectura de mensajes NDEF.

Se emitirá la señal « ndefMessageRead()» por cada mensaje NDEF. La señal « requestCompleted()» se emitirá cuando se hayan leído todos los mensajes NDEF. La señal « error()» se emite si se produce un error.

Nota: El intento de leer un mensaje NDEF de una etiqueta que se encuentre en estado INITIALIZED, tal y como lo define el NFC Forum, fallará con la señal « NdefReadError », ya que la etiqueta está formateada para admitir NDEF pero aún no contiene ningún mensaje.

[signal] void QNearFieldTarget::requestCompleted(const QNearFieldTarget::RequestId &id)

Esta señal se emite cuando se completa una solicitud id.

Véase también sendCommand().

QVariant QNearFieldTarget::requestResponse(const QNearFieldTarget::RequestId &id) const

Devuelve la respuesta descodificada correspondiente a la solicitud id. Si la solicitud es desconocida o aún no se ha completado, se devuelve un QVariant no válido.

QNearFieldTarget::RequestId QNearFieldTarget::sendCommand(const QByteArray &command)

Envía « command » al objetivo de campo cercano. Devuelve un identificador de solicitud que puede utilizarse para realizar un seguimiento del estado de finalización de la solicitud. Se devolverá un identificador de solicitud no válido si el objetivo no admite el envío de comandos específicos para ese tipo de etiqueta.

Se emitirá la señal « requestCompleted()» cuando la solicitud se complete con éxito; en caso contrario, se emitirá la señal « error()».

Una vez que la solicitud se haya completado con éxito, la respuesta se podrá obtener mediante la función ` requestResponse()`. La respuesta a esta solicitud será un ` QByteArray`.

Véanse también requestCompleted() y waitForRequestCompleted().

QNearFieldTarget::Type QNearFieldTarget::type() const

Devuelve el tipo de etiqueta de este objetivo de campo cercano.

QByteArray QNearFieldTarget::uid() const

Devuelve el UID del objetivo de campo cercano.

Nota: En iOS, esta función devuelve un objeto ` QByteArray ` vacío para un objetivo de campo cercano detectado mediante el método ` NdefAccess `.

Véase también QNearFieldTarget::AccessMethod.

bool QNearFieldTarget::waitForRequestCompleted(const QNearFieldTarget::RequestId &id, int msecs = 5000)

Espera hasta msecs milisegundos a que finalice la solicitud id. Devuelve true si la solicitud se completa con éxito y se emite la señal requestCompeted(); en caso contrario, devuelve false.

QNearFieldTarget::RequestId QNearFieldTarget::writeNdefMessages(const QList<QNdefMessage> &messages)

Escribe los mensajes NDEF de messages en el destino. Devuelve un identificador de solicitud que puede utilizarse para realizar un seguimiento del estado de finalización de la solicitud. Se devolverá un identificador de solicitud no válido si el destino no admite la escritura de mensajes NDEF.

Se emitirá la señal « requestCompleted()» cuando la operación de escritura se complete con éxito; de lo contrario, se emitirá la señal « error()».

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