왜 Wi-Fi QR을 쓰나
게스트 Wi-Fi를 안내할 때 가장 흔한 문제는 비밀번호 오타와 대소문자 혼동입니다. Wi-Fi QR은 스캔 한 번으로 SSID·암호·암호화 방식을 기기에 전달하므로, 카운터 설명이나 종이에 적힌 긴 문자열을 줄일 수 있습니다.
urlu는 별도 앱 설치 없이 브라우저에서 Wi-Fi QR을 만들고 PNG·SVG로 저장할 수 있습니다. 같은 설정은 REST API로 반복 생성할 수 있어, 여러 매장·층·행사장마다 다른 SSID를 운영할 때도 유용합니다.
웹에서 만드는 순서
홈의 QR 코드 탭에서 아래 순서로 입력합니다.
- 콘텐츠 타입에서 Wi-Fi를 선택합니다.
- SSID(네트워크 이름)를 정확히 입력합니다. 공백·한글·특수문자도 그대로 반영됩니다.
- 암호화 방식을 선택합니다. 대부분의 공유기는 WPA/WPA2/WPA3이므로 WPA를 고릅니다. WEP는 구형 장비에서만 해당합니다.
- 비밀번호를 입력합니다. 공개 Wi-Fi(암호 없음)라면 암호화를 ‘없음’으로 두면 됩니다.
- 미리보기 QR을 확인한 뒤 PNG 또는 SVG로 저장합니다.
인쇄·부착할 때
테이블 텐트·포스터·입구 스탠드에 붙일 QR은 최소 3cm(약 120px) 이상이면 대부분의 카메라에서 읽힙니다. urlu에서는 size를 512로 두고 PNG를 받으면 인쇄용으로 충분합니다.
오류 복원 레벨(ecc)은 M(기본) 또는 H를 권장합니다. 로고를 QR 중앙에 넣지 않는 것이 좋습니다 — urlu QR은 순수 패턴이라 스캔률이 높습니다.
밝은 배경(흰색·크림색) 위에 검은 QR을 두세요. 유광 코팅은 반사 때문에 실패할 수 있으니 무광 인쇄나 스티커를 고려하세요.
API로 생성하기
프로그램에서 같은 Wi-Fi QR을 반복 만들려면 GET /api/qr에 type=wifi와 ssid, password, encryption 파라미터를 넘깁니다. ssid와 password에 특수문자가 있으면 URL 인코딩해야 합니다.
HTML 문서나 안내 페이지에 `<img src="/api/qr?type=wifi&ssid=…">` 형태로 넣을 수도 있습니다. 여러 매장 QR을 한 페이지에 모으는 방법은 ‘여러 QR 한 페이지’ 가이드를 참고하세요.