CodeBox Hub
無料

イベント用QRコード:vEventフィールドとカレンダーの落とし穴

vEvent形式でイベントをスマホのカレンダーに追加します。フィールド一覧、UID/DURATIONの落とし穴、3ステップのチュートリアルを解説。

# イベント用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フィールド参照

フィールド構文必須例備考
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が重複カレンダーが更新を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ステップのチュートリアル

  1. イベントQRジェネレーターにタイトル、日付、時刻、場所、メモを入力します。
  2. PNGまたはSVGをエクスポートします。典型的なセッションではペイロードは約250バイト未満です。
  3. 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に保持してください。

よくある質問

イベント用QRコードは何をしますか?

タイトル、時刻、場所、メモ付きのカレンダーイベントをスマートフォンのカレンダーに追加するよう提案します。

イベント用QRコードはどの形式を使用しますか?

vEvent、RFC 5545で定義されたvCalendarファミリー — スマートフォンが「イベントを追加」リンクからインポートするのと同じデータです。

イベント用QRコードは終日に対応できますか?

はい。VALUE=DATE付きの日付のみDTSTARTを使用し、時刻を省略してください。終日フィールドに時刻を混在させないでください。

QRコードで定期イベントを作成できますか?

単一のvEventは1回の発生です。繰り返しにはVRECURか発生ごとに別のコードが必要です。

イベント用QRコードはiPhoneとAndroidで動作しますか?

はい。両方のカレンダーはvEventをネイティブでインポートし、標準的なイベント追加プロンプトを表示します。

なぜ一部のイベントがマージされるのですか?

UIDの共有です。各イベントには独自の一意のUIDが必要で、そうでなければクライアントがそれらを1つとして扱います。

イベント用QRコードと連絡先QRコードの違いは何ですか?

vEventは時間枠付きの予定を追加し、vCardはアドレス帳に人物を追加します。

関連記事

お問い合わせ