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.
| Constante | Valor | Descripción |
|---|---|---|
QNearFieldTarget::UnknownAccess | 0x00 | El objetivo admite un tipo de acceso desconocido. |
QNearFieldTarget::NdefAccess | 0x01 | El objetivo admite la lectura y escritura de mensajes NDEF mediante readNdefMessages() y writeNdefMessages(). |
QNearFieldTarget::TagTypeSpecificAccess | 0x02 | El objetivo admite el envío de comandos específicos del tipo de etiqueta mediante sendCommand(). |
QNearFieldTarget::AnyAccess | 0xff | El 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.
| Constante | Valor | Descripción |
|---|---|---|
QNearFieldTarget::NoError | 0 | No se ha producido ningún error. |
QNearFieldTarget::UnknownError | 1 | Se ha producido un error no identificado. |
QNearFieldTarget::UnsupportedError | 2 | Esta operación solicitada no es compatible con este objetivo de campo cercano. |
QNearFieldTarget::TargetOutOfRangeError | 3 | El objetivo ya no se encuentra dentro del alcance. |
QNearFieldTarget::NoResponseError | 4 | El objetivo no ha respondido. |
QNearFieldTarget::ChecksumMismatchError | 5 | La suma de comprobación ha detectado una respuesta dañada. |
QNearFieldTarget::InvalidParametersError | 6 | Se han pasado parámetros no válidos a una función específica del tipo de etiqueta. |
QNearFieldTarget::ConnectionError | 7 | No se ha podido conectar con el objetivo. |
QNearFieldTarget::NdefReadError | 8 | No se han podido leer los mensajes NDEF del objetivo. |
QNearFieldTarget::NdefWriteError | 9 | No se han podido escribir mensajes NDEF en el destino. |
QNearFieldTarget::CommandError | 10 | No se ha podido enviar un comando al destino. |
QNearFieldTarget::TimeoutError | 11 | No se ha podido completar la solicitud en el tiempo especificado en ` waitForRequestCompleted()`. |
QNearFieldTarget::UnsupportedTargetError | 12 | El 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.
| Constante | Valor | Descripción |
|---|---|---|
QNearFieldTarget::ProprietaryTag | 0 | Una etiqueta de destino propietaria no identificada. |
QNearFieldTarget::NfcTagType1 | 1 | Un objetivo de etiqueta NFC de tipo 1. |
QNearFieldTarget::NfcTagType2 | 2 | Un objetivo de etiqueta NFC de tipo 2. |
QNearFieldTarget::NfcTagType3 | 3 | Un objetivo de etiqueta NFC de tipo 3. |
QNearFieldTarget::NfcTagType4 | 4 | Una 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::NfcTagType4A | 5 | Un objetivo de etiqueta NFC de tipo 4 basado en la norma ISO/IEC 14443-3A. |
QNearFieldTarget::NfcTagType4B | 6 | Un objetivo de etiqueta NFC de tipo 4 basado en la norma ISO/IEC 14443-3B. |
QNearFieldTarget::MifareTag | 7 | Un 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.