Κοινή χρήση μέσω


Συνάρτηση ReadNFC

Ισχύει σε: Εφαρμογές καμβά

Διαβάζει μια ετικέτα Near Field Communication (NFC).

Description

Χρησιμοποιήστε τη συνάρτηση ReadNFC για να διαβάσετε μια ετικέτα NFC κοντά στη συσκευή σας. Όταν καλείται, η οθόνη εμφανίζει οδηγίες για τη σάρωση μιας ετικέτας NFC και επιστρέφει μόνο αφού η ετικέτα έχει σαρωθεί ή λήξει το χρονικό όριο.

Στήλη Τύπος Περιγραφή
Αναγνωριστικό Μήνυμα κειμένου Το αναγνωριστικό ετικετών NFC, εάν είναι διαθέσιμο.
NDEFRecords Table Οι υποστηριζόμενες καρτέλες NDEF που βρίσκονται στην ετικέτα.

Μία μόνο NDEFRecord περιέχει τις ακόλουθες στήλες:

Στήλη Τύπος Περιγραφή
RTD Μήνυμα κειμένου Τον ορισμό τύπου καρτέλας της ετικέτας (RTD). Μόνο τα Κείμενο και URI υποστηρίζονται αυτήν τη στιγμή.
TNF Αριθμός Τη μορφή ονόματος τύπου της ετικέτας (TNF). Μόνο τα TNF Well Known(1) υποστηρίζονται αυτήν τη στιγμή.
Μήνυμα κειμένου Μήνυμα κειμένου Το ωφέλιμο φορτίο κειμένου της ετικέτας NFC, εάν το RTD είναι ΚΕΙΜΕΝΟ, διαφορετικά κενό.
URI Υπερ-σύνδεση Το ωφέλιμο φορτίο URI της ετικέτας NFC, εάν το RTD είναι URI, διαφορετικά κενό.

Εάν η καρτέλα NDEF δεν υποστηρίζεται (για παράδειγμα, το TNF δεν είναι Γνωστό), τότε δεν θα επιστρέφεται ως μέρος του πίνακα NDEFRecords.

Να ελέγχετε πάντα τις τιμές του ωφέλιμου φορτίου για κενή τιμή χρησιμοποιώντας τη συνάρτηση IsBlank πριν τη χρησιμοποιήσετε. Δεν χρειάζεται να ελέγξετε οι ίδιοι τις τιμές RTD και TNF καθώς πρέπει να είναι οι σωστές τιμές για τα Κείμενο και URI για να έχουν μη κενή τιμή.

Πρόσθετες τιμές RTD και TNF ενδέχεται να υποστηρίζονται στο μέλλον. Εάν υποστηρίζονται περισσότερες τιμές, θα προστεθούν επίσης πρόσθετες στήλες ωφέλιμου φορτίου. Οι μη επεξεργασμένες τιμές RTD και TNF παρέχονται για ενημερωτικούς σκοπούς και δεν χρειάζεται να ερωτηθείτε εάν η στήλη ωφέλιμου φορτίου ελέγχεται για κενό. Περισσότερες πληροφορίες σχετικά με αυτές τις τιμές και τη χρήση τους είναι διαθέσιμες μέσω του φόρουμ NFC.

Το ReadNFC δεν απαιτεί τη χρήση ετικέτας που περιέχει καρτέλες NDEF, αλλά ενδέχεται να εξακολουθείτε να λαμβάνετε το αναγνωριστικό ετικέτας, εάν υπάρχει διαθέσιμο.

Η συνάρτηση ReadNFC μπορεί να χρησιμοποιηθεί αποκλειστικά σε τύπους συμπεριφοράς.

Σημείωμα

  • Το ReadNFC υποστηρίζεται μόνο κατά την εκτέλεση της εφαρμογής σε πρόγραμμα αναπαραγωγής κινητής συσκευής, όπως iOS και Android. Ακόμα και με έναν υποστηριζόμενο παίκτη, μια συσκευή μπορεί να μην υποστηρίζει NFC. Εάν η εφαρμογή σας έχει ενεργοποιημένη τη Διαχείριση σφάλματος σε επίπεδο τύπου, η λειτουργία θα επιστρέψει ένα σφάλμα. Αν εμφανιστεί ένα μήνυμα σφάλματος στο χρήστη και η συνάρτηση θα επιστρέψει μια κενή καρτέλα.
  • Βεβαιωθείτε ότι για τη χρήση αυτής της δυνατότητας στη συσκευή σας έχει ενεργοποιηθεί η ρύθμιση NFC.

Σύνταξη

ReadNFC()

Παραδείγματα

Τύπος Περιγραφή Αποτέλεσμα
ReadNFC().Identifier Επιστρέφει το αναγνωριστικό της ετικέτας NFC εάν υπάρχει. 04A1C301314003
ReadNFC().NDEFRecords Επιστρέφει έναν πίνακα καρτελών NDEF που βρίσκονται στην ετικέτα NFC αν είναι υποστηριζόμενος τύπος και ωφέλιμο φορτίο. Το αποτέλεσμα των NDEFRecords με ένα παράδειγμα καρτέλας.

Αναλυτικό παράδειγμα

  1. Δημιουργήστε μια κενή εφαρμογή καμβά με μορφή τηλεφώνου.

  2. Προσθήκη ένός στοιχείου ελέγχου Button.

  3. Κάντε διπλό κλικ στο στοιχείο ελέγχου κουμπιού για να αλλάξετε το κείμενο κουμπιού σε Ανάγνωση ετικέτας NFC (ή για να τροποποιήσετε την ιδιότητα Κείμενο).

  4. Ορίστε την ιδιότητα OnSelect του στοιχείου ελέγχου Button σε αυτόν τον τύπο, ο οποίος θα προσθέσει ένα στοιχείο στη συλλογή μας:

    With(ReadNFC(),
        Set(id, Coalesce(Identifier, "No ID"));
        ForAll(NDEFRecords, Collect(tagRecords, {ID: id, Value: Coalesce(Text, URI)})))
    

    Παραπάνω τύπος που καταχωρείται ως η ιδιότητα OnSelect του κουμπιού.

    Αυτός ο τύπος διαβάζει μια ετικέτα NFC με χρήση της συνάρτησης ReadNFC() και εμφανίζει πληροφορίες τύπου σχετικά με το αποτέλεσμα. Στη συνέχεια, συλλέγει τις ετικέτες ανάγνωσης NFC ώστε να συμπληρωθεί η tagRecords συλλογή που θα χρησιμοποιηθεί για τη συλλογή στα επόμενα βήματα.

  5. Εισαγάγετε ένα Στοιχείο ελέγχου Συλλογή με κατακόρυφη διάταξη.

  6. Όταν σας ζητηθεί, επιλέξτε τη συλλογή tagRecords ως προέλευση δεδομένων για αυτήν τη συλλογή. Με αυτόν τον τρόπο θα οριστεί η ιδιότητα Items του στοιχείου ελέγχου Gallery.

    Προέλευση δεδομένων για συλλογή που έχει επιλεγεί ως tagRecords.

  7. Αλλάξτε τη θέση του στοιχείου ελέγχου συλλογής ώστε να μην επικαλύπτεται το κουμπί και αλλάξτε τον τύπο διάταξης σε Τίτλος και υπότιτλος.

    Διάταξη της συλλογής.

  8. Αλλάξτε τον τύπο Τίτλος στο στοιχείο ελέγχου συλλογής σε ThisItem.Value και αλλάξτε τον τύπο Υπότιτλος στο στοιχείο ελέγχου συλλογής σε ThisItem.ID.

    Μπορείτε, επίσης, να διαγράψετε το NextArrow από το στοιχείο ελέγχου συλλογής καθώς δεν χρησιμοποιείται.

  9. Αποθήκευση και δημοσίευση της εφαρμογής.

  10. Εφόσον η συνάρτηση ReadNFC() δεν μπορεί να χρησιμοποιηθεί στο Power Apps Studio ή σε πρόγραμμα περιήγησης στο Web, ανοίξτε την εφαρμογή σας σε μια κινητή συσκευή.

    Φιλοδώρημα

    Ενδέχεται να χρειαστούν μερικά λεπτά για την εμφάνιση της εφαρμογής στην κινητή συσκευή σας. Αν δεν βλέπετε την εφαρμογή στη λίστα, δοκιμάστε να ανανεώσετε τη λίστα εφαρμογών σας.

  11. Επιλέξτε Ανάγνωση ετικέτας NFC και σαρώστε μια ετικέτα. Επαναλάβετε τη διαδικασία για να προσθέσετε πολλές ετικέτες στη συλλογή σας.

    Εφαρμογή σε κινητή συσκευή με το παράδειγμα ανάγνωσης ετικέτας NFC και το αποτέλεσμα μέσα στη συλλογή.