Share via


Funció ReadNFC

S'aplica a: Aplicacions de llenç

Llegeix una etiqueta de comunicació de camp proper (NFC).

Descripció

Utilitzeu la funció ReadNFC per llegir una etiqueta NFC que sigui a prop del dispositiu. Quan s'invoca, la pantalla mostra les instruccions per escanejar una etiqueta NFC i només retorna quan l'etiqueta s'ha escanejat o s'esgota el temps d'espera.

Columna Tipus Descripció
Identificador SMS L'identificador d'etiquetes NFC si està disponible.
NDEFRecords Table Els registres NDEF compatibles que es troben a l'etiqueta.

Un sol NDEFRcord conté les columnes següents:

Columna Tipus Descripció
RTD SMS La definició del tipus de registre (RTD) de l'etiqueta. Només Text i URI són admeses en aquest moment.
TNF Nombre Format de nom de tipus (TNF) de l'etiqueta. Només s'admeten els TNF de Well Known(1).
SMS SMS La càrrega de text de l'etiqueta NFC si RTD és TEXT, en blanc altrament.
URI Enllaç La càrrega URI de l'etiqueta NFC si RTD és URI, en blanc altrament.

Si el registre NDEF no està admes (per exemple, el TNF no és de tipus Well Known), no es tornarà com a part de la taula NDEFRecords.

Comproveu sempre els valors de càrrega de càrrega en blanc utilitzant la funció IsBlank abans d'utilitzar-la. No heu de comprovar els valors RTD i TNF, ja que han de ser els valors correctes perquè Text i URI tinguin un valor no en blanc.

En el futur, és possible que s'admetin valors RTD i TNF addicionals. Si s'admeten més valors, també s'afegiran més columnes de càrrega. Els valors RTD i TNF es proporcionen amb finalitats informacionals i no s'han de consultar si la columna de càrrega es comprova per trobar espais en blanc. Més informació sobre aquests valors i el seu ús està disponible a través del Fòrum NFC.

ReadNFC no necessita que s'utilitzi una etiqueta que contingui registres NDEF, però encara podeu obtenir l'identificador d'etiqueta si n'hi ha una de disponibles.

ReadNFC només es pot utilitzar a les fórmules de comportament.

Nota

  • ReadNFC només s'admet quan s'executa l'aplicació en una aplicació mòbil nativa, com ara les iOS aplicacions i Android . Fins i tot amb un reproductor compatible, és possible que un dispositiu no admeti l'NFC. Si la vostra aplicació té activada l'administració d'errors de nivell de fórmula, la funció retornarà un error. Altrament, es mostrarà un missatge a l'usuari i la funció retornarà un registre en blanc.
  • Assegureu-vos que el dispositiu té la configuració NFC habilitada per utilitzar aquesta capacitat.

Sintaxi

ReadNFC()

Exemples

Fórmula Descripció Resultat
ReadNFC().Identifier Retorna l'identificador de l'etiqueta NFC si existeix. 04A1C301314003
ReadNFC().NDEFRecords Retorna una taula de registres NDEF que es troben a l'etiqueta NFC si són un tipus i una càrrega compatibles. Resultat NDEFRecords amb un registre d'exemple.

Exemple pas a pas

  1. Creeu una aplicació de llenç en blanc amb el format Mòbil.

  2. Afegiu un control Botó.

  3. Feu doble clic al control de botó per canviar el text del botó per Llegeix l'etiqueta del NFC (o bé, modifiqueu la propietat Text).

  4. Definiu la propietat OnSelect del control de botó en aquesta fórmula que afegirà un element a la nostra col·lecció:

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

    La fórmula anterior introduïda com la propietat OnSelect del botó.

    Aquesta fórmula llegeix una etiqueta NFC utilitzant la funció ReadNFC() i mostra informació de tipus sobre el resultat. A continuació, recopila les etiquetes NFC de lectura per emplenar la col·lecció tagRecords que s'utilitzarà per a la galeria en els passos següents.

  5. Afegeix un control Galeria amb una disposició vertical.

  6. Quan se us demani, seleccioneu la col·lecció tagRecords com a font de dades per a aquesta galeria. Aquesta cció definirà la propietat Items del control Galeria.

    Font de dades per a la galeria seleccionada com a tagRecords.

  7. Reubica el control de la galeria de tal manera que no superposi el botó i canvieu el tipus de disposició al títol i subtítol.

    Disposició de la galeria.

  8. Canvieu la fórmula del títol del control de la galeria a ThisItem.Value i canvieu la fórmula de subtítol del control de galeria a ThisItem.ID.

    També podeu suprimir NextArrow del control de la galeria des que no s'utilitza.

  9. Deseu i publiqueu l'aplicació.

  10. Com que la funció ReadNFC() no es pot utilitzar al Power Apps Studio o al navegador web, obriu l'aplicació en un dispositiu mòbil.

    Propina

    L'aplicació pot trigar uns quants moments a mostrar-se al dispositiu mòbil. Si no veieu l'aplicació a la llista, proveu d'actualitzar la llista d'aplicacions.

  11. Seleccioneu Lectura de l'etiqueta NFC i escanegeu una etiqueta. Repetiu el procés per afegir diverses etiquetes a la col·lecció.

    App en dispositiu mòbil amb l'exemple de lectura d'etiquetes NFC i el resultat dins de la galeria.