QR 도구
QR 코드 생성
qr-code-generator
QR Code Generator 기능을 Zavilo SDK에서 사용하는 방법입니다. 아래에서 입력 제한, 파라미터, 출력 형식과 지원 모드를 확인할 수 있습니다.
H · Headless
빠른 이동
입력 파일 0출력 파일 1–2
입력
이 Tool이 허용하는 입력 형식과 파일 개수입니다.
| 입력 종류 | data |
|---|---|
| 파일 수 | 0 – 0 |
| 허용 MIME 형식 | 없음 |
파라미터
아래 값은 request.options에 전달합니다.
| 파라미터 | 타입 | 필수 | 기본값 | 허용값 / 범위 | 설명 |
|---|---|---|---|---|---|
content |
string | 필수 | — | — | QR 코드에 넣을 텍스트 또는 URL을 입력합니다. |
size |
integer | 선택 | 512 |
96 – 4096 | 출력 크기를 설정합니다. |
ecc |
enum | 선택 | M |
L | M | Q | H | QR error correction level. A center logo forces H. |
foreground |
string | 선택 | #000000 |
— | QR foreground color as #RRGGBB. |
background |
string | 선택 | #ffffff |
— | QR background color as #RRGGBB. |
format |
enum | 선택 | png |
png | svg | both | 출력 파일 형식을 설정합니다. |
출력
처리가 완료되면 반환되는 결과 형식입니다.
| 출력 종류 | files |
|---|---|
| 파일 수 | 1 – 2 |
| 출력 MIME | image/png, image/svg+xml |
| Metadata | size, ecc, moduleCount, hasLogo, outputBytes |
| ZIP 묶음 | 미지원 |
기본 사용 예제
지원되는 연동 모드를 확인하고 생성된 시작 코드를 바로 복사할 수 있습니다.
Headless
const result = await client.run("qr-code-generator", {
options: { content: "value", size: 512, ecc: "M", foreground: "#000000" }
});
console.log(result.files, result.data, result.metadata);
Embedded
await client.mount({ tool: "qr-code-generator", target: "#zavilo-tool", mode: "embedded" });
이 명세는 실제 SDK 런타임이 사용하는 Tool Definition을 기준으로 자동 생성됩니다.