ReadNFC-funktio

  • Artikkeli

Soveltuu: Pohjaan perustuvat sovellukset

Lukee NFC (Near Field Communication) -tunnisteen.

Description

ReadNFC-funktion avulla voi lukea lähellä laitetta olevan NFC-tunnisteen. Kun toiminto käynnistetään, näytössä on ohjeet NFC-tunnisteen tarkistamiseen, ja se palautuu vasta, kun tunniste on luettu tai se aikakatkaistaan.

Sarake Type Description
Identifier Viesti NFC-tunnisteiden tunniste, jos käytettävissä.
NDEFRecords Table Tunnisteessa havaitut tuetut NDEF-tietueet.

Yksi NDEFRecord sisältää seuraavat sarakkeet:

Sarake Type Description
RTD Viesti Tunnisteen tietuetyypin määritys (RTD). Tällä hetkellä tuettuja ovat vain TEXT- ja URI.
TNF Number Tunnisteen tyypin nimen muoto (TNF). Tällä hetkellä vain TNF-muotoa Well Known(1) tuetaan.
Viesti Viesti NFC-tunnisteen tekstitiedot, jos RTD on TEXT, muuten tyhjä.
URI Hyperlinkki NFC-tunnisteen URI-tiedot, jos RTD on URI, muuten tyhjä.

Jos NDE-tietuetta ei tueta (esimerkiksi TNF-tyyppi ei ole Well Known), sitä ei palauteta NDEFRecords-taulukon osana.

Tarkista ennen sen käyttöä tyhjän arvo IsBlank-funktion avulla. RTD- ja TNF-arvoja ei tarvitse tarkistaa itse, koska niiden Text- ja URI-arvojen on oltava oikeat, jotta arvo ei ole tyhjä.

RTD- ja TNF-lisäarvoja voidaan tukea tulevaisuudessa. Jos tuettuja arvoja on enemmän, myös lisätietojen sarakkeita lisätään. RTD- ja TNF-raaka-arvot annetaan tiedoksi eikä niitä tarvitse ottaa huomioon, jos tarkistetaan, onko tietosarake tyhjä. Lisätietoja näistä arvoista ja niiden käytöstä on NFC-keskustelupalstalla.

ReadNFC ei edellytä NDEF-tietueita sisältävän tunnisteen käyttöä, mutta tunnistetunnus voidaan saada, jos sellainen on käytettävissä.

ReadNFC-funktiota voidaan käyttää vain toimintokaavoissa.

Muistiinpano

  • ReadNFC-arvoa tuetaan vain, kun sovellusta käytetään alkuperäisessä mobiilisovelluksissa, kuten iOS ja Android. Vaikka kyse olisi tuetusta laitteesta, laite ei ehkä tue NFC:tä. Jos Kaavatason virheiden hallinta on otettu sovelluksessa käyttöön, funktio palauttaa virheen. Muussa tapauksessa käyttäjälle näytetään sanoma, jonka jälkeen funktio palauttaa tyhjän tietueen.
  • Ominaisuuden käyttö edellyttää, että NFC-asetus on otettu laitteessa käyttöön.

Syntaksi

ReadNFC()

Esimerkkejä

Kaava Description Tulos
ReadNFC().Identifier Palauttaa NFC-tunnisteen tunnuksen, jos sellainen on olemassa. 04A1C301314003
ReadNFC().NDEFRecords Palauttaa NFC-tunnisteesta löytyneen NDEF-tietueiden taulukon, jos niiden tyyppiä ja tietoja tuetaan. NDEFRecords-tulos ja esimerkkitietue

Vaiheittainen esimerkki

  1. Luo tyhjä pohjaan perustuva sovellus, jonka muoto on Puhelin.

  2. Lisää Button-ohjausobjekti.

  3. Vaihda painikkeen tekstiksi Lue NFC-tunniste kaksoisnapsauttamalla painikeohjausobjektia (tai muokkaamalla Text-ominaisuutta).

  4. Määritä painikeohjausobjektin OnSelect-ominaisuus tähän kaavaan, joka lisää kohteen kokoelmaan:

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

    Edellä oleva kaava syötetään painikkeen OnSelect-ominaisuutena

    Tämä kaava lukee NFC-tunnisteen käyttämällä ReadNFC()-funktiota ja näyttää tulosta koskevat tyyppitiedot. Se kerää sitten luetut NFC-tunnisteet, joilla täytetään seuraavissa vaiheissa käytettävän valikoiman tagRecords-kokoelman.

  5. Lisää Gallery-ohjausobjekti, jonka asettelu on pystysuuntainen.

  6. Valitse pyydettäessä tagRecords-kokoelma tämän valikoiman tietolähteeksi. Tämä toiminto määrittää Gallery-ohjausobjektin Items-ominaisuuden.

    Valikoiman tietolähteeksi valittu tagRecords

  7. Siirrä valikoimaohjausobjektia siten, että se ei ole painikkeen kanssa päällekkäin, ja vaihda asettelun tyypiksi Otsikko ja alaotsikko.

    Valikoiman asettelu

  8. Vaihda valikoimaohjausobjektin Otsikko-kaavaksi ThisItem.Value ja vaihda valikoimaohjausobjektin Aliotsikko-kaavaksi ThisItem.ID.

    NextArrow voidaan lisäksi poistaa valikoimaohjausobjektista, sillä sitä ei käytetä.

  9. Tallenna ja julkaise sovellus.

  10. Koska ReadNFC()-funktiota ei voi käyttää Power Apps Studiossa tai selaimessa, avaa sovellus mobiililaitteessa.

    Tippi

    Sovelluksen avautuminen mobiililaitteeseen voi kestän jonkin aikaa. Jos sovellus ei näy luettelossa, yritä päivittää sovellusluettelo.

  11. Valitse Lue NFC-tunniste ja lue tunniste. Voit lisätä useita tunnisteita kokoelmaan toistamalla tämän prosessin.

    Mobiililaitteen sovellus, jossa on NFC-tunnisteen lukuesimerkki ja valikoimassa oleva tulos