Ручний режим

Ручний режим відкриває всі налаштування, які приймає рушій. Ті самі елементи керування є в інтерфейсі редактора і в API.

7 найважливіших параметрів

Якщо більше нічого не змінювати, найбільше важать ось ці:

content — URL або текст для кодування.
primaryColor + backgroundColor — контраст має бути ≥ 4:1.
eccLevel — L / M / Q / H. За замовчуванням H. Якщо є логотип, H обов’язковий.
moduleShape — square / circle / roundedsquare / diamond / hexagon / dot / cross / star / leaf / pointed / drop.
finderOuterShape + finderInnerShape — 3 кутові шаблони. Для надійності — square або roundedsquare; для дизайну — circle / target / double.
outputWidth + pixelsPerModule — задайте одне, друге обчислиться.
fileFormat — png, jpg, svg, pdf, webp.

Градієнт

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

gradientDirection приймає vertical, horizontal, diagonal, diagonal-reverse, radial або custom (разом із gradientAngle: 0-360).

Логотип

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

logoSizePercent обмежено значенням 25, щоб корекція помилок лишалася в межах, які ще можна відновити.

Рамки й текстові накладки

{
  "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"
}

Поєднання всіх трьох (рамка + банер у центрі + CTA знизу) — саме те, що рушій демонструє на плитці Квиток із банером у вітрині.

Повний список параметрів

Див. Довідник QrConfig. Він автоматично генерується з тих самих моделей, які використовує рушій, тож завжди актуальний.