vCard連絡先のQRコードを生成する

vCard連絡先用QRコード

vCard QRコードはvCardフォーマット（VCFとも呼ばれる）で連絡先情報をエンコードします。スキャンすると、デバイスがユーザーに連絡先をアドレス帳に直接保存するよう促します。

vCard 3.0フォーマット

最も広くサポートされているバージョンはvCard 3.0です。一般的なvCard構造は以下の通りです：

BEGIN:VCARD
VERSION:3.0
N:田中;太郎;;;
FN:田中太郎
ORG:テック株式会社
TITLE:ソフトウェアエンジニア
TEL;TYPE=WORK,VOICE:+81-3-1234-5678
TEL;TYPE=CELL:+81-90-1234-5678
EMAIL:taro.tanaka@example.com
URL:https://tanaka.dev
NOTE:DevConf 2025で知り合い
END:VCARD

サポートされるフィールド

フィールド	説明	例
N	構造化された名前（姓;名;ミドル;接頭辞;接尾辞）	N:田中;太郎;;;
FN	表示名	FN:田中太郎
ORG	組織	ORG:テック株式会社
TITLE	役職	TITLE:CTO
TEL	タイプ付き電話番号	TEL;TYPE=CELL:+8190...
EMAIL	メールアドレス	EMAIL:name@example.com
URL	Webサイト	URL:https://...
ADR	住所	ADR;TYPE=WORK:;;...
NOTE	自由テキストメモ	NOTE:キーコンタクト

データサイズの考慮事項

複数の電話番号、住所、メモが含まれると、vCardはすぐに大きくなります。確実なスキャンのためにvCard全体を500文字以下に抑えてください。不要なオプションフィールドは削除してください。

写真の埋め込み

vCardはBase64エンコードされた PHOTO フィールドによる埋め込み写真をサポートしていますが、これによりQRコードのサイズが劇的に増加するため、QRコードでの使用は一般的に実用的ではありません。代わりに連絡先の写真へのURLを含めてください。

プラットフォーム互換性

• iOS — ネイティブカメラアプリがvCard QRコードを認識し、事前入力されたフォームで連絡先アプリを開きます。
• Android — ほとんどのカメラアプリとQRスキャナーがvCardインポートをサポートしています。一部の古いデバイスではサードパーティスキャナーが必要な場合があります。
• デスクトップ — スキャンアプリは通常vCardを.vcfファイルとして保存し、メールクライアントにインポートできます。