Uma tag NFC de Wi-Fi para iPhone e Android: adicione uma URL alternativa
Crie uma tag NFC de Wi-Fi para iPhone e Android: grave primeiro o registro de Wi-Fi e depois um registro de URL como página alternativa. Veja por que a ordem importa.
Grave primeiro o registro de Wi-Fi e depois um registro de URL
Para uma tag NFC de Wi-Fi que funcione para convidados com iPhone e Android, coloque dois registros em uma só tag: primeiro um registro de Wi-Fi e depois um registro de URL. O Android consegue agir sobre o primeiro. Quem já montou relata que o iPhone ignora o registro de Wi-Fi, então o registro de URL é a porta de entrada dele.
Os dois registros
O registro de Wi-Fi. É um registro NDEF do tipo MIME, com o tipo application/vnd.wfa.wsc. O payload é uma lista de campos de tag/valor. O exemplo da SparkFun mostra que ele começa com o identificador de credencial de Wi-Fi 0x100E, com o nome da rede e a senha guardados como atributos dentro dele. Você não vai montar esses bytes na mão. Para os detalhes de cada campo, veja o registro WSC explicado.
O registro de URL. É um registro de tipo well-known U: um byte de prefixo para coisas como https://www., seguido do restante do endereço. Aponte para uma página sua que mostre o nome da rede e a senha em texto simples, além de um QR code com as mesmas credenciais.
Record 1: MIME application/vnd.wfa.wsc (Wi-Fi credentials)
Record 2: URI https://example.com/wifi (fallback page)
O que o Android faz com a tag
A documentação de despacho de tags do Android diz que o sistema lê o primeiro registro da mensagem para decidir como interpretá-la. Um registro MIME corresponde a um tipo MIME. É por isso que o registro de Wi-Fi vem primeiro.
Há um segundo motivo para a URL não ficar na frente. A partir do Android 16, tags que guardam links http:// ou https:// disparam uma view intent. A partir do Android 17, elas exibem uma notificação de "abrir link" que exige um toque. Um link antes do registro de Wi-Fi significaria abrir o navegador, e não entrar na rede.
Um aviso: a documentação do Android descreve como funciona o despacho. Ela não diz o que as configurações de Wi-Fi de cada fabricante de celular fazem com um registro de Wi-Fi. Teste nos celulares que seus convidados usam.
O que o iPhone faz com a tag
A palestra da Apple sobre Core NFC diz que a leitura de tags em segundo plano funciona com qualquer tag NDEF cuja mensagem inclua um registro de URL. Ela acrescenta que apenas o primeiro registro de URL encontrado é processado. Ou seja, o registro de Wi-Fi na frente não esconde a sua URL. O iPhone sai à procura da URL.
O que acontece depois depende do link. Um Universal Link válido leva ao seu app. Qualquer outro vai para o Safari por padrão. Um endereço web comum, portanto, abre sua página alternativa, que é o que você quer aqui. Saiba mais em leitura de tags em segundo plano.
Do lado do Wi-Fi, quem já montou diz que o iPhone não entra na rede a partir do registro de Wi-Fi. Um desenvolvedor programou uma tag de Wi-Fi que funcionava, descobriu que ela não funciona no iPhone e pediu à Apple que desse suporte. Um relato em fórum com iOS 17.4.1 diz o mesmo. São relatos individuais, não uma declaração da Apple. Veja por que o iPhone não entra sozinho no Wi-Fi por uma tag.
Dois detalhes do iPhone: a leitura em segundo plano exige que o celular tenha sido desbloqueado pelo menos uma vez após a inicialização, e a Apple lista o iPhone XS, XS Max e XR como compatíveis (modelos posteriores também funcionam, segundo o NFC Forum).
Grave e teste
- Grave o registro de Wi-Fi com o nome da rede, o tipo de segurança e a senha.
- Adicione o registro de URL depois dele.
- Leia a tag de volta e confira se o registro de Wi-Fi é o primeiro.
- Aproxime um celular Android e um iPhone, nas versões do sistema que seus convidados usam.
- Verifique se a página alternativa carrega e se a senha nela está correta.
O NFCore, nosso app para iOS e Android, consegue gravar os dois registros em uma só tag, então você não precisa de dois apps. Baixe na App Store ou no Google Play.
Qualquer pessoa que encostar na tag pode ler a senha. Use uma rede de convidados, não a sua rede principal.
Resumindo
Registro de Wi-Fi primeiro, registro de URL depois. O Android vê o primeiro registro, o iPhone encontra a URL, e seus convidados ficam com a senha de qualquer jeito.
Perguntas frequentes
O iPhone consegue entrar no Wi-Fi direto de uma tag NFC?
Quem já montou relata que ele não oferece a opção de entrar a partir de um registro de Wi-Fi, enquanto um registro de URL funciona. Não encontramos nenhuma declaração da Apple sobre isso, então teste na sua versão do iOS.
A ordem dos registros importa?
Sim. O Android usa o primeiro registro para decidir como tratar a tag. O iPhone processa o primeiro registro de URL que encontra na mensagem.
É seguro colocar a senha do Wi-Fi em uma tag?
Qualquer pessoa que encostar nela pode ler a senha. Use uma rede de convidados e troque a senha se a tag for perdida.