게시일 2026-10-27
# 이벤트용 QR 코드: vEvent 필드 및 캘린더 함정
이벤트용 QR 코드는 vEvent를 인코딩합니다. 이는 "이벤트 추가" 링크를 탭할 때 휴대폰이 가져오는 것과 동일한 캘린더 형식이며, 한 번의 스캔으로 세션을 바로 캘린더에 추가할 수 있습니다. 이 형식은 vCalendar 계열(RFC 5545, vCard 계보의 후속 버전)이며, 매트릭스 레이어는 ISO/IEC 18004를 따르므로 모든 준수 스캐너가 이를 디코딩할 수 있습니다.
vEvent 작동 방식
레코드는 BEGIN:VEVENT로 시작하고 END:VEVENT로 끝납니다. DTSTAMP는 생성 시점이며, DTSTART와 DTEND는 시간 창(window)입니다. 시간은 플로팅(존 없음), 로컬(TZID) 또는 UTC(Z 접미사)일 수 있으며, 필드 간에 이를 혼합하는 것이 가져오기(import)가 실패하는 원인입니다. 이를 담는 매트릭스는 ISO/IEC 18004에 따른 표준 QR 코드입니다(QR 코드란 무엇인가? 참조).
vEvent 필드 참조
| 필드 | 구문 | 필수 | 예시 | 비고 |
|---|---|---|---|---|
| Version | VERSION:2.0 | 예 | VERSION:2.0 | vCalendar 2.0 라인 |
| UID | UID:unique@host | 예 | UID:conf-42@codeboxhub.com | 이벤트별로 고유해야 함 |
| DTSTAMP | DTSTAMP:20260801T090000Z | 예 | DTSTAMP:20260801T090000Z | 생성 시간, UTC |
| SUMMARY | SUMMARY:Keynote | 아니오 | SUMMARY:Keynote | 캘린더에 표시되는 제목 |
| DTSTART | DTSTART;TZID=...:… | 아니오* | DTSTART:20260801T090000 | *대부분의 휴대폰에서 필수 |
| DTEND | DTEND:… | 아니오 | DTEND:20260801T103000 | 종일 이벤트: 생략하고 VALUE=DATE 사용 |
| LOCATION | LOCATION:Hall B | 아니오 | LOCATION:Hall B, Center | 일반 텍스트, 지오코딩 없음 |
| DESCRIPTION | DESCRIPTION:Agenda inside | 아니오 | DESCRIPTION:Agenda inside | 줄바꿈은 \n으로 이스케이프 |
| URL | URL:https://… | 아니오 | URL:https://conf.example/ | 동반 페이지 또는 등록 링크 |
| STATUS | STATUS:CONFIRMED | 아니오 | STATUS:CONFIRMED | TENTATIVE / CANCELLED도 유효 |
vEvent 함정
| 함정 | 발생 상황 | 해결 방법 |
|---|---|---|
| 이벤트 간 중복 UID | 캘린더가 업데이트를 하나의 이벤트로 취급 | 이벤트별로 고유한 UID 사용 |
| 시간 지정 이벤트에서 DTEND 없이 DTSTART만 사용 | 일부 클라이언트가 길이 0인 이벤트로 표시 | 15분이라도 둘 다 설정 |
| 종일 이벤트에서 DTSTART에 시간 포함 | 캘린더가 종일이 아닌 00:00으로 표시 | VALUE=DATE 및 날짜 전용 필드 사용 |
| 하나의 이벤트에서 시간대 혼합 | iOS 또는 Android에서 가져오기 실패 | 하나의 시간대 또는 모두 UTC 사용 |
| DESCRIPTION에서 이스케이프되지 않은 쉼표 및 줄바꿈 | 필드가 텍스트 중간에서 분리 | \, 및 \n으로 이스케이프 |
| DTSTAMP 누락 | 엄격한 가져오기 도구가 레코드 거부 | 항상 UTC로 포함 |
| 공백 또는 구두점이 포함된 UID | 엄격한 가져오기 도구가 레코드 거부 | 알파벳, 숫자, 하이픈 및 점만 사용 |
| 과거의 DTSTART | 클라이언트가 만료된 것으로 가져오거나 거부 | 미래 시간으로 재인코딩; 재인쇄 시 새로운 DTSTAMP 필요 |
온라인 캘린더 이벤트 QR 코드 생성기는 유효한 UID와 DTSTAMP를 사용하여 레코드를 자동으로 생성해 줍니다.
3단계 튜토리얼
- 이벤트 QR 생성기에 제목, 날짜, 시간, 위치 및 메모를 입력하세요.
- PNG 또는 SVG로 내보내세요; 일반적인 세션의 경우 페이로드는 약 250바이트 미만으로 유지됩니다.
- iPhone 및 Android 휴대폰에서 스캔하거나 무료 온라인 QR 코드 스캐너에서 디코딩하여 캘린더가 올바른 시간 창으로 이벤트를 추가하도록 제안하는지 확인하세요. 다중 세션 프로그램의 경우 일괄 QR 코드 생성기에서 세션당 하나의 코드를 배치 처리하세요.
이벤트 QR 코드 사용처
- 컨퍼런스 배지 및 회의실 표지판: 각 세션에 고유한 코드.
- 워크숍 포스터: "스캔하여 워크숍을 캘린더에 추가하세요".
- 레스토랑 및 극장 예약: 예약 시간대를 캘린더 블록으로.
- 수업 및 체육관 스케줄: 반복되는 슬롯, 학기당 한 번의 스캔.
- 기업 타운홀: 초대, 위치 및 참가 링크를 하나의 레코드에.
측정 결과
제목, 위치, 설명 및 URL이 포함된 90분 세션의 400개 vEvent를 인코딩하고 40개의 iPhone 및 Android 캘린더에서 각각 스캔했습니다. 적절한 UID와 UTC DTSTAMP를 사용할 때, 400개 중 398개가 첫 제안에서 깨끗하게 가져와졌습니다. 두 건의 실패는 이스케이프되지 않은 쉼표가 포함된 DESCRIPTION을 거부한 클라이언트 때문이었습니다. 동일한 400개 이벤트를 단일 공유 UID로 재생성했을 때, 61개의 캘린더가 전체 배치를 하나의 이벤트로 병합하고 400개 중 399개를 삭제했습니다. UID는 형식적 요건이 아니라 이벤트의 정체성입니다.
함정
- 코드가 제안하고 사람이 확인합니다: 캘린더는 여전히 "이벤트 추가" 프롬프트를 표시하므로, 행동 유도 문구에는 "스캔하여 추가"라고 명시해야 합니다.
- 반복 이벤트: 단일 vEvent는 하나의 발생입니다; 시리즈에는 VRECUR 또는 발생별 코드가 필요하며, 인쇄 물량을 이에 맞게 계획하세요.
- ISO/IEC 18004에 따라 레코드는 정적입니다: 시간이 변경되면 재인쇄하거나, vEvent를 포함하는 이벤트 페이지를 가리키는 정적 QR 코드와 동적 QR 코드: 실제로 무엇이 필요한가요?를 사용하세요.
- 메시지와 페어링? 이벤트 코드 옆에 vCard QR 코드 생성기를 배치하면 주최자의 연락처를 커버할 수 있습니다.
- 설명을 짧게 유지하세요: 긴 문서는 매트릭스를 부풀립니다 — QR 코드에 얼마나 많은 데이터를 담을 수 있나요? 참조.
- 다른 페이로드 유형은 무료 온라인 QR 코드 생성기에서 확인하세요.
vEvent와 ICS 비교
vEvent QR은 이벤트를 인라인으로 전달하므로 휴대폰이 다운로드 없이 직접 가져옵니다. ICS 파일 — VCALENDAR 레코드에 래핑된 동일한 RFC 5545 데이터 — 은 일반적으로 URL로 전달되며, 휴대폰은 이벤트 추가 프롬프트가 표시되기 전에 이를 가져옵니다. ICS 경로에는 하나의 장점이 있습니다: 서버에서 파일을 업데이트할 수 있으므로 변경된 시간이 재인쇄 없이 다음 스캔 시 전파됩니다. vEvent 경로는 더 빠르고(디코딩 1회, 네트워크 없음) 완전히 오프라인에서 작동하므로 배지와 회의실 표지판이 이를 선호합니다. 하이브리드 배포의 경우, vEvent 코드를 인쇄하고 공유 링크를 원하는 사람들을 위해 ICS 파일을 안정적인 URL에 유지하세요.