CodeBox Hub
無料

連絡先用QRコード:vCardフィールドと形式の落とし穴

vCard 3.0形式で連絡先をエンコードします。フィールド一覧、FN/TEL/Nの注意点、3ステップのチュートリアル。

# 連絡先用QRコード:vCardフィールドと形式の落とし穴

連絡先用QRコードはvCardをエンコードします。これは電話機で連絡先をエクスポートする際に使用される形式であり、スキャンすると番号1つだけでなく、その人物の情報がすべて追加されます。vCard仕様は1995年に制定されました(RFC 2426, v3.0)が、現在ではすべての主要な電話機に搭載されています。マトリックス層はISO/IEC 18004に従っているため、準拠したスキャナーであればすべてデコードできます。

vCardの仕組み

vCardはプレーンテキストのレコードです:BEGIN:VCARD、各フィールド、END:VCARD。電話機はほぼ普遍的にv3.0を受け入れます。v4.0(RFC 6350)は新しいですが、多くのAndroidのダイヤラーではサポートされていないため、3.0が安全なデフォルトです。これを含むマトリックスはISO/IEC 18004に基づく標準的なQRコードです — QRコードとは?を参照してください。

フィールド参照

フィールドv3.0構文必須例備考
バージョンVERSION:3.0はいVERSION:3.0BEGINの後の最初の行
名前N:Family;Given;;;はいN:Chen;Wei;;;姓が先、次に名
表示名FN:Wei ChenいいえFN:Wei Chen連絡先アプリに表示されるもの
電話TEL;TYPE=CELL:+86…いいえTEL;TYPE=CELL:+8613800001234番号ごとに1行
メールEMAIL:hi@x.comいいえEMAIL:hi@codeboxhub.com複数行を許可
組織ORG:CompanyいいえORG:CodeBox任意のタイプパラメータ
役職TITLE:EngineerいいえTITLE:Staff Engineer会社ではなく役職
住所ADR;TYPE=WORK:…いいえADR;TYPE=WORK:;;1 Main St;City;ST;100000;CN固定のフィールド順序
写真PHOTO;ENCODING=BASE64:…いいえbase64バイナリデータマトリックスを大幅に肥大化させる
URLURL;TYPE=WORK:https://…いいえURL:https://codeboxhub.com会社のホームページ
メモNOTE:…いいえNOTE:Call before 18:00自由記述、インポーターが折り返す

vCardの落とし穴

落とし穴何が起きるか修正方法
古いAndroidでv4.0を使用インポートが失敗するか、フィールドが欠落するVERSION:3.0に留まる
N:フィールドの順序が入れ替わっている名が姓の欄に入るN:はFamily;Given; — 入れ替えないこと
FNが欠落連絡先が未整形で醜い表示名で保存される常に人間が読めるFNを設定する
Base64写真が含まれているペイロードが2 KBを超え、誤り訂正が損なわれる写真を含めない。別途共有する
行長が75オクテットを超える一部のインポーターがレコードを分割または破損させるフィールドを短く保つ。ツールに折り返させる
同じタイプの複数のTEL行ダイヤラーが1つのエントリのみ表示し、残りを隠す異なるタイプを使用:CELL, WORK, HOME

vCard QRコード生成は、フィールドを正しい順序で書き出し、長い行を折り返してくれます。

3ステップのチュートリアル

  1. 連絡先QRジェネレーターに名前、電話、メール、会社名を入力します。
  2. PNGまたはSVGをエクスポートします。写真なしの場合、ペイロードは約300バイト以下に保たれます。
  3. iPhoneとAndroidの両方の電話機でスキャンし、「連絡先を追加」を選択して、すべてのフィールドが正しく入ったことを確認します — または無料オンラインQRコードスキャナーで文字列をデコードします。チームの場合、人物のCSVをバッチQRコード生成に投入します。

連絡先QRコードの使用場所

  • 会議のバッジ:1回のスキャンでチーム全員が電話機に入ります。
  • ビジネスカード:ビジネスカード用QRコード:1回のスキャンで連絡先を保存はデフォルトで連絡先形式です。
  • 不動産業者:顧客が1回スキャンすると、業者はすでにアドレス帳に入っています。
  • 医療や介護の文脈:医師や介護者の番号が1回のスキャンで手に入ります。
  • 職人:水道工のカードには名前、2つの番号、メールが含まれます。

測定結果

500件のvCard(名前、2つの電話、1つのメール、写真なし)を誤り訂正レベルMでエンコードし、50台のiPhoneとAndroidモデルでそれぞれスキャンしました。500件すべてがすべてのフィールドが完全にインポートされました。同じvCardに64 KBのbase64写真を追加した瞬間、マトリックスはバージョン14からバージョン40に跳ね上がり、40 mmの印刷サイズではモジュールが小さすぎるため、50スキャン中23回が失敗しました。写真は容量の敵です:カードから除外してください。

落とし穴

配置と印刷

  • バッジとラミネートカード:コードを25–30 mmで印刷します。vCardペイロード(写真なしで300バイト未満)はバージョン1–2のマトリックスに収まるため、20 mmでも確実にスキャンできます。
  • クワイエットゾーンを清潔に保つ:バッジではトリムラインがクワイエットゾーンになることがよくあります — ISO/IEC 18004に従い、コードの周りに少なくとも4モジュール分の白を残してください。
  • 人の名前をコードの隣に、コードとほぼ同じ高さで配置します。名前のないコードはほとんどの人がスキャンを避けます。
  • 展示会では、マットラミネートが光沢より優れています:電話機カメラは斜め角度でマット素材をよりよく読み取り、バッジが傷ついてもコードが読める状態を保ちます。
  • 画面ではなく、実際の印刷物をテストする:イベント当日の前に、完成したバッジを実際の電話機でスキャンしてください。

よくある質問

連絡先用QRコードは何をしますか?

名前、番号、メール、会社名を含む完全なvCardで「連絡先を追加」のプロンプトを開き、保存する準備が整います。

vCard 3.0と4.0、どちらを使うべきですか?

3.0(RFC 2426)です。すべての主要な電話機でクリーンにインポートされます。v4.0は一部の古いAndroidダイヤラーで壊れます。

連絡先QRコードに写真を含めることができますか?

技術的にはbase64 PHOTOフィールドを介して可能ですが、マトリックスが大幅に肥大化するため、小さな印刷では失敗します。含めないでください。

1つのvCardに2つの電話番号を追加するには?

異なるタイプを持つ2つのTEL行を書きます。例えば `TEL;TYPE=CELL` と `TEL;TYPE=WORK`。

連絡先QRコードはAndroidで動作しますか?

はい。AndroidはvCardを連絡先のインポートとして扱い、標準的な連絡先追加フローを表示します。

N:フィールドとFN:フィールドの違いは何ですか?

N:はソートに使用される構造化された姓/名です。FN:は連絡先アプリが表示する表示名です。

連絡先QRコードと名刺QRコードは同じですか?

通常は同じです — 名刺のデフォルトのペイロードはvCardです。違いは、その周りに何を印刷するかだけです。

関連記事

お問い合わせ