Ferramentas de texto e do dia a dia · Kit de ferramentas de QR e código de barras
Como os telefones decidem o que significa um código QR: URL, WIFI:, mailto: e tel:
· Como funciona
código QR codificação privacidade
Um código QR armazena apenas texto; esta postagem explica as convenções de carga útil – URLs, WIFI:, mailto:, tel:, MECARD e vCard – que os aplicativos de câmera reconhecem, com as strings exatas a serem digitadas.
É tudo apenas texto – por que um código QR não tem ideia de que contém uma senha de Wi-Fi e como o aplicativo de digitalização infere a intenção da string
Uma matriz QR carrega bytes; o significado vem do texto decodificado e do aplicativo de scanner. Os construtores de carga útil de ToolAcre tornam esse texto explícito, retornando a carga útil e notas ou avisos para que as transformações sejam visíveis em vez de ocultadas silenciosamente.
A forma de retorno do construtor ajuda a expor esta separação. Ele fornece a carga exata, notas informativas sobre transformações e avisos sobre escolhas arriscadas. A IU pode, portanto, dizer que adicionou `https://`, normalizou um número de telefone ou escapou da pontuação em vez de mostrar apenas um quadrado finalizado. Quando outro telefone se comporta de maneira diferente, a string bruta se torna um artefato de teste que pode ser decodificado e comparado sem adivinhar o que o formulário pretendia.
URLs e esquemas — http, https, mailto:, tel: e sms:, e por que o prefixo do esquema decide qual aplicativo abre
Um prefixo convencional dá ao scanner uma dica de ação: https pode abrir um navegador, mailto pode preparar e-mail, tel pode oferecer uma chamada e o construtor SMS do kit de ferramentas usa uma carga útil SMSTO. As solicitações reais ainda dependem do aplicativo de digitalização.
ToolAcre codifica por cento assuntos e corpos de e-mail para que caracteres como `#`, `&` e quebras de linha permaneçam dentro de seus valores de consulta em vez de se tornarem separadores URI. As cargas úteis do telefone mantêm dígitos e uma vantagem inicial enquanto removem espaços de formatação. Estas são regras de construção de carga útil, não promessas de que cada dispositivo fará uma chamada ou abrirá um compositor automaticamente; o scanner e o sistema operacional ainda escolhem a ação.
O formato WIFI: — os campos T, S, P e H, o ponto e vírgula duplo final e como escapar de ponto e vírgula e barras invertidas em senhas
ToolAcre grava valores de Wi-Fi como campos WIFI para tipo de autenticação, SSID, senha e status oculto, terminando com ponto e vírgula duplo. Ele escapa de barras invertidas, ponto e vírgula, dois pontos, vírgulas e aspas, portanto a pontuação não pode encerrar um campo antecipadamente.
Um caso concreto de Wi-Fi é `Café;Visitors` com uma senha contendo dois pontos e barra invertida. O construtor prefixa os caracteres reservados com barras invertidas e relata que ocorreu escape. Ele também cita um SSID de aparência hexadecimal de comprimento par para que os leitores não reinterpretem o nome como bytes codificados. Se a segurança não for `nopass` e a senha estiver em branco, o painel avisa em vez de inventar uma credencial.
Cartões de contato: ToolAcre produz vCard 3.0 e não gera MECARD
O esboço contrasta MECARD com vCard, mas este kit de ferramentas implementa apenas vCard 3.0. Seu construtor escapa da pontuação vCard, emite campos de contato e evita intencionalmente a dobra de linha porque o repositório documenta problemas de compatibilidade em scanners populares.
O construtor vCard começa com `BEGIN:VCARD` e `VERSION:3.0`, grava componentes de nomes estruturados separadamente e termina com `END:VCARD`. Ele normaliza o campo do telefone e evita vírgulas, ponto e vírgula, barras invertidas e novas linhas quando necessário. Uma organização pode substituir o nome de uma pessoa desaparecida, mas um número de telefone por si só não produz cartão porque não há uma identidade de exibição significativa.
Texto simples e cargas desconhecidas — o que uma câmera faz com uma string que ela não reconhece
Se um scanner não reconhecer uma convenção de carga útil, ele ainda poderá apresentar o texto decodificado. Essa alternativa é a razão pela qual a inspeção da carga útil bruta é útil: a geração pode garantir bytes e escape, não a interface de um aplicativo de câmera específico.
Uma carga desconhecida permanece útil como texto somente se a pessoa puder entendê-la. Um scanner que não reconhece `SMSTO:` ou vCard pode mostrar a string completa, incluindo caracteres de escape e rótulos de campo. Isso é uma falha de compatibilidade, em vez de uma codificação QR corrompida. Preserve um substituto legível ou teste os aplicativos exatos da câmera quando a ação desejada for mais importante do que simplesmente recuperar os bytes.
Exemplo resolvido - escrever manualmente uma carga útil de Wi-Fi de convidado e um cartão de contato, gerando ambos e digitalizando com dois telefones diferentes
Crie um convidado SSID como Café;Visitors e uma senha contendo dois pontos ou barra invertida e, em seguida, inspecione a string WIFI com escape. Para um contato, use os campos vCard do kit de ferramentas e compare a carga útil; MECARD foi omitido deliberadamente porque não foi implementado.
Crie um cartão Wi-Fi e um cartão de contato a partir de exemplos ricos em pontuação, decodifique ambos em telefones compatíveis e compare os valores resultantes com a visualização da carga útil. O adversário do repositório já testa os campos Wi-Fi de ida e volta por meio de um analisador e verifica os delimitadores vCard; o teste de dispositivo adiciona a camada de aplicativo que os testes de unidade não podem representar. MECARD não deve aparecer na comparação porque este kit de ferramentas nunca o cria.
Exemplo resolvido: crie uma carga útil de Wi-Fi e um vCard ToolAcre, não um código MECARD não compatível
Links diretos proprietários, esquemas de pagamento e outros formatos específicos de domínio não são gerados por esses construtores. O codificador QR pode codificar texto arbitrário, mas isso não significa que ToolAcre valide um esquema externo ou garanta que outro aplicativo atuará nele.
Um pagamento personalizado ou uma string de link direto podem ser inseridos como texto simples, mas isso ignora a validação específica do esquema. ToolAcre codificará fielmente dados malformados, assim como codifica texto arbitrário válido. Os painéis de carga suportados agregam valor porque escapam e avisam de acordo com as regras implementadas. Para qualquer esquema proprietário, use suas ferramentas oficiais atuais em vez de tratar a codificação genérica de bytes como conformidade.
Conclusão: digite a carga exata e o QR & Barcode Toolkit a codifica localmente, sem que a senha saia do seu dispositivo
Escolha o painel de carga compatível, inspecione o texto produzido e teste-o com telefones representativos. O QR Code Wi-Fi mantém a construção local e lida com as regras de fuga com maior probabilidade de quebrar credenciais de rede escritas à mão.
Inspecione antes de exportar: confirme o valor bruto visível, leia todos os avisos e teste a ação pretendida. Para Wi-Fi, lembre-se que quem fotografar o código recebe a credencial; para cartões de contato, corte notas longas quando o construtor avisar que a densidade aumentou. A camada QR preserva os bytes preparados, enquanto a escolha correta dos campos e a distribuição segura permanecem de responsabilidade do editor.