Share via

Funksjonen ReadNFC

  • Artikkel

Gjelder: 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 Bekrivelse
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 Bekrivelse
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 et merke som inneholder NDEF-oppføringer, skal brukes, men du kan fremdeles hente merkeidentifikatoren hvis en er tilgjengelig.

ReadNFC kan bare brukes i formler for virkemåte.

Merk

  • ReadNFC støttes bare når du kjører appen i en opprinnelig mobilapp, for eksempel iOS- 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

ReadNFC()

Eksempler

Formel Bekrivelse 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. NDEFRecords-resultat med en eksempeloppføring.

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

    Formelen ovenfor angitt som OnSelect-egenskapen for knappen.

    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.

    Datakilde for galleriet valgt som tagRecords.

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

    Oppsett for galleriet.

  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.

    App på mobilenhet med eksemplet på avlesning av NFC-merke og resultatet inne i galleriet.