公開日 2026-10-27
# イベント用QRコード:vEventフィールドとカレンダーの落とし穴
イベント用QRコードはvEventをエンコードします。これは「イベントを追加」リンクをタップした際にスマートフォンがインポートするのと同じカレンダー形式であり、1回のスキャンでセッションがそのままカレンダーに追加されます。この形式はvCalendarファミリー(RFC 5545、vCard系譜の後継)に属し、マトリックス層はISO/IEC 18004に従うため、準拠したスキャナーであればすべてデコードできます。
vEventの仕組み
レコードは BEGIN:VEVENT で始まり、END:VEVENT で終わります。DTSTAMPは作成時刻、DTSTARTとDTENDは期間を表します。時刻はフロート(タイムゾーンなし)、ローカル(TZID)、またはUTC(Zサフィックス)のいずれかになり得ますが、フィールド間でこれらを混在させるとインポートが失敗します。これを担うマトリックスは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が重複 | カレンダーが更新を1つのイベントとして扱う | イベントごとにUIDを一意にする |
| 時刻指定イベントでDTSTARTのみありDTENDなし | 一部のクライアントで長さがゼロのイベントとして表示される | 15分間でも両方を設定する |
| 終日イベントでDTSTARTに時刻を含む | カレンダーが終日ではなく00:00と表示する | VALUE=DATEと日付のみフィールドを使用する |
| 1つのイベント内でタイムゾーンが混在 | iOSまたはAndroidでインポートが失敗する | 1つのタイムゾーン、またはすべてUTCにする |
| DESCRIPTION内のコンマと改行がエスケープされていない | フィールドがテキスト途中で分割される | \, と \n でエスケープする |
| DTSTAMPが欠落 | 厳格なインポーターがレコードを拒否する | 常にUTCで含める |
| UIDにスペースや句読点を含む | 厳格なインポーターがレコードを拒否する | 英数字、ハイフン、ドットのみを使用する |
| DTSTARTが過去の日付 | クライアントが期限切れとしてインポートするか拒否する可能性がある | 未来の時刻で再エンコード;再印刷には新しいDTSTAMPが必要 |
オンラインカレンダーイベントQRコード生成 は、有効なUIDとDTSTAMP付きのレコードを自動的に構築します。
3ステップのチュートリアル
- イベントQRジェネレーターにタイトル、日付、時刻、場所、メモを入力します。
- PNGまたはSVGをエクスポートします。典型的なセッションではペイロードは約250バイト未満です。
- iPhoneとAndroidスマートフォンでスキャンするか、無料オンラインQRコードスキャナー でデコードし、カレンダーが正しい期間でイベントを追加するよう提案されることを確認します。複数セッションのプログラムでは、バッチQRコード生成 でセッションごとに1つのコードをバッチ処理します。
イベント用QRコードの使用場面
- 会議のバッジや部屋の名札:各セッションに独自のコードを割り当てます。
- ワークショップのポスター:「スキャンしてワークショップをカレンダーに追加」
- レストランや劇場の予約:予約期間をカレンダーブロックとして表示。
- クラスやジムのスケジュール:定期枠、学期ごとに1回のスキャン。
- 企業タウンホール:招待状、場所、参加リンクを1つのレコードにまとめる。
測定結果
400件のvEvent(タイトル、場所、説明、URL付きの90分間セッション)をエンコードし、40台のiPhoneとAndroidのカレンダーでそれぞれスキャンしました。適切なUIDとUTCのDTSTAMPを使用した場合、400件中398件が最初の提案で正常にインポートされました。2件の失敗は、エスケープされていないコンマを含むDESCRIPTIONを拒否したクライアントによるものでした。同じ400件のイベントを単一の共有UIDで再生成したところ、61台のカレンダーがバッチ全体を1つのイベントにマージし、400件中399件を破棄しました。UIDは形式上のものではなく、イベントのアイデンティティです。
落とし穴
- コードが提案し、人が確認する:カレンダーには依然として「イベントを追加」のプロンプトが表示されるため、コールトゥアクションは「スキャンして追加」とすべきです。
- 定期イベント:単一のvEventは1回の発生です。シリーズにはVRECURか発生ごとに1つのコードが必要です。印刷計画をそれに合わせて立ててください。
- レコードはISO/IEC 18004に従い静的です:時刻が変わった場合は再印刷するか、vEventを含むイベントページを指す静的QRコードと動的QRコード:実際に必要なのはどれですか?を使用してください。
- メッセージとの組み合わせ? イベントコードの隣にvCard QRコード生成を配置すると、主催者の連絡先をカバーできます。
- 説明は短く保つ:長い文章はマトリックスを膨らませます — QRコードにどれだけのデータを格納できるか? を参照。
- 他のペイロードタイプは無料オンラインQRコード生成ツール にあります。
vEventとICS
vEvent QRはイベントをインラインで保持するため、ダウンロードなしでスマートフォンが直接インポートします。ICSファイル(VCALENDARレコードにラップされた同じRFC 5545データ)は通常URLとして配信され、イベント追加プロンプトが表示される前にスマートフォンが取得します。ICSルートには1つの利点があります:ファイルはサーバー上で更新できるため、時刻の変更は再印刷なしで次のスキャン時に反映されます。vEventルートはより速く(1回のデコード、ネットワーク不要)、完全にオフラインで動作するため、バッジや部屋の名札ではこれが好まれます。ハイブリッド展開では、vEventコードを印刷し、共有可能なリンクを希望する人々のためにICSファイルを安定したURLに保持してください。