Wi-Fi QRコード作成

WIFI:文字列の中身

ペイロードは、接頭辞とセミコロン区切りのフィールドからなる1行のテキストで、最後をセミコロン2つで閉じます。典型的なものは WIFI:T:WPA;S:Cafe-Guest;P:flatwhite2019;; で、これで全部です。URLではありませんし、ネットワーク上の何かに解決するものでもありません。

この形式は標準化団体ではなくZXingというバーコードプロジェクトに由来し、そのため事実上の標準と呼ばれます。仕様に沿った読み取り側にとってフィールドの順序は問題になりませんが、末尾のセミコロン2つは違います。読み取り側はそれをレコードの終わりの印として使います。

そのままでは構造の一部として読まれてしまう文字は、バックスラッシュでエスケープする必要があります。このページはエンコードの前にそれらをエスケープし、二重にエスケープされないようバックスラッシュを最初に処理します。

• T: 暗号化の種類。WPA、WEP、nopassのいずれか
• S: SSID。大文字小文字を含め、ルーターが発信しているとおりに
• P: パスフレーズ。種類がnopassのときは丸ごと省略されます
• H: ネットワークがステルスのときだけtrue
• エスケープされる文字: バックスラッシュ、セミコロン、カンマ、コロン、二重引用符

何もインストールせずに接続できる端末

iOSは11以降、Androidは10以降、標準のカメラアプリでWIFI:コードを読み取ります。それより古いAndroidではカメラがWIFI:…という生のテキストを表示するか、何も起こらず、来客側にこの形式を実装したスキャナーアプリが必要になります。Wi-Fiコードが動かないように見える原因として、これが最も多いものです。

WPA3専用のトークンはありません。WPAを選べばWPA2でもWPA3でも移行モードの混在ネットワークでも動きます。端末はネットワークを見つけた時点でハンドシェイクを選ぶからです。WPA3専用のネットワークにT:SAEを出力するツールもありますが、SAEを認識しないパーサーは黙って失敗するため、このページでは提供していません。

ステルスネットワークにはH:trueが必要です。このフラグがないと、端末は一致するSSIDを電波の中から探し、見つからないまま、役に立つエラーも出さずに諦めます。ルーターのSSID通知をオフにしている場合は、必ずチェックボックスを入れてください。

使い続けられるネットワークカードを印刷する

Wi-Fiのペイロードは短いので、シンボルは小さいままです。上の例は41バイトで、レベルQならバージョン4の33×33モジュールのシンボルに収まります。クワイエットゾーンを含めて幅30 mmで印刷すると1モジュールあたり約0.7 mmとなり、テーブル越しにスマートフォンのカメラが解像できる範囲に十分収まります。

ここで初期の復元レベルをQにしているのは、この種のカードがテーブルの上で暮らし、飲み物をこぼされ、光を反射するラミネートをかけられるからです。Qはシンボル内のコードワードの約4分の1を復元できるだけの復元用コードワードを追加し、ペイロードが十分に小さいので、その追加分はサイズにほとんど響きません。

パスワードは読み取り可能なテキストとしてシンボルの中に入っています。カードを撮影した人は誰でも、どんなスキャナーでも復号できるので、プリンターやネットワークストレージにも届く本来のパスフレーズをエンコードするのではなく、来客には独自のパスフレーズを持つゲスト用ネットワークを使ってもらってください。