端末による自動ネットワーク接続をトリガーするには、QRコードのペイロードがZXingプロジェクト発祥でAndroidおよびiOSに広く採用されている標準の WIFI: URIスキームに準拠している必要があります。
標準文法仕様
構文はセミコロンで区切られ、末尾に二重セミコロンが付く5つのキー・バリュー形式のパラメーターで定義されます。
WIFI:T:<AuthenticationType>;S:<SSID>;P:<Password>;H:<IsHidden>;;
T:認証プロトコル。使用可能な値はWPA(WPA、WPA2-PSK、WPA3-SAEを包括)、WEP(従来のWEP暗号化)、またはnopass(暗号化なしのオープンネットワーク)です。S:サービスセット識別子(SSID / ネットワーク名)。大文字と小文字を区別します。P:事前共有キー(Wi-Fiパスワード)。T:nopassの場合は空欄にします。H:非公開(ステルス)ネットワークフラグ。trueまたはfalseを指定します。
具体的な記述例
一般的なWPA2/WPA3の家庭・オフィスネットワーク:
WIFI:T:WPA;S:StudioHQ_Guest;P:Precision2026!;H:false;;
パスワードなしのフリーWi-Fiスポット:
WIFI:T:nopass;S:Cafe_Open_5G;P:;H:false;;
特殊文字を含む非公開(ステルス)ネットワーク:
WIFI:T:WPA;S:Lab\;Corp\,East;P:Secret\:Key\\99;H:true;;
特殊文字のエスケープ要件
プロトコルパーサーにおいてセミコロン(;)、コロン(:)、カンマ(,)、バックスラッシュ(\)は構文の区切り文字として機能するため、実際のSSIDやパスワード内にこれらの文字が含まれる場合は直前にバックスラッシュ(\)を置いてエスケープする必要があります。Utiliomeでは、このエスケープ処理をブラウザ側で自動的に実行します。