Споделяне чрез

Функция ReadNFC

  • Статия

Отнася се за: Приложения за платно

Чете маркер за комуникация в близко поле (NFC).

Описание

Използвайте ReadNFC функция за четене на NFC маркер, който е близо до вашето устройство. При извикване екранът показва инструкции за сканиране на NFC маркер и се връща само след като маркерът е сканиран или изтече времето за изчакване.

Колона Тип Описание
Идентификатор Текстово съобщение Идентификаторът на NFC тагове, ако е наличен.
NDEFRecords Table Поддържаните NDEF записи, намерени в етикета.

Единичен NDEFRecord съдържа следните колони:

Колона Тип Описание
RTD Текстово съобщение Дефиницията на маркера тип на записа (RTD). Само Text и URI се поддържат в момента.
TNF Число Формат на името на типа на маркера (TNF). В момента се поддържат само TNF от Well Known(1).
Текстово съобщение Текстово съобщение Текстовият полезен товар на NFC маркера, ако е RTD TEXT, празно в противен случай.
URI Хипервръзка Полезен товар на URI на NFC маркера, ако RTD е URI, празно в противен случай.

Ако NDEF записът не се поддържа (например TNF не е от тип Well Known), тогава той няма да бъде върнат като част от NDEFRecords таблица.

Винаги проверявайте стойностите на полезния товар за празно, използвайки IsBlank функция преди да я използвате. Не е необходимо да проверявате RTD и TNF оценявате себе си, тъй като те трябва да са правилните стойности за Текст и URI да има различна от празно стойност.

Допълнителни RTD и TNF стойности може да се поддържат в бъдеще. Ако се поддържат повече стойности, ще бъдат добавени и допълнителни колони с полезен товар. Суровите RTD и TNF стойности са предоставени за информационни цели и не е необходимо да се консултират, ако се провери за колоната с полезен товар празно. Повече информация за тези стойности и тяхното използване е достъпна чрез NFC форума.

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

ReadNFC може да се използва само във формули за поведение.

Бележка

  • ReadNFC се поддържа само когато се изпълнява приложението в собствено мобилно приложение, като например приложенията iOS и Android Дори с поддържан плейър, устройството може да не поддържа NFC. Ако вашето приложение има управление на грешки на ниво формула включено, функцията ще върне грешка. В противен случай на потребителя ще бъде показано съобщение за грешка, а функцията ще върне празен запис.
  • Уверете се, че настройката за NFC на вашето устройство е активирана, за да използвате тази възможност.

Синтаксис

ReadNFC()

Примери

Формула Описание Резултат
ReadNFC().Identifier Връща идентификатора на NFC тага, ако такъв съществува. 04A1C301314003
ReadNFC().NDEFRecords Връща таблица с NDEF записи, намерени в NFC етикета, ако те са поддържан тип и полезен товар. NDEFRecords резултат с примерен запис.

Пример стъпка по стъпка

  1. Създайте празно приложение за платно с формат на телефон.

  2. Добавете контрола Бутон.

  3. Щракнете двукратно върху бутона за управление, за да промените текста на бутона Четене на NFC етикет (или да модифицирате свойството Текст).

  4. Задайте свойството OnSelect на контрола с бутони към тази формула, който ще добави артикул към нашата колекция:

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

    Горната формула е въведена като свойство OnSelect на бутона.

    Тази формула чете NFC таг с помощта на ReadNFC() функцията и показва информация за типа за резултата. След това събира прочетените NFC тагове, за да попълни tagRecords колекцията, която да се използва за галерията в следващите стъпки.

  5. Добавете Галерия контрол с вертикално оформление.

  6. Когато бъдете подканени, изберете tagRecords колекция като източник на данни за тази галерия. Това действие ще зададе свойството Елементи на контролата галерия.

    Източник на данни за галерия, избран като tagRecords.

  7. Преместете контролата на галерията, така че да не припокрива бутона, и променете типа на оформлението на Заглавие и подзаглавие.

    Оформление на галерията.

  8. Променете формулата Title в контролата на галерията на ThisItem.Value и променете Субтитри формула в контрола на галерията до ThisItem.ID.

    Можете също да изтриете NextArrow от контролата на галерията, тъй като не се използва.

  9. Запазете и публикувайте приложението.

  10. Тъй като функцията ReadNFC() не може да се използва в Power Apps Studio или в уеб браузър, отворете приложението си на мобилно устройство.

    Бакшиш

    Приложението може да отнеме няколко минути, за да се появи на вашето мобилно устройство. Ако не виждате приложението в списъка, опитайте да опресните списъка си с приложения.

  11. Изберете Прочетете NFC етикет и сканирайте етикет. Повторете процеса, за да добавите множество тагове към вашата колекция.

    Приложение на мобилно устройство с пример за четене на NFC етикет и резултата в галерията.