AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Comunicación / Funciones NFC
  • Modo de funcionamiento
  • Permisos necesarios
  • Aplicación en segundo plano: Caso específico a partir de Android 10
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Inicia la escritura de datos en una etiqueta NFC.
Observación: Las funciones NFC no se pueden utilizar en el simulador ni en el emulador.
Ejemplo
// Write URL to NFC tag (blocking mode)
tag is nfcTag
url is nfcData
url.Type = nfcURI
url.Content = "http://www.pcsoft.com"
Add(tag.Data, url)
NFCWriteTag(tag)
IF ErrorOccurred THEN
Error("Unable to write NFC tag.", ErrorInfo())
END
// Write URL to NFC tag (non-blocking mode)
tag is nfcTag
url is nfcData
url.Type = nfcURI
url.Content = "http://www.pcsoft.com"
Add(tag.Data, url)
IF NOT NFCWriteTag(tag, WriteNFCTag) THEN
Error("Unable to write NFC tag.", ErrorInfo())
END
INTERNAL PROCEDURE WriteNFCTag(nNFCResult is int)
IF nNFCResult <> nfcOK THEN
Trace("A problem occurred")
END
END
Sintaxis

Escribir una etiqueta en modo de bloqueo Ocultar los detalles

<Result> = NFCWriteTag(<Tag>)
<Result>: Integro
  • 1 si la escritura fue exitosa,
  • en caso contrario, una de las siguientes constantes:
    nfcErrDetectionLa etiqueta NFC ha salido del control de detección durante la escritura de Process.
    nfcErrDisabledNFC no está activado en el dispositivo.
    nfcErrEmulatorFunción llamada desde el emulador.
    nfcErrFormatEl formato de los datos a escribir no es válido.
    nfcErrMaxSizeEl tamaño de los datos a escribir excede el tamaño máximo de los datos que pueden almacenarse en la etiqueta NFC.
    nfcErrNDEFLa etiqueta NFC no puede formatearse con el formato NDEF (NFC Data Exchange Format).
    nfcErrProtectionEl tag NFC no puede ser protected en modo escritura (modo no soportado por el tag).
    nfcErrReadOnlyLa etiqueta NFC es protected en modo de escritura.
    nfcErrUnknownError desconocido.

    Si se produce un error, la variable ErrorOccurred se establece en True. Para obtener más información sobre el error, utilice la función ErrorInfo.
<Tag>: nfcTag Variable
Nombre de la nfcTag Variable que describe los datos a escribir.

Escribir una etiqueta en modo no bloqueante Ocultar los detalles

<Result> = NFCWriteTag(<Tag> , <WLanguage procedure>)
<Result>: booleano
  • True si se inició la escritura,
  • False en caso contrario.
<Tag>: nfcTag Variable
Nombre de la nfcTag Variable que describe los datos a escribir.
<WLanguage procedure>: Nombre de Procedure
Nombre del WLanguage Procedure ("callback") llamado al escribir datos en la etiqueta. Esta Procedure se utiliza para determinar si los datos se pueden escribir en la etiqueta o no. Este procedimiento tiene el siguiente formato:
PROCEDURE <Procedure name>(<Result>)
donde es el resultado de la operación de escritura:
  • 1 si los datos se han escrito con éxito en la etiqueta,
  • en caso contrario, una de las siguientes constantes:
    nfcErrCancellationLa acción fue cancelada por el usuario.
    nfcErrDetectionLa etiqueta NFC ha salido del control de detección durante la escritura de Process.
    nfcErrDisabledNFC no está activado en el dispositivo.
    nfcErrEmulatorFunción llamada desde el emulador.
    nfcErrFormatEl formato de los datos a escribir no es válido.
    nfcErrMaxSizeEl tamaño de los datos a escribir excede el tamaño máximo de los datos que pueden almacenarse en la etiqueta NFC.
    nfcErrNDEFLa etiqueta NFC no puede formatearse con el formato NDEF (NFC Data Exchange Format).
    nfcErrProtectionEl tag NFC no puede ser protected en modo escritura (modo no soportado por el tag).
    nfcErrReadOnlyLa etiqueta NFC es protected en modo de escritura.
    nfcErrUnavailableEl sensor NFC no existe o no está disponible.
    nfcErrUnknownError desconocido.
    nfcOKLa operación se ha completado.
Observaciones

Modo de funcionamiento

La llamada a NFCWriteTag abre automáticamente una ventana para solicitar a los usuarios que mantengan sus dispositivos más cerca de la etiqueta NFC en la que desean escribir.
Esta ventana se cerrará automáticamente:
  • al final de la operación de escritura,
  • si el usuario cancela la operación pulsando la tecla Atrás del dispositivo.
Observación: Para personalizar el mensaje que se muestra en la ventana, utilice la función NextTitle antes de llamar a la función NFCWriteTag.
Una vibración se activa cuando el dispositivo detecta la etiqueta NFC. El dispositivo debe estar ubicado cerca de la etiqueta NFC durante toda la visualización de la ventana de captura, de lo contrario se interrumpirá la escritura Process.

Permisos necesarios

La llamada a esta función modifica los permisos requeridos por la aplicación.
Permisos necesarios:
  • NFC: Permite a las aplicaciones realizar operaciones de entrada/salida a través de la tecnología NFC.
  • VIBRATOS: Se utiliza para acceder a la función del sensor.
Android

Aplicación en segundo plano: Caso específico a partir de Android 10

A partir de Android 10, no se puede abrir una ventana si la aplicación está en segundo plano.
La función NFCWriteTag puede abrir una ventana. Si se utiliza esta función cuando la aplicación está en segundo plano, se producirá un error fatal.
Consejos:
  • Para saber si la aplicación está en segundo plano, utilice la función InBackgroundMode.
  • Si una aplicación necesita interactuar con el usuario cuando está en segundo plano, se puede mostrar una notificación (con el tipo Notification). La aplicación volverá al primer plano cuando se haga clic en la notificación, si la propiedad ActivateApplication se establece en True. También es posible abrir una ventana desde el procedimiento pasado a la propiedad ActionClick.
Para obtener más información, consulte Android 10: Comportamiento de aplicaciones en segundo plano.
Clasificación Lógica de negocio / UI: Lógica de negocio
Componente: wd290android.aar
Versión mínima requerida
  • Versión 18
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 23/06/2023

Señalar un error o enviar una sugerencia | Ayuda local