Modalità manuale
La modalità manuale espone ogni regolazione accettata dal motore. Trovi gli stessi controlli nell'interfaccia dell'editor e nell'API.
I 7 essenziali
Se non cambi nient'altro, questi sono i più importanti:
content: URL o testo da codificare.primaryColor+backgroundColor: devono mantenere un contrasto ≥ 4:1.eccLevel:L/M/Q/H. PredefinitoH.Hè obbligatorio se c'è un logo.moduleShape:square/circle/roundedsquare/diamond/hexagon/dot/cross/star/leaf/pointed/drop.finderOuterShape+finderInnerShape: i 3 pattern agli angoli. Square o roundedsquare per sicurezza; circle / target / double per il design.outputWidth+pixelsPerModule: scegline uno, l'altro viene calcolato.fileFormat:png,jpg,svg,pdf,webp.
Gradiente
{
"foregroundStyle": "linearGradient",
"gradientColors": ["#dcc28a", "#7d4bff"],
"gradientDirection": "diagonal"
}
gradientDirection accetta vertical, horizontal, diagonal, diagonal-reverse, radial o custom (con gradientAngle: 0-360).
Logo
{
"logoUrl": "https://yourbrand.com/logo.svg",
"logoShape": "circle",
"logoSizePercent": 18,
"cleanBehindLogo": true,
"eccLevel": "H"
}
logoSizePercent ha un massimo di 25 per mantenere la correzione degli errori entro limiti recuperabili.
Cornici + testi sovrapposti
{
"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"
}
Combinare tutti e tre (cornice + banner centrale + CTA sotto) è ciò che il motore mostra nel riquadro Biglietto banner della vetrina.
Elenco completo dei parametri
Consulta Riferimento QrConfig. È generato in automatico dagli stessi modelli usati dal motore, quindi è sempre allineato.