Pular para o conteúdo

Modo manual

O modo manual expõe todos os controles que o motor aceita. Você encontra os mesmos controles na interface do editor e na API.

Os 7 essenciais

Se você não mudar mais nada, estes são os que mais importam:

  1. content — URL ou texto a codificar.
  2. primaryColor + backgroundColor — devem manter contraste ≥ 4:1.
  3. eccLevel — L / M / Q / H. Padrão H. H é obrigatório se houver logo.
  4. moduleShape — square / circle / roundedsquare / diamond / hexagon / dot / cross / star / leaf / pointed / drop.
  5. finderOuterShape + finderInnerShape — os 3 padrões dos cantos. Square ou roundedsquare para segurança; circle / target / double para design.
  6. outputWidth + pixelsPerModule — escolha um; o outro é calculado.
  7. fileFormat — png, jpg, svg, pdf, webp.

Degradê

{
  "foregroundStyle": "linearGradient",
  "gradientColors": ["#dcc28a", "#7d4bff"],
  "gradientDirection": "diagonal"
}

gradientDirection aceita vertical, horizontal, diagonal, diagonal-reverse, radial ou custom (com gradientAngle: 0-360).

{
  "logoUrl": "https://yourbrand.com/logo.svg",
  "logoShape": "circle",
  "logoSizePercent": 18,
  "cleanBehindLogo": true,
  "eccLevel": "H"
}

logoSizePercent tem limite de 25 para manter a correção de erros dentro de margens recuperáveis.

Molduras + textos sobrepostos

{
  "frame": {
    "enabled": true,
    "color": "#3d2a14",
    "width": 6,
    "cornerRadius": 14,
    "padding": 18,
    "shape": "rectangle"
  },
  "centerText": {
    "text": "ADMIT ONE",
    "color": "#3d2a14",
    "backgroundColor": "#f5ecd2",
    "height": 28,
    "fontSize": 13,
    "bold": true
  },
  "ctaText": "Scan to enter"
}

A combinação dos três (moldura + faixa central + CTA abaixo) é o que o motor demonstra no card Banner ingresso da vitrine.

Lista completa de parâmetros

Veja a Referência de QrConfig. Ela é gerada automaticamente a partir dos mesmos modelos que o motor usa, então está sempre sincronizada.