DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Communication / Fonctions NFC
  • Fonctionnement
  • Lecture du NFC envoyé
  • Permissions requises
  • Application en arrière-plan : Spécificité à partir de Android 10
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Avertissement
A partir de la version 2024, cette fonctionnalité n'est plus disponible
Envoie un tag NFC à un autre appareil.
Remarque : Les fonctions NFC ne peuvent pas être utilisées dans le simulateur ou dans l'émulateur.
Exemple
// Envoie une URL à un autre appareil
tag est un nfcTag
url est une nfcDonnée
url.Type = nfcURI
url.Contenu = "www.pcsoft.com"
Ajoute(tag.Donnée, url)
SI NFCEnvoieTag(tag) = Faux ALORS
Erreur("Echec de l'écriture sur le tag NFC.", ErreurInfo())
FIN
Syntaxe
<Résultat> = NFCEnvoieTag(<Tag>)
<Résultat> : Booléen
  • Vrai si l'envoi a été effectué,
  • Faux dans le cas contraire. 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 à envoyer.
Remarques

Fonctionnement

  • L'envoi de tags NFC utilise la fonctionnalité Android Beam de l'appareil. Cette fonctionnalité doit être activée sur l'appareil émetteur et sur l'appareil récepteur.
    L'activation d'Android Beam se fait dans la fenêtre de paramétrage des communications sans fil de l'appareil.
  • L'appel de la fonction NFCEnvoieTag déclenche automatiquement l'ouverture d'une fenêtre invitant l'utilisateur à approcher son appareil d'un autre appareil compatible NFC. Cette fenêtre sera automatiquement fermée :
    • à la fin de l'envoi,
    • si l'utilisateur annule l'envoi 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 NFCEnvoieTag.
  • Sur l'appareil destination, le tag envoyé pourra être lu comme un tag NFC classique :
    • par une application développée avec WINDEV Mobile en utilisant la fonction NFCLitTag,
    • par une application tierce compatible.

Lecture du NFC envoyé

Pour qu'un appareil puisse lire le tag NFC envoyé par la fonction NFCEnvoieTag, il doit supporter :
  • soit le protocole NDEF Push Protocol (com.android.npp),
  • soit le protocole SNEP (Simple NDEF Exchange Protocol).
S'il est en version supérieure ou égale à 4.0, il doit supporter les deux protocoles.

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

Application en arrière-plan : Spécificité à partir de Android 10

A partir de Android 10, il n'est plus possible d'ouvrir une fenêtre lorsque l'application est en arrière-plan.
La fonction NFCEnvoieTag peut provoquer l'ouverture d'une fenêtre. Si cette fonction est utilisée alors que l'application est en arrière-plan, une erreur fatale sera générée.
Conseils :
  • Il est possible de savoir si l'application est en arrière-plan grâce à la fonction EnModeArrièrePlan.
  • Si une application a besoin d'interagir avec l'utilisateur alors qu'elle se trouve en arrière-plan, la solution consiste à afficher une notification (via le type Notification). Lors du clic sur la notification, l'application sera remise au premier plan si la propriété ActiveApplication est à Vrai. Il est également possible d'ouvrir une fenêtre depuis la procédure passée à la propriété ActionClic.
Composante : wd290android.jar
Version minimum requise
  • Version 18
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 23/02/2024

Signaler une erreur ou faire une suggestion | Aide en ligne locale