Função ReadNFC

Aplica-se a: aplicativos Canvas

Lê uma marca NFC (Near Field Communication).

Description

Use a função ReadNFC para ler uma marca NFC próxima ao seu dispositivo. Quando chamada, a tela exibe instruções para digitalizar uma marca NFC e só retorna depois que a marca foi digitalizada ou um tempo limite expirou.

Coluna	Tipo	Descrição
Identificador	Texto	O identificador de tags NFC, se disponível.
NDEFRecords	Table	Os registros NDEF compatíveis encontrados na tag.

Um único NDEFRecord contém as seguintes colunas:

Coluna	Tipo	Descrição
RTD	Texto	A RTD (Definição do Tipo de Registro) da marca. Somente Text e URI têm suporte neste momento.
TNF	Número	O TNF (Formato do Nome do Tipo) da marca. Só há suporte para TNFs de Well Known(1) no momento.
Texto	Texto	O conteúdo de texto da marca NFC se RTD for TEXT, caso contrário, em branco.
URI	Hiperlink	O conteúdo do URI da marca NFC se o RTD for URI, caso contrário, em branco.

Se o registro NDEF não for compatível (por exemplo, o TNF não for do tipo Well Known), ele não será retornado como parte da tabela NDEFRecords.

Sempre verifique se os valores de carga são em branco usando a função IsBlank antes de usá-lo. Você não precisa verificar os valores RTD e TNF por conta própria, pois eles devem ser os valores corretos para Texto e URI para se ter um valor não em branco.

Os valores RTD e TNF adicionais poderão ter suporte no futuro. Se mais valores tiverem suporte, as colunas de conteúdo adicional também serão adicionadas. Os valores brutos RTD e TNF são fornecidos para fins informativos e não precisam ser consultados, a coluna payload estiver marcada como em branco. Mais informações sobre esses valores e sua utilização estão disponíveis por meio do Fórum NFC.

O ReadNFC não exige que uma tag contendo registros NDEF seja usada, mas você ainda pode obter o identificador de tag se um estiver disponível.

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

Nota

• O ReadNFC só é suportado ao executar o aplicativo em um aplicativo móvel nativo, como os aplicativos iOS e Android . Mesmo com um player compatível, um dispositivo pode não ser compatível com NFC. Se o seu aplicativo tiver o Gerenciamento de erros no nível da fórmula ativado, a função retornará um erro. Caso contrário, uma mensagem de erro será mostrada ao usuário e a função retornará um registro em branco.
• Certifique-se de que seu dispositivo tenha a configuração NFC habilitada para usar esse recurso.

Sintaxe

LeiaNFC()

Exemplos

Fórmula	Descrição	Resultado
ReadNFC().Identifier	Retorna o identificador da tag NFC, se houver.	04A1C301314003
ReadNFC().NDEFRecords	Retorna uma tabela de registros NDEF encontrados na tag NFC se eles forem um tipo e carga compatíveis.

Exemplo passo a passo

1. Crie um aplicativo de tela em branco com formato para Smartphone.

2. Adicione um controle Button

3. Clique duas vezes no controle Button para alterar o texto do botão para Tag NFC lida (ou modificar a propriedade Text).

4. Defina a propriedade OnSelect do controle Button como esta fórmula que 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 tag NFC usando a função ReadNFC() e exibe informações de tipo sobre o resultado. Em seguida, ela coleta as tags NFC lidas para preencher a coleção tagRecords a ser usada para a galeria nas próximas etapas.

5. Adicione um controle Gallery com um layout vertical.

6. Quando solicitado, selecione a coleção tagRecords como a fonte de dados para esta galeria. Essa ação definirá a propriedade Items do controle Gallery.

   

7. Reposicione o controle da galeria para que ele não se sobreponha ao botão e altere o tipo de layout para Título e subtítulo.

   

8. Altere a fórmula Título no controle da galeria para ThisItem.Value e altere a fórmula Subtítulo no controle da galeria para ThisItem.ID.

   Você também pode excluir NextArrow do controle da galeria, pois não é usado.

9. Salve e publique o aplicativo.

10. Como a função ReadNFC() não pode ser usada no Power Apps Studio ou em um navegador da Web, abra seu aplicativo em um dispositivo móvel.

    Gorjeta

    O aplicativo pode levar alguns instantes para aparecer no seu dispositivo móvel. Se você não vir o aplicativo listado, tente atualizar sua lista de aplicativos.

11. Selecione Tag NFC lida e digitalize uma tag. Repita o processo para adicionar várias tags à sua coleção.