Zdieľať cez

Funkcia ReadNFC

  • Článok

Platí pre: 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ĺpec 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ĺpec 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 tagu obsahujúceho záznamy NDEF, ale stále môžete získať identifikátor tagu, ak je k dispozícii.

ReadNFC je možné použiť iba v 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

ČítaťNFC()

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ť. Výsledkom NDEFRecords je vzorový záznam.

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)})))

    Vyššie uvedený vzorec zadaný ako vlastnosť OnSelect tlačidla.

    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.

    Zdroj údajov pre galériu vybratú ako tagRecords.

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

    Rozloženie galérie.

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

    Aplikácia na mobilnom zariadení s príkladom čítania značiek NFC a výsledkom v galérii.