Funksjonen ReadNFC

Gjelder for: Lerretsapper

Leser et NFC-merke (nærfeltskommunikasjon).

Description

Bruk funksjonen ReadNFC til å lese et NFC-merke som er nært enheten. Når funksjonen aktiveres, vises instruksjoner for å lese et NFC-merke, og skjermen går bare tilbake etter at merket er lest eller etter et tidsavbrudd.

Kolonne	Type	Beskrivelse
Identifikator	Tekstmelding	NGC-merkeidentifikatoren hvis tilgjengelig.
NDEFRecords	Table	De støttede NDEF-oppføringene som ble funnet på merket.

En enkelt NDEFRecord inneholder følgende kolonner:

Kolonne	Type	Beskrivelse
RTD	Tekstmelding	Merkets oppføringstypedefinisjon (RTD). Bare Tekst og URI støttes for øyeblikket.
TNF	Nummer	Merkets typenavnformat (TNF). Bare TNF-er av Velkjent(1) støttes for øyeblikket.
Tekstmelding	Tekstmelding	Tekstnyttelasten for NFC-merket hvis RTD er TEKST, ellers tom.
URI	Hyperkobling	URI-nyttelasten for NFC-merket hvis RTD er URI, ellers tom.

Hvis NDEF-oppføringen ikke støttes (TNF er for eksempel ikke av typen Velkjent), returneres den ikke som en del av tabellen NDEFRecords.

Du må alltid kontrollere nyttelastverdiene for tom ved å bruke funksjonen IsBlank før du bruker den. Du trenger ikke å kontrollere verdiene for RTD og TNF selv fordi de må være de riktige verdiene for Tekst og URI for å kunne ha en verdi som ikke er tom.

Det kan hende at flere verdier for RTD og TNF støttes i fremtiden. Hvis flere verdier støttes, blir det også lagt til flere nyttelastkolonner. De rå verdiene for RTD og TNF er til informasjonsformål, og det er ikke nødvendig å slå dem opp hvis det kontrolleres om nyttelastkolonnen er tom. Mer informasjon om disse verdiene og bruken av dem er tilgjengelig via NFC-forumet.

ReadNFC krever ikke at en tag som inneholder NDEF-poster brukes, men du kan fortsatt få tag-identifikatoren hvis en er tilgjengelig.

ReadNFC kan bare brukes i atferdsformler.

Merk

• ReadNFC støttes bare når du kjører appen på en innebygd mobilapp, for eksempel iOS appen og Android apper. Selv med en støttet spiller kan det hende at en enhet ikke støtter NFC. Hvis appen har Feiladministrasjon på formelnivå aktivert, returnerer funksjonen en feil. Ellers vises en melding til brukeren, og funksjonen returnerer en tom oppføring.
• Kontroller at enheten har NFC-innstillingen aktivert for å bruke denne funksjonen.

Syntaks

LeseNFC()

Eksempler

Formel	Beskrivelse	Resultat
ReadNFC().Identifier	Returnerer identifikatoren for NFC-merket hvis dette finnes.	04A1C301314003
ReadNFC().NDEFRecords	Returnerer en tabell med NDEF-oppføringer funnet på NFC-merket hvis de er av en støttet type og nyttelast.

Trinnvis veiledning – eksempel

1. Opprett en tom lerretsapp med Telefon-format.

2. Legg til en Button-kontroll.

3. Dobbeltklikk knappekontrollen for å endre knappeteksten til Les NFC-merke (eller endre Text-egenskapen).

4. Angi OnSelect-egenskapen for knappekontrollen til denne formelen, som legger til et element i samlingen:

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

   

   Denne formelen leser et NFC-merke ved hjelp av ReadNFC()-funksjonen og viser typeinformasjon om resultatet. Deretter samler den inn de avleste NFC-merkene for å fylle ut tagRecords-samlingen som skal brukes for galleriet i de neste trinnene.

5. Legg til en Galleri-kontroll med et tomt loddrett oppsett.

6. Når du blir bedt om det, velger du tagRecords-samlingen som datakilde for galleriet. Denne handlingen angir Items-egenskapen for Gallery-kontrollen.

   

7. Flytt gallerikontrollen slik at den ikke overlapper knappen, og endre oppsettstypen til Tittel og undertittel.

   

8. Endre Tittel-formelen i gallerikontrollen til ThisItem.Value, og endre Undertittel-formelen i gallerikontrollen til ThisItem.ID.

   Du kan også slette NextArrow fra gallerikontrollen fordi den ikke brukes.

9. Lagre og publiser appen.

10. Siden funksjonen ReadNFC() ikke kan brukes i Power Apps Studio eller i en nettleser, åpner du appen på en mobilenhet.

    Tips

    Det kan ta litt tid før appen vises på mobilenheten din. Hvis appen ikke vises, kan du prøve å oppdatere applisten.

11. Velg Les NFC-merke, og skann et merke. Gjenta prosessen for å legge til flere merker i samlingen.