Pular para o conteúdo principal

NFC Write

Compose e grave mensagens NFC, ou realize operações avançadas em tags (dependendo do dispositivo).

Compose: comece a partir das Tags Salvas, importe/exporte via QR ou adicione registros.
Mensagem Importada Pronta: grave uma mensagem NDEF importada como está.
Avançado: copiar, apagar, bloquear, formatar ou multi-gravação.

Visão geral​

O NFC Write permite criar uma mensagem NDEF (um conjunto de registros) e gravá-la em uma tag NFC compatível. Também inclui uma aba Avançado para operações como copiar, apagar, bloquear, formatar e multi-gravação (dependendo do dispositivo e da tag).

Sumário​

Abas​

  • Compose
  • Avançado

Aba Compose​

Compose é onde você constrói o que deseja gravar:

  • Tags Salvas: abra sua biblioteca de tags salvas e escolha Gravar agora ou Carregar no composer.
  • Importar QR: importe dados NFC de um código QR.
  • Exportar QR: exporte a mensagem atual como um código QR (quando existir uma mensagem).
  • Adicionar Registro: adicione um ou mais registros à mensagem.

Dependendo do seu estado, o Compose pode mostrar:

  • Um estado vazio (nenhum registro adicionado ainda)
  • Uma lista de registros (quando registros existem)
  • Uma visualização de mensagem importada (quando dados QR importados fornecem uma substituição completa da mensagem)

Tipos de Registro​

Ao adicionar um registro, você pode escolher tipos comuns compatíveis com NDEF:

  • Texto: texto simples com código de idioma opcional.
  • URL: um site (ou link de app).
  • Email: endereço de email (opcionalmente com assunto).
  • Número de Telefone: um número de telefone.
  • SMS: número de telefone e corpo de mensagem opcional.
  • Contato (vCard): campos simples de cartão de contato (nome, telefone, email). Inclui um botão Adicionar dos Contatos que importa dados do app Contatos do iOS.
  • Wi-Fi: SSID da rede, senha e tipo de segurança (Nenhuma, WPA/WPA2 ou WEP).
  • Localização: latitude e longitude (codificados como um URI geo:). Inclui um botão Usar Localização Atual e um seletor de mapa interativo onde você pode tocar para selecionar coordenadas.
  • Dados Personalizados: um payload personalizado simples (tratado como texto).

Adicionar Registro​

Toque em Adicionar Registro para abrir uma grade de 2 colunas com blocos de tipos de registro, cada um mostrando um ícone, nome e descrição. Selecione um tipo para inserir seus detalhes.

Adicionar Registro: escolha um tipo de registro.
Detalhes do registro: insira os dados para codificar na tag.

Após adicionar registros, o Compose mostra uma lista onde você pode:

  • Tocar em um registro para editá-lo.
  • Deslizar para excluir registros.
  • Ver um tamanho estimado total da mensagem e limpar todos os registros.

Mensagem Importada (Modo Importação QR)​

Quando você importa dados NFC de um código QR, o NFC Write muda para o modo Mensagem Importada:

  • A lista de registros composta é limpa para evitar mistura de formatos.
  • Aparece o estado Mensagem Importada Pronta.
  • Gravar grava a mensagem NDEF importada como está até que você limpe a mensagem importada.

Use Visualizar Dados Importados para inspecionar os bytes brutos dos registros (tipo/identificador/payload) antes de gravar.

Importar e Exportar QR​

Use a importação/exportação via QR para transferir mensagens NFC entre dispositivos ou compartilhar uma mensagem composta.

Exportar Código QR: escaneie em outro dispositivo para importar no NFC Read/Write.

Gravando uma Tag​

Ao tocar em Gravar, o iOS abre a sessão de gravação NFC do sistema. Mantenha a tag NFC próxima ao topo do dispositivo até a operação ser concluída.

Se ocorrer um erro, o Lirum exibe uma folha detalhada com seções para: Resumo, Contexto, Motivo da Falha, Sugestão de Recuperação, Detalhes Técnicos (domínio, código, userInfo), Informações Adicionais, Erros Subjacentes, Descrição para Debug e Erro Bruto. Um botão Copiar para Área de Transferência permite compartilhar o erro completo para solução de problemas.

Aba Avançado​

Avançado inclui operações como:

  • Copiar Tag: leia uma tag e duplique seus dados NDEF em outra tag.
  • Apagar Tag: apague os dados NDEF (deixe a tag em branco).
  • Bloquear Tag: proteja permanentemente a tag contra gravações futuras (dependente da tag).
  • Formatar Tag: inicialize uma tag para o formato NDEF (dependente da tag).
  • Copiar para Múltiplas Tags: grave continuamente os mesmos dados em várias tags (fluxo multi-gravação).

Essas operações são executadas pela sessão NFC do sistema e podem não ser suportadas por todos os tipos de tag.

Copiar para Múltiplas Tags (Multi-Gravação)​

O modo multi-gravação ajuda quando você deseja gravar a mesma mensagem em muitas tags. Enquanto ativo, o cartão de status mostra um rótulo “Ativo” com um spinner, contadores de sucesso/falha, texto de feedback da última gravação, um botão Parar e um botão Redefinir Contadores.

A aba Avançado também oferece uma operação Copiar para Múltiplas Tags que lê uma tag fonte uma vez e depois grava continuamente seu conteúdo em tags subsequentes. Isso é distinto da multi-gravação baseada no compose, que usa sua mensagem composta.

Multi-gravação: repita a mesma gravação em muitas tags com acompanhamento de status.

Notas de Segurança​

  • Operações de Bloquear e formatar/apagar podem ser permanentes. Use-as somente se entender o que sua tag suporta.
  • Comece com uma tag reserva ao experimentar.

Permissões e Requisitos​

  • NFC está disponível apenas em dispositivos e versões de OS suportados.
  • O iOS pode solicitar permissão para NFC na primeira vez que usar o NFC Write.
  • Alguns tipos de registro (por exemplo, auxiliares de Localização) podem requerer permissões adicionais (como Localização) para preencher dados automaticamente.

Notas e Limitações​

  • A disponibilidade do NFC depende do modelo do dispositivo e do sistema operacional.
  • Algumas tags são somente leitura ou não suportam gravação/bloqueio/formatação.
Última atualização em por Rogerio Hirooka