vCard QRコード作成

vCard 4.0のレコードの姿

ペイロードはリンクではなく、小さなプレーンテキストの文書です。BEGIN:VCARDとVERSION:4.0で始まり、1行に1つのプロパティをキャリッジリターンとラインフィードで区切って並べ、END:VCARDで閉じます。バージョン4.0はRFC 6350で定義されています。

名前は2つのプロパティが受け持ち、役割が異なります。Nは構造化された名前を5つの決まった順序のスロットに保持し、姓が先頭です。FNはアドレス帳が表示する単一の表示用文字列を保持し、RFC 6350はFNを必須としています。名前がまったくないカードが有効なレコードにならないのは、そのためです。

ADRは7つのコンポーネントを決まった順序で並べた1つのプロパティで、空のコンポーネントにも区切り文字が必要です。私書箱のない住所が、番地の前にセミコロン2つで始まるのはそれが理由です。

• N:山田;花子;;; のあとに FN:山田 花子
• ORG:北門製本所 と TITLE:製造部長
• TEL;TYPE=cell:+819012345678 と TEL;TYPE=work,voice:+81312345678
• ADR;TYPE=work:;;神田錦町3-1;千代田区;東京都;101-0054;日本
• RFC 6350はTELをtel: URIとして型付けしますが、ここで使っている短い素の番号形式は、3.0世代のパーサーが期待する書き方でもあります

連絡先カードのシンボルが大きくなる理由

このページのすべての項目を埋めたカードは、およそ400バイトのテキストになります。一般的なWebリンクの数倍です。レベルHはシンボルのコードワードの約3分の2を誤り訂正に使い、バージョン40では3,706のうち2,430がそれにあたります。それがシンボルの約30パーセントを復元できる根拠です。同時にHは最も格納量が少ないレベルでもあり、バージョン20のグリッドはHで382バイトしか入りません。ここでの既定がMなのはそのためで、同じ情報を目に見えて小さなグリッドに載せられます。

バージョン20は97モジュール幅です。規格が各辺に求める4モジュールのクワイエットゾーンを足すと、端から端まで105モジュールになります。幅25 mmで印刷すると1モジュールは約0.24 mmです。印刷の目安は1モジュールあたり0.4〜0.5 mmを下限としているので、105モジュール分の幅には42〜53 mm程度が必要で、フル記入の連絡先カードを25 mmで刷るのはどちらの数字にも遠く届きません。

コードを小さくしなければならないなら、対処は復元を増やすことではなくバイト数を減らすことです。メモ、2つ目の電話番号、都道府県を落とすだけでペイロードから100バイト前後が消え、バージョンが数段下がることがよくあります。

• アクセント付きの文字やラテン文字以外の文字はUTF-8でエンコードされ、1文字あたり1バイトではなく2〜4バイトかかります
• 中央のロゴはレベルHを強制するため、フル記入のカードにロゴを載せるなら大きめの印刷サイズが必要です
• 1つのシンボルの絶対的な上限は、レベルLで2,953バイトです

バージョン4.0と、それを今も読めるもの

流通しているvCardのバージョンは3つあります。2.1、RFC 2426の3.0、そしてRFC 6350の4.0です。このページが書き出すのは4.0で、現行の仕様であり、文字セットをパラメータ任せにせずエンコーディングをUTF-8と定めているバージョンです。

iOSの連絡先と現行のAndroidの連絡先アプリは、スキャンした4.0のレコードを読み取ります。ただし、それより下では対応が行き渡っていません。古いサードパーティ製の連絡先アプリや企業向けのアドレス帳には2.1や3.0を前提に作られたものがあり、認識できないプロパティを無視するか、レコードごと拒否します。古い端末が大量にある相手に配るなら、1,000枚刷る前に1枚試してください。

レコードの内容は何も検証されません。vCardは入力されたことをそのまま述べるだけなので、スキャンは連絡先を保存する提案であって、その連絡先が本物であることの証明ではありません。どのプラットフォームも、アドレス帳に書き込む前に確認画面を表示します。