Share via

ReadNFC-funktionen

  • Artikel

Gäller: Arbetsyteappar

Läser en NFC-tagg (Near Field Communication).

Description

Använd ReadNFC-funktionen för att läsa en NFC-tagg som finns nära enheten. När den startas visas instruktionerna för skanningen av NFC-taggen och returneras endast när taggen har tagits bort eller tidsgränsen har gått ut.

Kolumn Typ Beskrivning
Identifierare Text NFC-taggidentifieraren om tillgänglig.
NDEFRecords Register De NDEF-poster som stöds finns på taggen.

En enda NDEFRecord innehåller följande kolumner:

Kolumn Typ Beskrivning
RTD Text Definition av taggens posttyp (RTD). Endast Text och URI stöds för tillfället.
TNF Antal Taggens typnamnformat (TNF). För närvarande stöds endast välkända(1) TNF.
Text Text Text nyttolasten för NFC-taggen om RTD är TEXT, tom annars.
URI Hyperlänk URI-nyttolasten för NFC-taggen om RTD är URI, tom annars.

Om NDEF-posten inte stöds (t.ex. är TNF inte av typen välkänd), då kommer det inte att returneras som en del av tabellen NDEFRecords.

Kontrollera alltid att nyttolastvärden är tomt med hjälp av IsBlank funktion innan du använder den. Du behöver inte själv kontrollera RTD och TNF värdena eftersom de måste vara korrekta värden för Text och URI för att ha ett icke tomt värde.

Ytterligare RTD och TNF värden kan stödjas i framtiden. Om det finns stöd för fler värden läggs även ytterligare nyttolastkolumner till. Råa värden för RTD och TNF tillhandahålls i informationssyfte och behöver inte konsulteras om nyttolastkolumnen kontrolleras tom. Mer information om dessa värden och hur de används hittar du via NFC Forum.

ReadNFC kräver inte en tagg som innehåller NDEF-poster för att användas, men du kan fortfarande få taggen identifieraren om en sådan är tillgänglig.

ReadNFC kan bara användas i beteendeformler.

Kommentar

  • ReadNFC stöds endast när appen körs på en inbyggd mobilapp, till exempel iOS och Android-appar. Även med en spelare som stöds kanske en enhet inte stöder NFC. Om ditt program har Felhantering på formelnivå aktiverat returnerar funktionen ett fel. Annars visas ett felmeddelande för användaren och funktionen returnerar en tom post.
  • Se till att din enhet har NFC-inställningen aktiverad för att använda denna funktion.

Syntax

ReadNFC()

Exempel

Formel Beskrivning Resultat
ReadNFC().Identifier Returnerar identifieraren för NFC-taggen om en sådan finns. 04A1C301314003
ReadNFC().NDEFRecords Returnerar en tabell med NDEF-poster som finns på NFC-taggen om de är en typ och nyttolast som stöds. NDEFRecords resultat med en exempelpost.

Detaljerat exempel

  1. Skapa en tom arbetsyteapp med formatet telefon.

  2. Lägg till en Button-kontroll.

  3. Dubbelklicka på Button-kontroll om du vill ändra knapptexten till Läs NFC-tagg (eller ändra egenskapen Text).

  4. Ange egenskapen OnSelectför Button-kontroll till den här formeln som lägger till ett objekt i vår samling:

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

    Ovanstående formel anges som egenskapen OnSelect för knappen.

    Denna formel läser en NFC-tagg med funktionen ReadNFC() och visar typinformation om resultatet. Sedan samlar den in NFC-taggar för att fylla i tagRecords samlingen som ska användas för galleriet i nästa steg.

  5. Lägg till kontrollen Gallery med en vertikal layout.

  6. När du uppmanas väljer du samlingen tagRecords som datakälla för det här galleriet. Denna åtgärd anger egenskapen Items för Gallery-kontrollen till den här formeln.

    Datakälla för galleri som valts som tagRecords.

  7. Flytta kontrollen så att den inte överlappar knappen och ändra layouttypen till Titel och undertext.

    Layout för galleriet.

  8. Ändra formeln Titel i kontrollen gallery till ThisItem.Value och ändra formeln undertext i kontrollen gallery till ThisItem.ID.

    Du kan också ta bort NextArrow från kontrollen gallery eftersom den inte används.

  9. Spara och publicera programmet.

  10. Eftersom funktionen ReadNFC() inte kan användas i Power Apps Studio eller i en webbläsare öppnar du programmet på en mobil enhet.

    Dricks

    Det kan ta en stund innan programmet visas på din mobila enhet. Om programmet inte visas kan du försöka uppdatera ditt programlista.

  11. Välj Läs NFC-taggen och sök efter en tagg. Upprepa processen om du vill lägga till flera taggar i samlingen.

    App på mobil enhet med NFC-taggens läsexempel och resultatet i galleriet.