Funkcia ReadNFC

Vzťahuje sa na: aplikácie Canvas

Číta značku NFC (Near Field Communication).

Description

Funkciu ReadNFC použite na načítanie značky NFC, ktorá je v blízkosti vášho zariadenia. Po vyvolaní sa na obrazovke zobrazia pokyny na skenovanie značky NFC a vráti hodnotu až po naskenovaní značky alebo vypršaní časového limitu.

Stĺpcový	Typ	Opis
Identifikátor	SMS správa	Identifikátor značiek NFC, ak je k dispozícii.
NDEFRecords	Table	Na značke sa nachádzajú podporované záznamy NDEF.

Jeden NDEFRecord obsahuje nasledujúce stĺpce:

Stĺpcový	Typ	Opis
RTD	SMS správa	Definícia typ záznamu (RTD) značky. Iba Text a URI sú momentálne podporované.
TNF	Číslo	Formát názvu typu (TNF) značky. V súčasnosti sú podporované iba TNF typu Well Known(1).
SMS správa	SMS správa	Užitočný text značky NFC, ak RTD je TEXT, inak prázdny.
URI	Hypertextové prepojenie	Užitočné URI značky NFC ak RTD je URI, inak prázdny.

Ak záznam NDEF nie je podporovaný (napríklad TNF nie je typu Well Known), nebude vrátený ako súčasť tabuľky NDEFRecords.

Vždy skontrolujte hodnoty údajovej časti, či nie je prázdna, pomocou funkcie IsBlank pred použitím. Nemusíte kontrolovať hodnoty RTD a TNF sami, pretože musia byť správnymi hodnotami pre Text a URI, ak nemajú prázdnu hodnotu.

Dodatočné hodnoty RTD a TNF môžu byť podporované v budúcnosti. Ak je podporovaných viac hodnôt, pridajú sa aj ďalšie stĺpce údajovej časti. Nespracované hodnoty RTD a TNF slúžia na informačné účely a nie je potrebné ich konzultovať, ak je začiarknuté políčko s užitočným zaťažením prázdne. Viac informácií o týchto hodnotách a ich použití je k dispozícii na internetovej stránke Fóra NFC.

ReadNFC nevyžaduje použitie značky obsahujúcej záznamy NDEF, ale stále môžete získať identifikátor značky, ak je k dispozícii.

ReadNFC možno použiť len vo vzorcoch správania.

Poznámka

• Čítanie NFC je podporované iba pri spustení aplikácie v natívnej mobilnej aplikácii, ako sú napríklad aplikácie iOS a Android . Dokonca aj s podporovaným prehrávačom nemusí zariadenie podporovať NFC. Ak má vaša aplikácia zapnutú Správu chýb na úrovni vzorca, funkcia vráti chybu. Inak sa používateľovi sa zobrazí správa a funkcia vráti prázdny záznam.
• Ak chcete používať túto funkciu, uistite sa, že má vaše zariadenie povolené nastavenie NFC.

Syntax

ReadNFC()

Príklady

Vzorec	Opis	Výsledok
ReadNFC().Identifier	Vráti identifikátor značky NFC, ak existuje.	04A1C301314003
ReadNFC().NDEFRecords	Vráti tabuľku záznamov NDEF nájdených na značke NFC, ak ide o podporovaný typ a údajovú časť.

Podrobný príklad

1. Vytvorte prázdnu aplikáciu plátna s formátom pre telefón.

2. Pridajte ovládací prvok Tlačidlo.

3. Dvakrát kliknite na ovládací prvok tlačidla a zmeňte text tlačidla na Načítať značku NFC (alebo upravte vlastnosť Text).

4. Nastavte vlastnosť OnSelect ovládacieho prvku tlačidla na tento vzorec, ktorý pridá položku do našej kolekcie:

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

   

   Tento vzorec načíta značku NFC pomocou funkcie ReadNFC() a zobrazí informácie o type výsledku. Potom zhromaždí prečítané značky NFC, aby sa naplnila kolekcia tagRecords, ktorá sa použije pre galériu v ďalších krokoch.

5. Pridanie ovládacieho prvku Galéria s vertikálnou orientáciou.

6. Po zobrazení výzvy vyberte kolekciu tagRecords ako zdroj údajov pre túto galériu. Táto akcia nastaví vlastnosť Items ovládacieho prvku Galéria.

   

7. Premiestnite ovládací prvok galérie tak, aby neprekrýval tlačidlo, a zmeňte typ rozloženia na Názov a titulok.

   

8. Zmeňte vzorec Názov v ovládacom prvku galérie na ThisItem.Value a zmeňte vzorec Titulok v ovládacom prvku galérie na ThisItem.ID .

   Môžete tiež odstrániť šípku NextArrow z ovládacieho prvku galérie, pretože sa nepoužíva.

9. Uložte a publikujte aplikáciu.

10. Keďže funkciu ReadNFC() nie je možné použiť v Power Apps Studio ani vo webovom prehliadači, otvorte aplikáciu na mobilnom zariadení.

    Prepitné

    Aplikácii môže chvíľu trvať, kým sa zobrazí na vašom mobilnom zariadení. Ak sa aplikácia v zozname nezobrazuje, skúste obnoviť zoznam aplikácií.

11. Vyberte Prečítať značku NFC a naskenujte značku. Ak chcete do kolekcie pridať viacero značiek, postup zopakujte.