CodeBox Hub
무료

이벤트용 QR 코드: vEvent 필드 및 캘린더 함정

vEvent 형식으로 이벤트를 휴대폰 캘린더에 추가하세요: 필드 표, UID/DURATION 함정 및 3단계 튜토리얼.

# 이벤트용 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 필드 참조

필드구문필수예시비고
VersionVERSION:2.0예VERSION:2.0vCalendar 2.0 라인
UIDUID:unique@host예UID:conf-42@codeboxhub.com이벤트별로 고유해야 함
DTSTAMPDTSTAMP:20260801T090000Z예DTSTAMP:20260801T090000Z생성 시간, UTC
SUMMARYSUMMARY:Keynote아니오SUMMARY:Keynote캘린더에 표시되는 제목
DTSTARTDTSTART;TZID=...:…아니오*DTSTART:20260801T090000*대부분의 휴대폰에서 필수
DTENDDTEND:…아니오DTEND:20260801T103000종일 이벤트: 생략하고 VALUE=DATE 사용
LOCATIONLOCATION:Hall B아니오LOCATION:Hall B, Center일반 텍스트, 지오코딩 없음
DESCRIPTIONDESCRIPTION:Agenda inside아니오DESCRIPTION:Agenda inside줄바꿈은 \n으로 이스케이프
URLURL:https://…아니오URL:https://conf.example/동반 페이지 또는 등록 링크
STATUSSTATUS:CONFIRMED아니오STATUS:CONFIRMEDTENTATIVE / 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단계 튜토리얼

  1. 이벤트 QR 생성기에 제목, 날짜, 시간, 위치 및 메모를 입력하세요.
  2. PNG 또는 SVG로 내보내세요; 일반적인 세션의 경우 페이로드는 약 250바이트 미만으로 유지됩니다.
  3. 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에 유지하세요.

자주 묻는 질문

이벤트용 QR 코드는 무엇을 하나요?

제목, 시간, 위치 및 메모가 포함된 캘린더 이벤트를 휴대폰 캘린더에 추가하도록 제안합니다.

이벤트 QR 코드는 어떤 형식을 사용하나요?

vEvent, RFC 5545로 정의된 vCalendar 계열 — "이벤트 추가" 링크에서 휴대폰이 가져오는 것과 동일한 데이터입니다.

이벤트 QR 코드는 종일일 수 있나요?

예. VALUE=DATE와 함께 날짜 전용 DTSTART를 사용하고 시간을 생략하세요; 종일 필드에 시간을 혼합하지 마세요.

QR 코드로 반복 이벤트를 만들 수 있나요?

단일 vEvent는 하나의 발생입니다; 반복에는 VRECUR 또는 발생별 개별 코드가 필요합니다.

이벤트 QR 코드는 iPhone 및 Android에서 작동하나요?

예. 두 캘린더 모두 vEvent를 네이티브로 가져오고 표준 이벤트 추가 프롬프트를 표시합니다.

왜 일부 캘린더가 내 이벤트를 병합하나요?

공유 UID 때문입니다. 각 이벤트는 고유한 UID가 필요하며, 그렇지 않으면 클라이언트가 이를 하나로 취급합니다.

이벤트 QR은 연락처 QR과 어떻게 다른가요?

vEvent는 시간 블록이 있는 약속을 추가하고, vCard는 주소록에 사람을 추가합니다.

계속 읽기

문의하기