Documentação e guia de utilização

Guia de utilização

Abra o aplicativo no computador e no celular. No mesmo Wi-Fi, os aparelhos aparecem um para o outro sozinhos. Em redes diferentes, use uma sala com código ou o pareamento por QR Code. Para pular a introdução, use o endereço com ?sem-intro no final.

Primeiro uso

1. Na primeira abertura, uma introdução de quatro passos pergunta o nome do aparelho, se ele fica visível e quem pode te enviar coisas automaticamente. Você pode pular e rever depois em Configurações › Sobre o projeto › Rever introdução.
2. O nome de fábrica é o que o aparelho realmente é: modelo ou sistema, navegador e o fim do identificador (por exemplo, Windows · Edge · B797). Os navegadores não revelam o nome da máquina. Você pode trocar o nome a qualquer momento.
3. A navegação tem cinco destinos: Compartilhar, Caixa, Atividade, Dispositivos e Configurações, na barra lateral (computador) ou na barra inferior (celular).

Parear por QR Code

1. Abra o aplicativo nos dois aparelhosEm Compartilhar, toque em Parear aparelho.
2. Gere o código em um delesGerar o meu código mostra um QR Code, um link e um texto, com botões para copiar.
3. Leia no outroAponte a câmera do celular para o QR Code (o ERASÓ abre já com o código) ou use Tenho um código ou link e cole o texto. Também dá para ler o QR Code com Ler com a câmera.
4. Devolva a respostaO segundo aparelho mostra um código de resposta. No primeiro, leia-o com Ler com a câmera ou cole-o, e toque em Conectar.

O pareamento dura enquanto as duas páginas ficarem abertas. Para desfazê-lo antes, abra os detalhes do aparelho (ⓘ) e escolha Desfazer pareamento. A câmera só funciona em endereço seguro (HTTPS) e só é usada enquanto você mantém a leitura aberta; as imagens não são gravadas nem enviadas. O código contém endereços de rede: mostre-o só a quem vai parear.

Salas

Sem código, você vê os aparelhos que saem para a internet pelo mesmo Wi-Fi. Com um código de sala, só aparelhos com o mesmo código se enxergam, de qualquer rede. Escolha Criar sala (o código tem 6 letras) e abra o link de convite no outro aparelho, ou digite o código. Em Configurações › Sala é possível copiar o convite e sair da sala. Em redes grandes, como a de uma instituição, o aplicativo avisa que há aparelhos demais e pede uma sala. O código evita encontros por acaso, mas não é uma senha forte: não o divulgue.

Enviar

1. Escolha o que enviarUse os blocos Arquivo, Pasta, Mídia, Texto, Link ou Colar; ou arraste para qualquer lugar da janela; ou cole com Ctrl + V. A bandeja mostra quantos itens e o tamanho total; Editar permite renomear e remover; Limpar esvazia.
2. Escolha o modoUm destino (tocar no aparelho envia) ou Vários (marque aparelhos e use “Enviar para N aparelhos”).
3. Escolha o destinoAs abas Por perto e Favoritos listam os aparelhos. O campo de busca filtra por nome, ID, sistema ou tipo. Buscar novamente consulta o servidor.
4. Aguarde a respostaO destino pode aceitar, recusar ou pedir PIN. Se o aparelho não responder ou sair, o aplicativo mostra o motivo.
5. AcompanheO painel de transferências mostra progresso, velocidade e tempo restante reais; dá para cancelar e, se falhar, “Tentar de novo” ou “Diagnosticar”.

Receber

• O pedido mostra quem envia e o quê (nomes, textos e tamanhos).
• Aceitar (também com Enter) ou Recusar. Esc não recusa, para evitar recusa acidental.
• Antes de aceitar, você pode pular itens e renomear arquivos.
• Textos e links recebidos podem ser copiados, abertos ou salvos na Caixa.
• Os arquivos recebidos são salvos pelo navegador, na pasta de downloads (não há seletor de pasta). Receber vários arquivos pode acionar o aviso “permitir vários downloads”.
• Com Exigir PIN ligado, quem envia precisa digitar o PIN que você definiu; o seu aparelho confere.

Caixa

Escreva, cole um link ou solte um arquivo na área de captura e guarde com o botão ou Ctrl + Enter. Cada item permite copiar, abrir (links), baixar (arquivos), fixar no topo, enviar para… outro aparelho e excluir (com desfazer). A validade dos itens (1, 7 ou 30 dias) é uma opção de Configurações; itens fixados não expiram. A Caixa fica somente neste navegador: limpar os dados do site apaga a Caixa.

Atividade e Dispositivos

• Atividade é o histórico deste aparelho, com busca, filtros e Limpar histórico (os arquivos continuam no disco). A conferência de integridade (CRC32) só é indicada nos recebimentos em que os dois lados a usaram.
• Dispositivos lista os aparelhos que estão na rede ou sala agora e os seus favoritos. O botão ⓘ abre os detalhes, como o identificador completo.

Configurações

Tudo é salvo no navegador e aplicado na hora. A busca no topo filtra as opções. Há quatro temas (Sistema, Claro, Escuro e Alto contraste), controle de animações, nome do aparelho, sala, receber automaticamente, PIN, conferência de integridade, histórico, esconder o painel ao terminar e validade da Caixa.

Diagnóstico de conexão

A tela Diagnóstico verifica o navegador, o servidor, a visibilidade, os aparelhos encontrados e a conexão direta com cada aparelho (com a latência medida). Quando algo falha, mostra o motivo e o que fazer. Redes com “isolamento de clientes”, comuns em Wi-Fi de instituições e de visitantes, impedem a conexão direta mesmo com o servidor funcionando. O botão Copiar relatório gera um texto para enviar à equipe.

Atalhos de teclado

Acessibilidade

O design system define como meta a conformidade com WCAG 2.2 nível AA: contraste calculado para cada par de cores, tema de alto contraste, uso pelo teclado, rótulos de texto além de cor, regiões anunciadas por leitores de tela e respeito à preferência por movimento reduzido. A meta ainda não foi auditada com leitores de tela nem por avaliação independente. Se encontrar uma barreira, avise pelo contato.

Glossário

Aparelho

Celular, tablet, computador ou navegador que tem o ERASÓ aberto.

Servidor

Programa que apresenta os aparelhos uns aos outros e repassa as mensagens iniciais da conexão. Não recebe arquivos nem textos.

Sala

Grupo de aparelhos que usam o mesmo código secreto e, por isso, se enxergam.

Conexão direta

Canal criptografado (WebRTC) aberto entre os dois navegadores, por onde seguem os arquivos e textos.

STUN e TURN

Serviços que ajudam a abrir a conexão direta entre redes diferentes (STUN) ou a retransmiti-la quando ela não abre (TURN).

PIN

Senha curta que quem envia precisa digitar para falar com o seu aparelho.

Recebimento automático

Aceitar pedidos sem perguntar, só de quem você escolher.

Caixa

Seu espaço para guardar textos, links e arquivos neste aparelho.

Atividade

Histórico do que foi enviado e recebido neste aparelho.

Documentação técnica

Os documentos técnicos acompanham o código-fonte, na pasta docs/ do repositório: design system, tokens, inventário de componentes, especificação de movimento, plano de adaptação, relatórios de testes e o guia de hospedagem. O endereço do repositório está em Código-fonte e GitHub.

Limites atuais

• O arquivo recebido fica na memória do navegador até terminar; o limite é de 2 GB por pedido.
• Redes muito restritivas só conectam com um servidor de retransmissão (TURN), que ainda não foi definido.
• O pareamento por código não é guardado: ao fechar uma das páginas, é preciso parear de novo.
• A leitura de QR Code pela câmera exige HTTPS; em um servidor na rede local (http://192.168…), use o link ou o código.
• O endereço sem HTTPS (servidor na rede local) impede o botão “Colar” de ler a área de transferência; Ctrl + V continua funcionando.
• Uma aba por navegador: abrir o ERASÓ em outra aba do mesmo navegador desconecta a primeira.
• Só há português do Brasil.