|
|
|
|
- Fonctionnement
- Permissions requises
- Application en arrière-plan : Spécificité à partir de Android 10
NFCEcritTag (Fonction) En anglais : NFCWriteTag Déclenche l'écriture de données sur un tag (ou puce) NFC. Remarque : Les fonctions NFC ne peuvent pas être utilisées dans le simulateur ou dans l'émulateur.
// Ecrit une url dans un tag NFC (mode bloquant) tag est un nfcTag url est une nfcDonnée url.Type = nfcURI url.Contenu = "http://www.pcsoft.com" Ajoute(tag.Donnée, url) NFCEcritTag(tag) SI ErreurDétectée ALORS Erreur("Echec de l'écriture sur le tag NFC.", ErreurInfo()) FIN // Ecrit une url dans un tag NFC (mode non bloquant) tag est un nfcTag url est une nfcDonnée url.Type = nfcURI url.Contenu = "http://www.pcsoft.com" Ajoute(tag.Donnée, url) SI PAS NFCEcritTag(tag, EcritureTagNFC) ALORS Erreur("Echec lors de l'écriture NFC.", ErreurInfo()) FIN PROCÉDURE INTERNE EcritureTagNFC(nRésultatNFC est un entier) SI nRésultatNFC <> nfcOK ALORS Trace("Un problème est survenu") FIN FIN Syntaxe <Résultat> : Entier - 1 si l'écriture a réussi,
- une des constantes suivantes dans le cas contraire :
| | nfcErrDésactivé | Le NFC n'est pas activé sur l'appareil. | nfcErrDétection | Le tag NFC est sorti du champ de détection pendant le processus d'écriture. | nfcErrEmulateur | Appel de la fonction depuis l'émulateur. | nfcErrFormat | Le format des données à écrire est invalide. | nfcErrInconnue | Erreur inconnue. | nfcErrLectureSeule | Le tag NFC est en protégé en écriture. | nfcErrNDEF | Le tag NFC ne peut pas être formaté au format NDEF (NFC Data Exchange Format). | nfcErrProtection | Le tag NFC ne peut pas être protégé en écriture (mode non supporté par le tag). | nfcErrTailleMax | La taille des données à écrire est supérieure à la taille maximale des données pouvant être stockées sur le tag NFC. |
En cas d'erreur, la variable ErreurDétectée est à Vrai. Pour plus de détails sur l'erreur, utilisez la fonction ErreurInfo.
<Tag> : Variable de type nfcTag Nom de la variable de type nfcTag décrivant les données à écrire.
Ecrire un tag en mode non bloquant Masquer les détails
<Résultat> = NFCEcritTag(<Tag> , <Procédure WLangage>)
<Résultat> : Booléen - Vrai si l'écriture a été lancée,
- Faux dans le cas contraire.
<Tag> : Variable de type nfcTag Nom de la variable de type nfcTag décrivant les données à écrire. <Procédure WLangage> : Nom de procédure Nom de la procédure WLangage (également nommée "callback") appelée lors de l'écriture du tag. Cette procédure permet de savoir si l'écriture du tag a été réalisée ou bien si elle a échoué. Cette procédure est de la forme :
PROCEDURE <Nom de la procédure>(<Résultat>) où <Résultat> correspond au résultat de l'écriture : - 1 si l'écriture du tag a réussi,
- une des constantes suivantes dans le cas contraire :
| | nfcErrAnnulation | L'action a été annulée par l'utilisateur. | nfcErrDésactivé | Le NFC n'est pas activé sur l'appareil. | nfcErrDétection | Le tag NFC est sorti du champ de détection pendant le processus d'écriture. | nfcErrEmulateur | Appel de la fonction depuis l'émulateur. | nfcErrFormat | Le format des données à écrire est invalide. | nfcErrInconnue | Erreur inconnue. | nfcErrIndisponible | Le capteur NFC n'existe pas ou est indisponible. | nfcErrLectureSeule | Le tag NFC est en protégé en écriture. | nfcErrNDEF | Le tag NFC ne peut pas être formaté au format NDEF (NFC Data Exchange Format). | nfcErrProtection | Le tag NFC ne peut pas être protégé en écriture (mode non supporté par le tag). | nfcErrTailleMax | La taille des données à écrire est supérieure à la taille maximale des données pouvant être stockées sur le tag NFC. | nfcOK | L'opération a été effectuée. |
Remarques Fonctionnement L'appel de la fonction NFCEcritTag déclenche automatiquement l'ouverture d'une fenêtre invitant l'utilisateur à approcher son appareil du tag NFC dans lequel il souhaite écrire. Cette fenêtre sera automatiquement fermée : - à la fin de l'opération d'écriture,
- si l'utilisateur annule l'opération en appuyant sur la touche Back de l'appareil.
Remarque : Pour personnaliser le message affiché dans cette fenêtre, utilisez la fonction TitreSuivant avant l'appel à la fonction NFCEcritTag. Une vibration de l'appareil est déclenchée lorsque l'appareil détecte le tag NFC. Il est important de conserver l'appareil à proximité du tag NFC durant toute la durée d'affichage de la fenêtre de capture sous peine d'interrompre le processus d'écriture. Permissions requises L'utilisation de cette fonction entraîne la modification des permissions requises par l'application. Permissions requises : - NFC : Permet aux applications d'effectuer des opérations d'entrée/sortie par la technologie NFC.
- VIBRATE : Permet d'accéder à la fonction vibreur.
Liste des exemples associés :
|
Exemples multiplateforme (WINDEV Mobile) : WM Système
[ + ] Cette application est un exemple didactique montrant quelques unes des fonctionnalités de WINDEV Mobile pour Android/iOS. Les fonctions système utilisées sont : - NFC - Champ Multimédia - Luminosité - Volume - WIFI - Bluetooth - Toast - Boussole - Accéléromètre - Champ caméra - LED - Vibrations - Notifications - Fonctions de dessin - Internet
|
Classification Métier / UI : Code métier Composante : wd290android.aar
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|