Funkcja ReadNFC

Dotyczy: Aplikacje kanwy

Odczytuje tag NFC (Near Field Communication).

Popis

Użyj funkcji ReadNFC, aby odczytać znacznik NFC, który jest zbliżony do urządzenia. Po wywołaniu ekran wyświetla instrukcje skanowania tagu NFC i powraca dopiero po zeskanowaniu tagu lub upłynięciu limitu czasu.

Kolumna	Typ	Opis
Identyfikator	Tekst	Identyfikator tagu NFC, jeśli jest dostępny.
NDEFRecords	Table	Obsługiwane rekordy NDEF znajdujące się na tagu.

Pojedynczy NDEFRecord zawiera następujące kolumny:

Kolumna	Typ	Opis
RTD	Tekst	Definicja aktualizacji typ rekordu (RTD) znacznika. Obecnie Text i URI są obsługiwane.
TNF	telefonu	Format nazwy typu znacznika (TNF). W tej chwili wspierane są tylko TNF-y z grupy Well Known(1).
Tekst	Tekst	Ładunek tekstowy tagu NFC, jeśli RTD to TEXT, puste w przeciwnym razie.
Identyfikator URI	Hiperlink	Ładunek URI tagu NFC, jeśli RTD to URI, puste w przeciwnym razie.

Jeśli rekord NDEF nie jest obsługiwany (np. TNF nie jest typu Well Known), nie zostanie zwrócony jako część tabeli NDEFRecords.

Przed użyciem zawsze należy sprawdzić wartości ładunku jako pustą, używając funkcji IsBlank przed jej użyciem. Nie trzeba samodzielnie sprawdzać wartości RTD i TNF , ponieważ muszą one być prawidłowymi wartościami dla tekstu i wartości URI, aby nie były puste.

Dodatkowe wartości RTD i TNF mogą być obsługiwane w przyszłości. Jeśli obsługiwanych jest więcej wartości, zostaną również dodane dodatkowe kolumny ładunku. Surowe wartości RTD i TNF są podane w celach informacyjnych i nie trzeba ich sprawdzać, jeśli kolumna payload jest zaznaczona jako pusta. Więcej informacji na temat tych wartości i ich używania można znaleźć na forum NFC.

ReadNFC nie wymaga użycia tagu zawierającego rekordy NDEF, ale nadal możesz uzyskać identyfikator tagu, jeśli jest dostępny.

ReadNFC może być używany tylko w formułach zachowań.

Uwaga

• Funkcja ReadNFC jest obsługiwana tylko w przypadku uruchamiania aplikacji w natywnej aplikacji mobilnej, takiej jak i iOS Android aplikacje. Nawet w przypadku obsługiwanego odtwarzacza urządzenie może nie obsługiwać NFC. Jeśli twoja aplikacja ma włączone zarządzanie błędami na poziomie formuły, funkcja zwróci błąd. W przeciwnym razie użytkownikowi zostanie wyświetlony komunikat o błędzie, a funkcja zwróci pusty rekord.
• Aby skorzystać z tej możliwości, upewnij się, że twoje urządzenie ma włączone ustawienie NFC.

Składnia

Odczyt NFC()

Przykłady

Formuła	Opis	Wynik
ReadNFC().Identifier	Zwraca identyfikator tagu NFC, jeśli taki istnieje.	04A1C301314003
ReadNFC().NDEFRecords	Zwraca tablicę rekordów NDEF znalezionych na tagu NFC, jeśli są one obsługiwanego typu i ładunku.

Przykład krok po kroku

1. Tworzenie pustej aplikacji kanwy z formatem Telefon.

2. Dodawanie kontrolki Button.

3. Kliknij dwukrotnie formant przycisku, aby zmienić tekst przycisku na Ładuj tag NFC (lub zmodyfikowania właściwości Text).

4. W tym celu należy ustawić właściwość OnSelect kontrolki przycisku na tę formułę, która doda element do kolekcji:

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

   

   Ta formuła odczytuje tag NFC przy użyciu funkcji ReadNFC() i wyświetla informacje o typie wyniku. Następnie zbiera odczytane tagi NFC, aby zapełnić kolekcję tagRecords, która w następnych krokach zostanie użyta w galerii.

5. Wstaw kontrolkę Galeria z pionową orientacją.

6. Po wyświetleniu monitu wybierz kolekcję tagRecords jako źródło danych tej galerii. To działanie ustawi właściwość Items kontrolki Gallery obrazów na wartość.

   

7. Przesuń kontrolkę galerii tak, aby nie zachodziła na przycisk, i zmień typ układu na tytuł i napis.

   

8. Zmień formułę Title w kontrolce galerii na ThisItem.Value i zmień formułę Subtitle w kontrolce galerii na ThisItem.ID.

   Możesz również usunąć NextArrow z kontrolki galerii, ponieważ nie jest ona używana.

9. Zapisz i opublikuj aplikację.

10. Ponieważ funkcja ReadNFC() nie może być użyta w Power Apps Studio ani w przeglądarce internetowej, otwórz swoją aplikację na urządzeniu mobilnym.

    Napiwek

    Pojawienie się aplikacji na twoim urządzeniu mobilnym może potrwać kilka chwil. Jeśli nie widzisz aplikacji na liście, spróbuj odświeżyć listę aplikacji.

11. Wybierz Odczytaj tag NFC i zeskanuj tag. Powtórz ten proces, aby dodać do kolekcji wiele znaczników.