Saltar al contenido

Modo manual

El modo manual expone todos los controles que acepta el motor. Encontrarás los mismos en la interfaz del editor y en la API.

Los 7 imprescindibles

Si no tocas nada más, estos son los que más importan:

  1. content: URL o texto que se codifica.
  2. primaryColor + backgroundColor: deben mantener un contraste ≥ 4:1.
  3. eccLevel: L / M / Q / H. Por defecto, H. Es obligatorio H si hay logo.
  4. moduleShape: square / circle / roundedsquare / diamond / hexagon / dot / cross / star / leaf / pointed / drop.
  5. finderOuterShape + finderInnerShape: los 3 patrones de las esquinas. Square o roundedsquare para ir sobre seguro; circle / target / double para diseñar.
  6. outputWidth + pixelsPerModule: elige uno y el otro se calcula.
  7. fileFormat: png, jpg, svg, pdf, webp.

Degradado

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

gradientDirection acepta vertical, horizontal, diagonal, diagonal-reverse, radial o custom (con gradientAngle: 0-360).

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

logoSizePercent tiene un máximo de 25 para que la corrección de errores se mantenga dentro de márgenes recuperables.

Marcos y textos superpuestos

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

Combinar los tres (marco + banda central + CTA debajo) es lo que muestra el motor en la tarjeta Banner ticket del escaparate.

Lista completa de parámetros

Consulta la referencia de QrConfig. Se genera automáticamente a partir de los mismos modelos que usa el motor, así que siempre está sincronizada.