Função ReadNFC

Aplica-se a: Aplicativos de tela

Lê uma etiqueta de comunicação de campo próximo (NFC).

Description

Utilize a função ReadNFC para ler uma etiqueta NFC que esteja próxima do seu dispositivo. Quando invocado, o ecrã apresenta instruções para digitalizar uma etiqueta NFC e só regressa depois de a etiqueta ter sido digitalizada ou atinge o tempo limite.

Coluna	Tipo	Descrição
Identificador	Texto	O identificador de etiquetas NFC, se disponível.
NDEFRecords	Table	Os registos NDEF suportados encontrados na etiqueta.

Um único NDEFRecordcontém as seguintes colunas:

Coluna	Tipo	Descrição
RTD	Texto	Definição de tipo de registo da etiqueta (RTD). Neste momento, apenas Texto e URI são suportados.
TNF	Número	O formato de nome tipo da etiqueta (TNF). Neste momento, só TNFs de Bem Conhecidos(1) são suportados.
Texto	Texto	O payload de texto da etiqueta NFC se RTD for TEXTO, caso contrário em branco.
URI	Ligação	O payload da etiqueta URI se o RTD for URI, caso contrário em branco.

Se o registo NDEF não for suportado (por exemplo, o TNF não for do tipo Bem Conhecido), não será devolvido como parte da tabela NDEFRecords.

Verifique sempre os valores de payload para em branco utilizando a função IsBlank antes de a utilizar. Não é necessário verificar os valores de RTD e TNF, pois devem ser os valores corretos para que Texto e URI tenham um valor não em branco.

Os valores adicionais de RTD e TNF podem ser suportados no futuro. Se forem suportados mais valores, serão também adicionadas colunas de payload adicionais. Os valores RTD e TNF não processados são fornecidos para fins informativos e não precisam de ser consultados se a coluna de payload for ativada para em branco. Mais informações sobre estes valores e a respetiva utilização estão disponíveis no Fórum NFC.

ReadNFC não requer uma tag contendo registros NDEF para ser usada, mas você ainda pode obter o identificador de tag se estiver disponível.

ReadNFC só pode ser usado em fórmulas de comportamento.

Nota

• ReadNFC só é suportado ao executar o aplicativo em um aplicativo móvel nativo, como o iOS e Android apps. Mesmo com um leitor suportado, um dispositivo pode não suportar NFC. Se a aplicação tiver a Gestão de erros ao nível da fórmula ativada, a função irá obter um erro. Caso contrário, será mostrada uma mensagem de erro ao utilizador e a função irá obter um registo em branco.
• Certifique-se de que o dispositivo tem a definição NFC ativada para utilizar esta capacidade.

Sintaxe

ReadNFC()

Exemplos

Fórmula	Descrição	Resultado
ReadNFC().Identifier	Obtém o identificador da etiqueta NFC, se existir um.	04A1C301314003
ReadNFC().NDEFRecords	Obtém uma tabela de registos NDEF encontrados na etiqueta NFC, se forem do tipo e payload suportados.

Exemplo passo a passo

1. Crie uma aplicação de tela em branco com o formato Telefone.

2. Adicionar um controlo de Button.

3. Clique duas vezes no controlo button para alterar o texto do botão para Ler Etiqueta NFC (ou modificar a propriedade Text).

4. Defina a propriedade OnSelect do controlo button como esta fórmula que irá adicionar um item à nossa coleção:

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

   

   Esta fórmula lê uma etiqueta NFC utilizando a função ReadNFC() e apresenta as informações de tipo sobre o resultado. Em seguida, recolhe as etiquetas NFC lidas para preencher a coleção tagRecords a ser utilizada para a galeria nos passos seguintes.

5. Adicione um controlo Gallery com um esquema vertical.

6. Quando lhe for pedido, selecione a coleção tagRecords como a origem de dados para esta galeria. Esta ação irá definir a propriedade Items do controlo Gallery.

   

7. Reposicione o controlo gallery para que não se sobreponha ao botão e altere o tipo de esquema para Título e legenda.

   

8. Altere a fórmula de Título no controlo gallery para ThisItem.Value e altere a fórmula de Legenda no controlo gallery para ThisItem.ID.

   Também pode eliminar o NextArrow do controlo gallery, uma vez que este não é utilizado.

9. Salve e publique o aplicativo.

10. Uma vez que a função ReadNFC() não pode ser utilizada no Power Apps Studio ou num browser, abra a aplicação num dispositivo móvel.

    Gorjeta

    A aplicação poderá demorar alguns momentos a aparecer no seu dispositivo móvel. Se não vir a aplicação listada, experimente atualizar a sua lista de aplicações.

11. Selecione Ler Etiqueta NFC e digitalize uma etiqueta. Repita o processo para adicionar várias etiquetas à sua coleção.