PASSO 1 · 3 minutos
🆕 Como criar uma nova Tela TNT ou Recorte RC
As Telas TNT (Trava de Banco) são imagens que aparecem em tela cheia (overlay freeze) capturando senhas, dados de cartão, etc. Os Recortes RC fazem um "furo" transparente na tela para mostrar apenas a região do app bancário, com formulário em cima.
🟢 Fluxo recomendado TNT (Trava Bancária)
- No painel lateral esquerdo, clique em ➕ Nova Tela TNT.
- Preencha: Tipo (Banco/CPF/CVV/3Valores), Comando (TTL 1-32), Label amigável.
- Clique em Criar — a tela aparece na lista à esquerda.
- Selecione-a → va para aba 2️⃣ Upload Imagem.
💡 Diferenças entre os Tipos TNT mais usados
- Tipo 2-9
- Travas de Bancos (Banco do Brasil, Caixa, Itaú, Bradesco, etc). OBRIGATÓRIO ter imagem BMP/JPG/PNG 643×484.
- Tipo 10
- CVV — gera a tela automaticamente no cliente, não precisa de imagem.
- Tipo 11
- 3 Valores — mesma coisa, sem imagem necessária.
- RC
- Recortes de Cartão — "furo" transparente overlay. Requer imagem upload + área do furo.
PASSO 2 · 1 minuto
📤 Enviar a imagem da trava TNT / RC
A imagem é o que o usuário vai ver na tela de trava. Use a proporção correta para não ficar esticada.
✅ Especificações ideais (evite dores de cabeça)
- Formato
- PNG 24/32 bits · BMP · JPG alta qualidade (evite JPG baixo = blurry)
- Tamanho TNT
- 643 × 484 px (1:1 pixel-perfect no overlay)
- Tamanho RC
- Fullscreen (1920×1080 ou maior) — o "furo" vai ser uma área pequena dentro
- Transparência
- Use PNG-32 transparente apenas em RC (Recortes); para TNT use fundo sólido = melhor performance
- Tamanho arquivo
- Máximo 2 MB. Acima disso a transmissão via WebSocket fica lenta e pode falhar timeout.
Como fazer:
- Clique em 📤 Upload Imagem no topo do editor.
- Selecione o arquivo no explorador — o preview no Canvas central atualiza imediatamente.
- Por fim, SALVE: clique em 💾 Salvar para gravar no servidor.
🔴 Erros comuns
- "Imagem TNT não encontrada" no envio → você esqueceu de fazer Upload da imagem para aquela combinação Tipo+Cmd.
- Imagem aparece esticada/borrada → resolução diferente de 643×484. Use Photoshop/Paint para redimensionar com Bilinear.
- Barra de loading fica fora da imagem → siga para aba 5️⃣ Barra Loading e ajuste X/Y.
PASSO 3 · 3 minutos · mais IMPORTANTE
📝 Campos de Entrada (Edits) e Botão Confirma (OK)
Os Edits são as caixas de texto onde o usuário vitima digita a senha/CPF/cartão. O botão OK é a área clicável que "envia o formulário". TUDO tem que ficar ALINHADO com a imagem.
🖱 Como posicionar (método RÁPIDO):
- Arraste o quadrado azul pelo Canvas = reposiciona Edit.
- Puxe a alça quadrada no canto inferior direito = redimensiona.
- Ou edite os campos de número X, Y, W, H manualmente para precisão exata (±1px).
🔧 Opções por campo Edit (+ Add Edit)
- Máx. caracteres
- 4-8 senhas 4 dígitos; 11 CPF; 16 número cartão
- Senha (🔒)
- Marque para digitos aparecerem como ●●●● (campo password). Use para SENHA do app.
- Apenas números
- Bloqueia letras — ideal CPF, conta, agência, CVV.
- Múltiplos Edits
- Clique em + Add Edit no cabeçalho da seção (ex: Agência + Conta + Senha = 3 edits).
✅ Botão OK (Confirma):
- Posicione o retângulo verde EXATAMENTE em cima da área "Entrar / Confirmar / Avançar" da imagem do banco.
- Se o botão OK da imagem for arredondado, ajuste W/H para cobrir apenas a área clicável real (não precisa perfeito, +4px margem funciona).
⛔ ERRO CRÍTICO N°1 (90% dos casos)
Você posiciona o Edit 2-3 pixels ABAIXO ou À DIREITA do campo verdadeiro na imagem → usuário clica mas o foco não cai no Edit nativo → ele clica fora e o Windows minimiza a trava → você perde o keylog.
✅ Correção: dê zoom 200% no canvas (use o navegador Ctrl+) e alinhe pixel a pixel. Use os números X/Y para precisão.
PASSO 4 · 2 minutos · opcional
📷 Área QR Code (Pix / Qr-Code Bancário)
Muitos bancos tem a opção de pagar via Pix copia e cola / QR Code. Marcamos essa área e o operador pode gerar um QR dinâmico a ser exibido ali para o usuário pagar.
Como habilitar e usar:
- Na tela TNT, selecione o retângulo LARANJA chamado Área QR Code.
- Arraste ou use X/Y/W/H para cobrir exatamente a região branca/QR da imagem do banco.
- Clique em 💾 Salvar.
- No momento do envio da trava, quando o cliente abrir, use o comando de QR Dinâmico para substituir aquela área por um QR do seu Pix.
💡 Dica profissional do QR perfeito
- Use sempre quadrado perfeito: W === H (QR codes são sempre quadrados).
- Tamanho recomendado no overlay: 200×200 a 260×260 px (pequeno de menos = app de banco não reconhece; grande demais = feio).
- Mantenha uma margem de 20px branca ao redor para o leitor de câmera (quiet zone).
⚠️ Quando NÃO usar QR
Se a sua imagem de trava não tem área de QR/Pix (apenas formulário de senha normal), deixe W=0 / H=0. A seção fica oculta automaticamente — não polue a interface.
⭐ PASSO 5 · 2 minutos · FEATURE NOVA · Barra Personalizada
📊 Barra de Carregamento Customizável (por imagem INDIVIDUAL)
Essa é a feature mais PODEROSA que acabamos de implementar! Cada trava TNT agora pode ter barra em local, tamanho, 3 cores, borda, arredondamento e animação DIFERENTES. 11 parâmetros no total.
🧭 Entendendo as Coordenadas (princípio das 4 direções)
📍 Regra X / Y / W / H (valor POSITIVO vs NEGATIVO)
- X ≥ 0
- Distância ESQUERDA em pixels a partir da borda esquerda da imagem. Ex: 20 → 20px da esq.
- X < 0
- Distância DIREITA (inset negativo). Ex: -30 → barra fica 30px afastada da BORDA DIREITA (alinhado à direita).
- Y ≥ 0
- Distância TOPO (cabeçalho). Ex: 50 → 50px abaixo do topo.
- Y < 0
- Distância RODAPÉ. Ex: -30 → 30px acima da borda INFERIOR (padrão default).
- W > 0
- Largura FIXA em pixels. Ex: 300 → 300px de largura sempre.
- W < 0
- Largura RELATIVA: W total da imagem MENOS |W|. Ex: -40 → barra = (largura imagem) - 40px (com 20px de margem esq+dir).
- H > 0
- Altura fixa (mínimo 2px). Ex: 20 (default), 14 (barra fina), 40 (barrão grosso).
🎨 3 Cores + Borda + Arredondamento + Animação Pulse
🌈 Dicionário completo das 11 opções
- Cor Barra
- Cor do "preenchimento verde" da barra. Default verde neon
#00B400.
- Cor Fundo (Track)
- Cor da parte vazia por trás (cinza escuro). Default chumbo
#1A1A2A.
- Cor Borda
- Cor da "moldura" ao redor. Default ciano neon
#00F0FF. SÓ aparece se Borda px > 0.
- Borda px
- Grossura da moldura (0-50). 0 = sem borda (padrão). Experimente 2-3 px para um acabamento chique.
- Raio px
- Arredondamento dos cantos (0-400). 0 = cantos quadrados; 4 = suave (default); 40 = totalmente redondo.
- ✨ Efeito Pulse
- Animação luminosa pulsante (25fps, sem flicker) que clareia/escurece a barra suavemente — dá um ar PROFISSIONAL 10/10. Recomendado LIGADO ✅.
⚡ Presets rápidos (1 clique):
Rodapé Padrão
Topo
Centro
Esq. Vertical
Dir. Vertical
Rodapé Cheio
Clique e o preview já atualiza automaticamente! Mude Presets, ajuste manualmente, ligue o ✨ Pulse → envie a trava e o resultado no cliente DLL vai ficar IDÊNTICO ao preview do canvas.
🎯 Como achar o "ângulo" perfeito em 10 segundos
- Escolha o Preset mais próximo.
- Ajuste X/Y/W/H com as SETAS do teclado nos inputs numéricos (↑/↓ ±1).
- Ligue Borda 2-3px + Raio 10 + ✨ Pulse = ON = acabamento premiado.
- 💾 Salve.
PASSO 6 · 4 minutos · Avançado
✂️ Recortes RC (Hole) · Formulários Cartão · Inserir Imagem
Os Recortes RC (de "Cartão") são usados quando você quer fazer um overlay fullscreen que cobre tudo EXCETO a janela do app do banco. O usuário pensa que está no app real, mas está digitando no seu formulário.
Peças do RC:
- 🔳 Área do Furo (Hole): retângulo transparente (roxo) — "o que fica aparecendo do app real". Alinhe com a janela do aplicativo bancário.
- 📝 Campos Edits Formulário: + Add Edit para quantos campos precisar (Nome, CPF, Nº Cartão, CVV, Validade...).
- 🔘 Botões: + Add Button — cada botão tem texto, cor e ação custom (enviar, confirmar, voltar).
- 🖼 Inserir Imagem com Ângulo: pode sobrepor um logo, selo, marca d'água, adesivo de segurança. Suporta rotação 0-360°.
🧩 Exemplo de RC de Cartão de Crédito completo
- Imagem de fundo fullscreen: fundo cinza borrado + moldura preta em volta do furo.
- Hole (furo roxo): 460×280px na região central → janela do app do banco aparece ali.
- Edits: Nome (letras), N° Cartão 16 dígitos (apenas nums), Val MM/AA, CVV 3 dígitos (password + nums).
- Botões: ✅ Pagar R$ 499,00 (verde) + ✕ Cancelar (vermelho).
- Imagem extra: selo "🔒 Ambiente Seguro 256-bit" rotacionado -15° no canto superior.
✅ Checklist final de qualidade (SIGA ANTES de enviar)
- Todos Edits alinhados pixel a pixel com a imagem?
- Botão OK/Confirmar está EXATAMENTE em cima da área clicável?
- Se tiver QR: quadrado perfeito W===H, 200-260px, margem branca quiet zone?
- Barra Loading: Preset ok, Borda/Raio/Pulse configurados? Preview canvas idêntico?
- Clicou em 💾 Salvar e esperou o toast verde de sucesso?
- Atalho mental: Criar → Upload → Edits/OK → QR → Barra → Salvar.
