Share via

ReadNFC funkció

  • Cikk

A következőkre vonatkozik: Vászonalapú alkalmazások

Beolvassa a Near Field Communication-címkét (kis hatótávolságú kommunikáció, NFC).

Description

A ReadNFC függvénnyel beolvashat egy olyan NFC-címkét, amely közel van a készülékéhez. Meghívásakor a képernyő megjeleníti az NFC-címke beolvasására vonatkozó utasításokat, és csak a címke beolvasása vagy az időkorlát túllépése után tér vissza.

Oszlop Típus Ismertetés
Azonosító Szöveges Az NFC-címke azonosítója, ha elérhető.
NDEFRecords Tábla A címkén található támogatott NDEF-rekordok.

Az egyéni NDEFRecord a következő oszlopokat tartalmazza:

Oszlop Típus Ismertetés
RTD Szöveges A címke rekordtípus-meghatározását (RTD). Jelenleg csak a Text és az URI támogatott.
TNF Szám A címke típusnév-formátuma (TNF). Jelenleg csak az olyan TNF-ek támogatottak, amelyek értéke Well Known(1).
Szöveges Szöveges Az NFC-címke szöveges adattartalma, ha az RTD TEXT, egyébként üres.
URI Hivatkozás Az NFC-címke URI-adattartalma, ha az RTD URI, egyébként üres.

Ha az NDEF-rekord nem támogatott (például a TNF típusa nem Well Known), akkor a rendszer nem adja vissza az NDEFRecords tábla részeként.

Használat előtt mindig ellenőrizze az adattartalom értékét, hogy üres-e, az IsBlank függvény segítségével. Az RTD és TNF értékeket nem kell ellenőriznie, mivel a Text és URI értékeknek helyesnek kell lenniük ahhoz, hogy ne üres értéket kapjanak.

A jövőben további RTD- és TNF-értékek is támogatottá válhatnak. Több érték támogatása esetén további adattartalom-oszlopok kerülnek hozzáadásra. A nyers RTD és TNF értékek tájékoztató jellegűek, és nem kell figyelembe venni őket, ha a hasznos adat oszlopának jelölése üres. További információ ezekről az értékekről és használatukról az NFC Forumon található.

A ReadNFC a használatához nem igényel NDEF-rekordokat tartalmazó címkét, azonban ha elérhető, lekérheti a címkeazonosítót.

A ReadNFC csak viselkedési képletekben használható.

Feljegyzés

  • A ReadNFC csak akkor támogatott, ha az alkalmazást natív mobilalkalmazáson, például az iOS és Android alkalmazásokon futtatja. Még a támogatott lejátszók esetében is előfordulhat, hogy az eszköz nem támogatja az NFC-t. Ha az alkalmazása képletszintű hibakezelése be van kapcsolva, a függvény hibát ad vissza. Egyéb esetben a felhasználónak egy üzenet jelenik meg, és a függvény egy üres rekordot küld vissza.
  • Gondoskodjon róla, hogy a készüléken engedélyezve legyen az NFC a képesség használata érdekében.

Szintaxis

ReadNFC()

Példák

Képlet Ismertetés Eredmény
ReadNFC().Identifier Visszaadja az NFC-címke azonosítóját, ha van ilyen. 04A1C301314003
ReadNFC().NDEFRecords Visszaadja az NFC-címkén található NDEF-rekordok tábláját, ha a rendszer támogatja a típusukat és tartalmukat. Az NDEFRecords eredménye egy példarekorddal.

Részletes példa

  1. Hozzon létre egy üres vászonalapú alkalmazástTelefon formátummal.

  2. Egy Gomb vezérlő hozzáadása.

  3. Kattintson duplán a gomb vezérlőre, és módosítsa a gomb szövegét az NFC-címke beolvasása lehetőségre (vagy módosítsa a Szöveg tulajdonságot).

  4. Állítsa be a gomb vezérlő OnSelect tulajdonságát erre a képletre, amely egy elemet vesz fel a gyűjteménybe:

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

    A fenti képlet a gomb OnSelect tulajdonságaként van megadva.

    Ez a képlet beolvassa az NFC-címkét a ReadNFC() függvény használatával, és megjeleníti az eredményre vonatkozó típusinformációkat. Ezután összegyűjti az NFC-címkéket, hogy a következő lépésekben feltöltse a tagRecords gyűjteményt, amely a kollekcióhoz használható.

  5. Katalógus vezérlőelem hozzáadása függőleges tájolással.

  6. Amikor a rendszer kéri, jelölje ki a tagRecords gyűjteményt mint a katalógus adatforrását. Beállítja az Elemek tulajdonságát a Katalógus vezérlőnek.

    Adatforrás a tagRecords néven kiválasztott katalógushoz.

  7. A katalógusvezérlőt úgy kell áthelyezni, hogy ne legyen átfedésben a gombbal, majd módosítsa az elrendezés típusát Cím és alcím típusra.

    A galéria elrendezése.

  8. Módosítsa a Cím képletet a katalógusvezérlőben ThisItem.Value értékre, és módosítsa a katalógusban az Alcím képletet a következőre: ThisItem.ID.

    A NextArrow is törölhető a katalógusvezérlőből, mivel nincs használatban.

  9. Mentse és tegye közzé az alkalmazást.

  10. Mivel a ReadNFC() függvény nem használható Power Apps Studio rendszerben vagy webbögénszőben, nyissa meg az alkalmazást mobileszközön.

    Tipp.

    Az alkalmazás megjelenése a mobileszközén eltarthat néhány pillanatig. Ha nem látható az alkalmazás a listán, próbálja meg frissíteni az alkalmazáslistát.

  11. Válassza az NFC-címke beolvasása lehetőséget, és olvasson be egy címkét. Ismételje meg a folyamatot, ha több címkét szeretne hozzáadni a gyűjteményhez.

    Alkalmazás mobileszközön az NFC-címke olvasási példájával és a galérián belüli eredménnyel.