Wi-Fi・連絡先・リンクのQRコードを作成し、印刷前に確認

静的コードを選ぶということ

QRコードには2種類あり、その違いは見た目だけのものではありません。静的コードには、URL、Wi-Fiレコード、連絡先カードといった内容そのものが入ります。動的コードには、プロバイダーに属する短いリンクが入り、プロバイダーが現在指定している場所へリダイレクトします。

動的コードには、印刷後に宛先を変更できることと、すべてのスキャンを数えられることという2つの利点があります。その一方で、販売ページではほとんど明示されない負担もあります。すべてのスキャンが第三者を経由し、その第三者に見られ、コードを使い続けられるかどうかも決められます。プロバイダーが料金体系を変更したり、製品を終了したり、事業をやめたりすると、窓に貼ったステッカーは機能しなくなり、対処する方法はありません。これは繰り返し、大規模に起きています。

ここで生成したコードは、ダウンロードした時点で完成しています。リダイレクトも、カウンターも、アカウントも、関係もありません。appvau.ltは1回のスキャンにも関与しません。それでも壊れる可能性があるのは、コードのリンク先です。リンクは404になり、パスワードは変更され、電話番号は再割り当てされます。この区別のどちら側にある生成サービスでも、その点は解決できません。

エンコード前にペイロードを表示する理由

QRシンボルは、作成した本人には中身が見えません。パターンを見ても、URLのスキームが抜けていること、ラベルからコピーしたSSIDの末尾に空白が入っていること、電話番号に国番号がないことは分かりません。問題が発見されるのはいつも後で、すでに印刷されたものに誰かが携帯電話をかざしたときです。

そこでこのツールは、まず正確な正規化文字列を表示します。シンボルに入る文字列であり、スキャナーが解析する形式のものです。ゲストネットワークのWi-Fiレコードは次のようになります。

WIFI:T:WPA;S:Studio Guest;P:weeknight-parcel-7;;

この形式は、このサイトが考案した規則ではありません。iOSはバージョン11以降、Androidは10以降、この形式を読み取っています。内容を見れば人が間違いを見つけられるので、これは詳細設定の背後に隠すものではなく、手順の一部になっています。

警告が表示されるのもこの段階です。Wi-Fiレコードでは毎回警告が出ます。パスワードはシンボル内に平文で入り、部屋の反対側から撮影したコードの写真でも復元できるためです。国番号のない電話番号にも警告が出ます。スキームのないアドレスにも警告が出て、黙って処理するのではなく、目の前で修正されます。

検証の内容と、検証で証明できないこと

エンコード後、ツールはPNGを生成し、SVGをラスタライズして、生成に使ったエンコーダーの情報を持たないデコーダーで両方を読み取ります。カメラと同じようにシンボルを特定します。白黒のしきい値処理を行い、インクを見つけ、ファインダーパターンからモジュールの間隔を測り、形式情報を読み取り、マスクを戻し、データブロックをデインターリーブします。その後、復元したデータからReed-Solomonの誤り訂正コードワードを再計算し、シンボル内のものとバイト単位で一致することを要求します。

最後の手順は、「デコードできた」より強い確認です。データだけでなく冗長性も正しいことを確認するため、擦れたり一部が隠れたりしたコピーを読み取る場合にも、選択したレベルが約束する余裕が残ります。両方のファイルが合格した場合に限り、どちらのダウンロードも有効になります。

これは、ファイルが正しいことを証明します。あなたのカメラが、実際の印刷サイズで、使用する表面上で、実際の照明のもとで読み取れることまでは証明しません。この側でそれを確定することはできません。正直な指示は昔から変わりません。500枚を注文する前に、実際のサイズで印刷し、使う予定の携帯電話で読み取ってください。

この確認に意味がある理由も、明記しておく価値があります。このツールの構築中、レベルHの誤り訂正ブロック表に誤りが見つかりました。これを放置すると、構造上は有効でありながら、最高の冗長性設定では完全にデコードできないシンボルが生成されるところでした。画像を見ても問題は分かりません。デコーダーが最初のテスト実行で見つけました。

誤り訂正は中央を覆う許可ではない

すべてのQRシンボルには、読み取り側が損傷したデータを復元できるよう、冗長なコードワードが含まれています。4つのレベルで復元できる割合は、およそLで~7%, Mで~15%, Qで~25%, Hで~30%です。

この割合を理由に、デザイナーはコードの中央にロゴを置きます。しかしそれは、機能であるかのように見せた悪い習慣です。冗長性は、印刷後に起きる損傷、擦れ、折れ、コーヒーの輪、暗い照明に耐えるためにあります。装飾のために先に使えば、コードは余裕のない状態で始まります。そして最も余裕を必要とするのは、実際に扱われるコードです。

高いレベルでは、同じ内容でもシンボルがより密になります。冗長性を入れる場所が必要だからです。バージョン1のシンボルは、レベルLでは17バイト、レベルHでは7バイトを、同じ21×21のグリッドに格納します。ペイロードは半分未満です。密度が高いほど、読み取りやすくするには物理的に大きく印刷する必要があります。そのため、「安全のためHを使う」と、かえって読み取りにくいコードになることがよくあります。

通常はレベルMが適切な初期値です。コードを小さく印刷する場合、曲面に置く場合、触れられる場所に置く場合は、QまたはHを選んでください。

バージョン1から40までの全バージョンについて、数値・英数字の容量と、実例付きのペイロード形式を含む表全体を、qr.jsonのJSONとして公開しています。これを手入力ではなく生成しているのには理由があります。ブロック構造を2回目に書き写すことが、間違った数字が残るまさにその原因だからです。

PNGとSVG、そしてピクセル間隔が重要な理由

どちらも生成され、どちらも無料で、透かしもありません。印刷したりデザインファイルに入れたりするならSVGです。整数のビューボックスと単一のパスを持つベクターなので、ぼやけずに名刺からポスターまで拡大でき、Illustrator、Figma、Inkscape、ページレイアウトソフトで正しく開けます。文書、スライド、メッセージ、ウェブページで使うならPNGです。固定されたラスタ画像のほうが配置しやすいためです。

PNGのサイズは、すべてのモジュールがピクセル単位の整数になるよう切り下げています。細かい話に聞こえますが、重要です。29モジュールのシンボルをちょうど500ピクセルにすると、1モジュールあたり17.24ピクセルになり、4分の1ピクセルの余りがすべてのモジュール境界に灰色の縁として現れます。カメラはほとんどの場合これに対応します。常に読み取れないより悪いのは、重要な1枚の印刷で失敗することです。

シンボルの周囲にある4モジュールのクワイエットゾーンは、余白ではなくシンボルの一部です。これはISO/IEC 18004の要件であり、手作業でトリミングしたコードが読み取れない最大の共通原因です。切り取らないでください。色付きのブロックにコードをぴったり接触させないでください。レイアウトツールでインクの範囲まで切り詰めないでください。

エンコード、文字セット、ECIについて

エンコーダーは、内容に許される最も効率のよいモードを選びます。数字にはnumeric、制限された大文字の集合にはalphanumeric、それ以外にはbyteモードを使います。選択したシンボルについて、各レベルの容量表を生成前に表示します。

ペイロードにASCII以外の文字が含まれる場合、たとえばアクセント付きのネットワーク名、キリル文字の名前、日本語などでは、エンコーダーがUTF-8を宣言するECIヘッダーを書き込みます。これは正しい宣言ですが、古いスキャナーが最も扱いにくい部分でもあります。そのため、実際に必要なバイトがある場合だけ追加し、追加されたことをレシートに記載します。純粋なASCIIのペイロードにはECIヘッダーがなく、これまでに作られたどのリーダーでも同じように動作します。

このページの情報がネットワークに届くことはありません。エンコーダー、レンダラー、結果を確認するデコーダーはすべて、このタブで動作するJavaScriptです。/js/tools/以下のモジュールにはリクエストを送るコードが一切ありません。ページを読み込んだ後に接続を切断しても、すべての機能は動作します。Wi-Fiパスワードを渡そうとしているツールなら、信じるだけでなく確認すべき性質です。