Share via

Funkce ReadNFC

  • Článek

Platí pro: aplikace plátna

Přečte značku Near Field Communication (NFC).

Description

Funkci ReadNFC použijte ke čtení značky NFC, která je blízko vašeho zařízení. Po vyvolání se na obrazovce zobrazí pokyny ke skenování značky NFC a návrat se provede až po naskenování značky nebo vypršení časového limitu.

Sloupcový Typ Description
Identifikátor Text Identifikátor značek NFC, pokud je k dispozici.
NDEFRecords Table Podporované záznamy NDEF nalezené na značce.

Jediný NDEFRcord obsahuje následující sloupce:

Sloupcový Typ Description
RTD Text Definice typ záznamu značky (RTD). V tuto chvíli jsou podporovány pouze hodnoty Text a URI.
TNF Počet Formát názvu typu značky (TNF). Pouze TNF z Dobře známý (1) jsou v tuto chvíli podporovány.
Text Text Textová datová část značky NFC, pokud má RTD hodnotu TEX, jinak je prázdná.
Identifikátor URI Hypertextový odkaz Datová část URI značky NFC, pokud má RTD hodnotu URI, jinak je prázdná.

Pokud záznam NDEF není podporován (například TNF není typu Dobře známý), pak nebude vrácen jako součást tabulky NDEFRecords.

Před použitím vždy zkontrolujte hodnoty datové části, zda není prázdná, pomocí funkce IsBlank. Nemusíte kontrolovat samotné hodnoty RTD a TNF, protože ty musí být správné, jinak by Text a URI měly prázdnou hodnotu.

V budoucnu mohou být podporovány další hodnoty značek RTD a TNF. Pokud je podporováno více hodnot, přidají se také další sloupce datové části. Nezpracované hodnoty RTD a TNF jsou poskytovány pro informační účely a není nutné je konzultovat, pokud je sloupec datové části prázdný. Více informací o těchto hodnotách a jejich použití je k dispozici prostřednictvím Fóra NFC.

ReadNFC nevyžaduje použití značky obsahující záznamy NDEF, ale přesto můžete získat identifikátor značky, pokud je k dispozici.

Funkce ReadNFC se dá použít jenom ve vzorcích chování.

Poznámka:

  • ReadNFC je podporováno pouze při spuštění aplikace v nativních mobilních aplikacích jako iOS a Android. Ani s podporovaným přehrávačem nemusí zařízení podporovat NFC. Pokud má vaše aplikace zapnutou možnost Správa chyb na úrovni vzorce, funkce vrátí chybu. Jinak se uživateli zobrazí zpráva a funkce vrátí prázdný záznam.
  • Chcete-li tuto funkci používat, ujistěte se, že má vaše zařízení povoleno nastavení NFC.

Syntaxe

ReadNFC()

Příklady

Vzorec Description Výsledek
ReadNFC().Identifier Vrátí identifikátor značky NFC, pokud existuje. 04A1C301314003
ReadNFC().NDEFRecords Vrátí tabulku záznamů NDEF nalezených na značce NFC, pokud jde o podporovaný typ a obsah. Výsledek NDEFRecords s příkladem záznamu.

Podrobný příklad

  1. Vytvořte prázdnou aplikaci plátna s formátem Telefon.

  2. Přidejte ovládací prvek Button.

  3. Poklepáním na ovládací prvek tlačítka změníte text tlačítka na Číst značku NFC (nebo upravte vlastnost Text).

  4. Nastavte vlastnost OnSelect ovládacího prvku tlačítka do tohoto vzorce, který přidá položku do naší kolekce:

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

    Výše uvedený vzorec zadaný jako vlastnost OnSelect tlačítka.

    Tento vzorec čte značku NFC pomocí funkce ReadNFC() a zobrazí informace o typu o výsledku. Poté shromáždí přečtené značky NFC a naplní je kolekcí tagRecords, která má být v dalších krocích použita pro galerii.

  5. Přidejte ovládací prvek Gallery s vertikálním rozložením.

  6. Po zobrazení výzvy vyberte kolekci tagRecords jako zdroj dat pro tuto galerii. Tato akce nastaví vlastnost Items ovládacího prvku Gallery na tento vzorec.

    Zdroj dat pro galerii zvolenou jako tagRecords.

  7. Přemístěte ovládací prvek galerie tak, aby nepřekrýval tlačítko, a změňte typ rozvržení na Název a podtitul.

    Rozložení galerie.

  8. Změňte vzorec Titul v ovládacím prvku galerie na ThisItem.Value a změňte vzorec Podtitul v ovládacím prvku galerie na ThisItem.ID.

    Můžete také odstranit NextArrow z ovládacího prvku galerie, protože se nepoužívá.

  9. Uložte a publikujte aplikaci.

  10. Protože funkci ReadNFC() nelze použít v Power Apps Studio nebo ve webovém prohlížeči, otevřete aplikaci na mobilním zařízení.

    Zpropitné

    Zobrazení aplikace na vašem mobilním zařízení může chvíli trvat. Pokud aplikaci v seznamu nevidíte, zkuste seznam aplikací obnovit.

  11. Vyberte Přečíst značku NFC a naskenujte značku. Chcete-li do sbírky přidat více značek, opakujte postup.

    Aplikace na mobilním zařízení s příkladem čtení značek NFC a výsledkem v galerii.