Wi-Fiと連絡先のQRコード:正確なテキスト形式とエスケープ

Wi-Fi用のQRコードは、決まった形のプレーンテキストです。Apps24のエンコーダーで、Wi-Fi、非公開(ステルス)ネットワーク、特殊文字を含む名前とパスワード、連絡先カードのコードを生成し、各画像をZXing-C++ 3.1.1でデコードしました。

入力と結果

WIFI:T:WPA;S:Cafe Guest;P:sunny-2026;;3829 × 29
WIFI:T:WPA;S:Office;P:sunny-2026;H:true;;4129 × 29
WIFI:T:WPA;S:Cafe\;Guest;P:pa\:ss\\word;;4129 × 29
BEGIN:VCARD … END:VCARD10041 × 41

結果の読み方

すべてのサンプルが、入力したテキストとまったく同じ内容にデコードされました。WIFI:T:WPA;S:Cafe\;Guest;P:pa\:ss\\word;; もその一つで、名前やパスワードに含まれる \ ; , : " の各文字の前にはバックスラッシュを付けています。38文字のWi-Fiテキストは29 × 29モジュール、100文字のテキストは41 × 41モジュールのコードになりました。ジェネレーターはASCII文字なら2331文字、ハングルなら777文字まで受け付けました。

次の作業

1. テキストを WIFI:T:WPA;S:名前;P:パスワード;; の形で書きます(オープンネットワークは T:nopass、非公開ネットワークは H:true)。2. 特殊文字はバックスラッシュでエスケープします。3. PNGをダウンロードし、実際に使うスマートフォンで読み取ります。4. 印刷してもモジュールが大きく保たれるよう、テキストは短くします。

ツールを使う

制限とテスト条件

デコードはデジタル画像に対してソフトウェアでのみ行いました。印刷したコードの読み取りや特定の機種での確認は行っておらず、読み取り後のスマートフォンの動作はカメラアプリによって異なります。サンプルのパスワードは実在のネットワークのものではありません。

qr-format-results.json

参考資料

Apps24は例を実装と回帰テストで確認します。ブラウザ実験は条件を明示し、すべての端末を保証するものではありません。不具合はURL、入力例、期待する結果、ブラウザを添えてお知らせください。パスワード、非公開文書、個人情報は送らないでください。