Функція ReadNFC

Застосовується до: програм Canvas

Зчитує позначку Near Field Communication (NFC).

Опис

Скористайтеся функцією ReadNFC, щоб прочитати позначку NFC, розташовану поруч із пристроєм. Під час виклику на екрані відобразяться інструкції щодо перевірки позначки NFC і повертається лише після того, як позначку проскановано або минув час очікування.

Стовпець	Тип	Опис
Identifier	SMS	Ідентифікатор позначки NFC, якщо доступний.
NDEFRecords	Table	Підтримувані записи NDEF, знайдені в позначці.

Один NDEFRecord містить такі стовпці:

Стовпець	Тип	Опис
RTD	SMS	Визначення типу запису позначки (RTD). Наразі підтримуються лише Текст і URI.
TNF	Число	Формат імені типу тега (TNF). Наразі підтримуються лише TNF значення Відомий (1).
SMS	SMS	Текстове значення позначки NFC, якщо RTD має значення ТЕКСТ, blank.
URI	Гіперпосилання	Значення URI позначки NFC, якщо RTD має значення URI або blank.

Якщо запис NDEF не підтримується (наприклад, TNF не типом Відомий), то його не буде повернуто як частину таблиці NDEFRecords.

Завжди перед використанням перевіряйте значення пустого вмісту дляпусто за допомогою функції IsBlank. Вам не потрібно перевіряти значення RTD і TNF самостійно, оскільки вони мають бути виправленими значеннями для Текст і URI і не бути пустими.

Додаткові значення RTD і TNF можуть підтримуватися в майбутньому. Якщо підтримуються інші значення, також будуть додані додаткові стовпці з корисним вмістом. Необроблені значення RTD та TNF надаються з інформаційною метою, і не потребують уваги, якщо стовпець з корисними даними перевірено на blank (пусте) значення. Додаткові відомості про ці значення та їх використання можна отримати на форумі NFC.

Для ReadNFC не потрібно використовувати позначку з потрібними записами NDEF, але ідентифікатор позначки все ще можна отримати, якщо він доступний.

ReadNFC можна використати тільки у формулах поведінки.

Нотатка

• ReadNFC підтримується лише під час запуску програми у власному мобільному додатку, наприклад і iOSAndroid програмах. Навіть якщо програвач підтримується, пристрій може не підтримувати NFC. Якщо в програмі ввімкнуто Керування помилками на рівні формули, ця функція поверне помилку. В іншому разі для користувача відобразиться повідомлення про помилку, і функція поверне пустий запис.
• Щоб використовувати цю можливість, переконайтеся, що на вашому пристрої ввімкнуто параметр NFC.

Синтаксис

ReadNFC()

Приклади

Формула	Опис	Результат
ReadNFC().Identifier	Повертає ідентифікатор позначки NFC, за наявності.	04A1C301314003
ReadNFC().NDEFRecords	Повертає таблицю записів NDEF, знайдених у позначці NFC, якщо вони мають підтримуваний тип та вміст.

Покроковий приклад

1. Створіть пусту компоновану програму з форматом Телефон.

2. Додайте елемент керування Кнопка.

3. Двічі клацніть елемент керування кнопкою, щоб змінити текст кнопки на Зчитати позначку NFC (або змініть властивість Текст).

4. Встановіть властивість OnSelect елемента керування кнопкою на цю формулу, яка додасть один елемент до нашої колекції.

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

   

   Ця формула зчитує позначку NFC за допомогою функції ReadNFC() та відображає інформацію про результат. Потім вона збирає зчитані позначки NFC, щоб заповнити колекцію tagRecords, яка використовуватиметься для колекції на наступних кроках.

5. Додайте елемент керування Галерея з вертикальним макетом.

6. Коли відобразиться запит, виберіть колекцію tagRecords як джерело даних для цієї галереї. Ця дія встановить властивість Елементи елемента керування Галерея.

   

7. Змініть розташування елемента керування колекції таким чином, щоб вона не перекривала кнопку, і змініть тип макета на Заголовок і підзаголовок.

   

8. Змініть формулу Заголовок в елементі керування галереєю на ThisItem.Value і змініть формулу Підзаголовок в елементі керування галереєю на ThisItem.ID.

   Також можна видалити NextArrow з елемента керування галереєю, оскільки він не використовується.

9. Збережіть та опублікуйте програму.

10. Оскільки функцію ReadNFC() не можна використовувати в Power Apps Studio або в браузері, відкрийте програму на мобільному пристрої.

    Чайові

    Відображення програми на мобільному пристрої може зайняти кілька хвилин. Якщо програма не відображається в списку, спробуйте оновити список програм.

11. Виберіть Зчитати позначку NFC і проскануйте позначку. Повторіть процес, щоб додати кілька позначок до колекції.