Funcția ReadNFC

Se aplică pentru: aplicații Canvas

Citește o etichetă Near Field Communication (NFC).

Descriere

Utilizați funcția ReadNFC pentru a citi o etichetă NFC care este aproape de dispozitivul dvs. Când este invocat, ecranul afișează instrucțiuni pentru scanarea unei etichete NFC și revine numai după ce eticheta a fost scanată sau când expiră.

Coloană	Tip	Descriere
Identifier	SMS	Identificatorul etichetelor NFC, dacă este disponibil.
NDEFRecords	Table	Înregistrările NDEF acceptate găsite pe etichetă.

Un singur NDEFRecord conține următoarele coloane:

Coloană	Tip	Descriere
RTD	SMS	Record Type Definition (RTD) pentru etichetă. Numai Text și URI sunt acceptate în acest moment.
TNF	Număr	Type Name Format (TNF) al etichetei. În acest moment, sunt acceptate numai TNF-urile Well Known(1).
SMS	SMS	În caz contrar, sarcina utilă text a etichetei NFC dacă RTD este TEXT, necompletat.
URI	Hyperlink	În caz contrar, sarcina utilă URI a etichetei NFC dacă RTD este URI, necompletat.

Dacă înregistrarea NDEF nu este acceptată (de exemplu, TNF nu este de tip Well Known), atunci nu va fi returnată ca parte a tabelului NDEFRecords.

Verificați întotdeauna valorile sarcinii utile pentru necompletat folosind funcția IsBlank înainte de a o utiliza. Nu trebuie să verificați valorile RTD și TNF, deoarece acestea trebuie să fie valorile corecte pentru Text și URI a avea o valoare non-necompletat.

Valori adiționale RTD și TNF pot fi acceptate în viitor. Dacă sunt acceptate mai multe valori, vor fi adăugate și coloane de sarcină utilă suplimentare. Valorile brute RTD și TNF sunt furnizate în scop informativ și nu trebuie consultate dacă coloana de sarcină utilă este verificată pentru necompletat. Mai multe informații despre aceste valori și utilizarea lor sunt disponibile prin Forumul NFC.

ReadNFC nu necesită utilizarea unei etichete care să conțină înregistrări NDEF, dar este posibil să obțineți în continuare identificatorul etichetei, dacă este disponibil unul.

ReadNFC poate fi utilizat numai în formule comportamentale.

Notă

• ReadNFC este acceptat numai atunci când rulează aplicația pe o aplicație mobilă nativă, cum ar fi aplicațiile iOS și Android . Chiar și cu un player acceptat, este posibil ca un dispozitiv să nu accepte NFC. Dacă aplicația dvs. are Gestionarea erorilor la nivel de formulă activată, funcția va returna o eroare. Un mesaj de eroare va fi afișat utilizatorului și funcția va returna o înregistrare necompletată.
• Asigurați-vă că dispozitivul are setarea NFC activată pentru a utiliza această capacitate.

Sintaxă

ReadNFC()

Exemple

Formula	Descriere	Rezultat
ReadNFC().Identifier	Returnează identificatorul etichetei NFC, dacă există una.	04A1C301314003
ReadNFC().NDEFRecords	Returnează un tabel cu înregistrările NDEF găsite pe eticheta NFC dacă acestea sunt de tip și sarcină utilă acceptate.

Exemplu pas cu pas

1. Creați o aplicație proiectată pe planșă necompletată cu formatul Telefon.

2. Adăugați un control Buton.

3. Faceți dublu clic pe controlul buton pentru a schimba textul butonului la Citiți eticheta NFC (sau modificați proprietatea Text).

4. Setați proprietatea OnSelect controlului buton de la această formulă care va adăuga un element la colecția noastră:

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

   

   Această formulă citește o etichetă NFC folosind funcția ReadNFC() și afișează informații de tip despre rezultat. Apoi colectează etichetele NFC citite pentru a popula colecția tagRecords pentru a fi folosită pentru galerie în următorii pași.

5. Adăugați un control Galerie ccu un aspect vertical.

6. Când vi se solicită, selectați colecția tagRecords ca sursă de date pentru această galerie. Acțiunea va seta proprietatea Elemente a controlului Gallery.

   

7. Repoziționați controlul galeriei astfel încât să nu se suprapună butonului și schimbați tipul de aspect la Titlu și subtitrare.

   

8. Schimbați formula Title din controlul galeriei în ThisItem.Value și modificați formula Subtitle din controlul galeriei la ThisItem.ID.

   De asemenea, puteți șterge NextArrow din controlul galeriei, deoarece nu este utilizat.

9. Salvați și publicați aplicația.

10. Deoarece funcția ReadNFC() nu poate fi utilizată în Power Apps Studio sau într-un browser web, deschideți aplicația pe un dispozitiv mobil.

    Bacșiș

    Aplicația poate dura câteva momente să apară pe dispozitivul dvs. mobil. Dacă nu vedeți aplicația listată, încercați să vă reîmprospătați lista de aplicații.

11. Selectați Citiți eticheta NFC și scanați o etichetă. Repetați procesul pentru a adăuga mai multe etichete la colecția dvs.