Qt NFC Descripción general
Con la API « Qt NFC », los casos de uso habituales son:
- Detectar etiquetas NFC.
- Lectura y escritura de mensajes NDEF.
- Registro de controladores de mensajes NDEF.
- Compartir archivos y mensajes.
En las siguientes secciones se describe cómo utilizar las clases de C++ y los tipos QML de Qt NFC para los casos de uso mencionados anteriormente.
Nota: En Android, la detección de nuevas etiquetas NFC solo funciona en aplicaciones en primer plano. Los servicios de Android no admiten esta función debido a limitaciones de la API por parte de Android. La única forma de utilizar una etiqueta en un servicio es proporcionar una interfaz AIDL que acepte la etiqueta y la reenvíe a Qt, tal y como se muestra en el siguiente ejemplo.
public void setTag(Tag pTag) {
Intent newIntent = new Intent();
newIntent.putExtra(NfcAdapter.EXTRA_TAG, pTag);
QtNative.onNewIntent(newIntent);
}Descripción general de C++
La API de C++ proporciona acceso al conjunto completo de funciones de la API de Qt NFC. En esta sección se presentan las principales funciones disponibles para los desarrolladores.
Detección de etiquetas NFC
La clase ` QNearFieldManager ` se encarga de detectar nuevas etiquetas NFC que entran en el alcance del dispositivo. Las señales ` QNearFieldManager::targetDetected()` y ` QNearFieldManager::targetLost()` se emiten cuando una etiqueta entra o sale del alcance. El parámetro ` QNearFieldTarget ` pasado actúa como punto de interacción principal para cada etiqueta detectada. Sin embargo, la detección no comienza realmente hasta que se haya llamado a ` QNearFieldManager::startTargetDetection()`.
m_manager = new QNearFieldManager(this);
connect(m_manager, &QNearFieldManager::targetDetected,
this, &MainWindow::targetDetected);
connect(m_manager, &QNearFieldManager::targetLost,
this, &MainWindow::targetLost);
m_manager->startTargetDetection(QNearFieldTarget::NdefAccess);Por último, la detección se puede detener:
m_manager->stopTargetDetection();Aunque cada instancia de ` QNearFieldTarget ` pertenece a su instancia relacionada de ` QNearFieldManager `, puede resultar conveniente eliminar manualmente cada instancia. De lo contrario, seguirían existiendo hasta que se eliminara la instancia de ` QNearFieldManager `. La mejor forma de hacerlo sería en respuesta a la señal ` QNearFieldManager::targetLost()`:
void MainWindow::targetLost(QNearFieldTarget *target)
{
target->deleteLater();
}Nota: El objeto de destino solo debe eliminarse mediante deleteLater() si se elimina dentro de la ranura.
Conexión de etiquetas NFC
Todas las funciones de QNearFieldTarget que requieran una conexión la crearán por sí mismas. Una conexión activa impedirá que otras instancias establezcan una conexión, ya que solo se permite una conexión a la vez.
En Qt 5, la etiqueta se desconectaba al final de las funciones para permitir que otras instancias se conectaran. QNearFieldManager::setKeepConnection() permitía modificar este comportamiento.
Desde Qt 6, QNearFieldTarget mantiene la conexión de forma predeterminada. La conexión solo se cierra cuando se destruye el objeto ` QNearFieldTarget ` o se llama a ` QNearFieldManager::disconnect()`.
Lectura y escritura de mensajes NDEF
La instancia de ` QNearFieldTarget ` devuelta por la señal ` QNearFieldManager::targetDetected()` se utiliza para interactuar con la etiqueta. La lectura y la escritura de un mensaje son operaciones asíncronas. La clase ` QNearFieldTarget::RequestId ` asocia las operaciones individuales con sus resultados.
void MainWindow::targetDetected(QNearFieldTarget *target)
{
switch (m_touchAction) {
case NoAction:
break;
case ReadNdef:
connect(target, &QNearFieldTarget::ndefMessageRead, this, &MainWindow::ndefMessageRead);
connect(target, &QNearFieldTarget::error, this, &MainWindow::targetError);
m_request = target->readNdefMessages();
if (!m_request.isValid()) // cannot read messages
targetError(QNearFieldTarget::NdefReadError, m_request);
break;
case WriteNdef:
connect(target, &QNearFieldTarget::requestCompleted, this, &MainWindow::ndefMessageWritten);
connect(target, &QNearFieldTarget::error, this, &MainWindow::targetError);
m_request = target->writeNdefMessages(QList<QNdefMessage>() << ndefMessage());
if (!m_request.isValid()) // cannot write messages
targetError(QNearFieldTarget::NdefWriteError, m_request);
break;
}
}Una vez que la solicitud QNearFieldTarget::readNdefMessages() se ha procesado correctamente, se emite la señal QNearFieldTarget::ndefMessageRead(). Cada QNdefMessage devuelta puede constar de cero o más entradas QNdefRecord, que pueden identificarse por su tipo. Para obtener más información sobre el procesamiento de registros, consulta la documentación de la clase QNdefRecord. Tal y como muestra el código anterior, la escritura de mensajes NDEF se activa mediante QNearFieldTarget::writeNdefMessages(). La finalización con éxito de la operación de escritura se indica mediante la emisión de la señal QNearFieldTarget::requestCompleted() con el identificador de solicitud correspondiente. Cualquier tipo de error durante la lectura o la escritura se indica mediante QNearFieldTarget::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.