Función ReadNFC

  • Artigo

Aplícase a: aplicacións Canvas

Le unha etiqueta de transmisión de datos en proximidade (NFC).

Descripción

Use a función ReadNFC para ler unha etiqueta NFC próxima ao seu dispositivo. Cando se invoca, a pantalla mostra instrucións para dixitalizar unha etiqueta NFC e só devolve despois de que a etiqueta se dixitalizase ou expirase un tempo de espera.

Columna Tipo Descripción
Identificador Mensaxe de texto O identificador das etiquetas NFC se está dispoñible.
NDEFRecords Table Os rexistros NDEF compatibles atopados na etiqueta.

Un único NDEFRecord contén as seguintes columnas:

Columna Tipo Descripción
RTD Mensaxe de texto A definición do tipo de rexistro (RTD) da etiqueta. Só Text e URI son compatibles neste momento.
TNF Número O formato de nome de tipo (TNF) da etiqueta. Neste momento só se admiten TNF de Well Known(1).
Mensaxe de texto Mensaxe de texto A carga de texto da etiqueta NFC se RTD é TEXT, valor en branco en caso contrario.
URI Hiperligazón A carga do URI da etiqueta NFD se RTD é URI, valor en branco en caso contrario.

Se o rexistro NDEF non é compatible (por exemplo, o TNF non é do tipo Well Known), entón non se devolverá como parte da táboa NDEFRecords.

Comprobe sempre os valores da carga para o valor en branco usando a función IsBlank antes de usalo. Non é preciso comprobar os valores RTD e TNF xa que deben ser os valores correctos para que Texto e URI teñan un valor que non estea en branco.

Os valores RTD e TNF adicionais poden ser compatibles no futuro. Se se admiten máis valores, tamén se engadirán columnas de carga adicionais. Os valores orixinais de RTD e TNF fornécense con fins informativos e non é necesario consultalos se se comproba a columna de carga en branco. Hai máis información sobre estes valores e o seu uso no Foro NFC.

ReadNFC non require que se use unha etiqueta que conteña rexistros NDEF, pero aínda así pode obter o identificador da etiqueta se está dispoñible.

ReadNFC só se pode usar en fórmulas de comportamento.

Nota

  • ReadNFC só é compatible cando se executa a aplicación nunha aplicación móbil nativa, como as aplicacións iOS e Android . Aínda cun reprodutor compatible, é posible que un dispositivo non admita NFC. Se a súa aplicación ten Xestión de erros a nivel de fórmula activado, a función devolverá un erro. Do contrario, mostraráselle unha mensaxe de erro ao usuario e a función devolverá un rexistro en branco.
  • Asegúrese de que o seu dispositivo teña activada a configuración NFC para usar esta función.

Sintaxe

ReadNFC()

Exemplos

Fórmula Descripción Resultado
ReadNFC().Identifier Devolve o identificador da etiqueta NFC se existe. 04A1C301314003
ReadNFC().NDEFRecords Devolve unha táboa de rexistros NDEF atopados na etiqueta NFC se son de tipo e carga útil compatibles. Resultado NDEFRecords cun rexistro de exemplo.

Exemplo paso a paso

  1. Cree unha aplicación de lenzo en branco cun formato de Teléfono.

  2. Engada un control de botón.

  3. Faga dobre clic no control do botón para cambiar o texto do botón a Ler etiqueta NFC (ou modifique a propiedade Texto).

  4. Estableza a propiedade OnSelect do control de botón con esta fórmula que engadirá un elemento á nosa colección:

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

    Fórmula anterior introducida como a propiedade OnSelect do botón.

    Esta fórmula le unha etiqueta NFC mediante a función ReadNFC() e mostra información de tipo sobre o resultado. A continuación, recolle as etiquetas NFC lidas para encher a colección tagRecords que se utilizará para a galería nos seguintes pasos.

  5. Engada un control de Galería cun deseño vertical.

  6. Cando se lle solicite, seleccione a colección tagRecords como orixe de datos desta galería. Esta acción axustará a propiedade Items do control de Galería.

    Orixe de datos para a galería seleccionada como tagRecords.

  7. Coloque de novo o control da galería para que non se solape co botón e cambie o tipo de deseño a Título e subtítulo.

    Maquetación da galería.

  8. Cambie a fórmula Título no control da galería a ThisItem.Value e cambie a fórmula Subtítulo no control da galería para ThisItem.ID.

    Tamén pode eliminar a NextArrow do control da galería xa que non se usa.

  9. Garde e publique a aplicación.

  10. Dado que a función ReadNFC() non se pode usar en Power Apps Studio nin nun navegador web, abra a súa aplicación nun dispositivo móbil.

    Propina

    A aplicación pode tardar uns momentos en aparecer no seu dispositivo móbil. Se non ve a aplicación listada, probe a actualizar a lista de aplicacións.

  11. Seleccione Ler etiqueta NFC e escanee unha etiqueta. Repita o proceso para engadir varias etiquetas á súa colección.

    Aplicación no dispositivo móbil co exemplo de lectura da etiqueta NFC e o resultado dentro da galería.