Share via

Função ReadNFC

  • Artigo

Aplica-se a: Aplicações 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 etiqueta que contenha registos NDEF seja utilizada, mas poderá obter o identificador da etiqueta se estiver disponível algum.

A função ReadNFC só pode ser utilizada em fórmulas de comportamento.

Nota

  • ReadNFC só é suportado quando executa a aplicação numa aplicação móvel nativa, como aplicações iOS e Android. 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. Resultado de NDEFRecords com um registo de exemplo.

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)})))

    Fórmula acima introduzida como a propriedade OnSelect do botão.

    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.

    Origem de dados para galeria selecionada como tagRecords.

  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.

    Esquema da galeria.

  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. Guarde e publique a aplicação.

  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.

    Aplicação em dispositivo móvel com o exemplo de leitura da Etiqueta NFC e o resultado dentro da galeria.