Wi-Fi プラグインは、デバイスのWi-Fi接続を管理するために使用されます。
基本機能
「基本機能」のセクションaddNetwork- Show a system dialog to add a Wi-Fi network to the device. On Android SDK 30+, this opens the system Wi-Fi settings with the network pre-filled. On iOS, this connects to the network directly.connect- Androidでは、Wi-Fiネットワークに接続します。この接続は、デフォルトではネットワークを経由してトラフィックをルーティングしないように設計されています。autoRouteTrafficをtrueに設定すると、接続されたネットワークにアプリのトラフィックをバインドできます (ローカル/デバイスホストAPの場合に便利)。Androidで持続的な接続を実現するには、addNetwork()を使用してください。iOSでは、持続的な接続を作成します。disconnect- iOSでは、このプラグインを介して追加されたネットワークのみから現在のWi-Fiネットワークを切断します。getAvailableNetworks- Androidでは、最後のスキャンから利用可能なWi-Fiネットワークのリストを取得します。
Public API
Section titled “Public API”| - メソッド | - 説明 |
|---|---|
addNetwork | Show a system dialog to add a Wi-Fi network to the device. On Android SDK 30+, this opens the system Wi-Fi settings with the network pre-filled. On iOS, this connects to the network directly. |
connect | - Androidでは、Wi-Fiネットワークに接続します。この接続は、デフォルトではネットワークを経由してトラフィックをルーティングしないように設計されています。autoRouteTrafficをtrueに設定すると、接続されたネットワークにアプリのトラフィックをバインドできます (ローカル/デバイスホストAPの場合に便利)。Androidで持続的な接続を実現するには、addNetwork()を使用してください。iOSでは、持続的な接続を作成します。 |
disconnect | - iOSでは、このプラグインを介して追加されたネットワークのみから現在のWi-Fiネットワークを切断します。 |
getAvailableNetworks | Android上での最後のスキャンから利用可能なWi-Fiネットワークの一覧を取得します。 |
getIpAddress | AndroidおよびiOS両方で利用可能な現在のデバイスのIPアドレスを取得します。 |
getRssi | Android上で現在のネットワークの受信信号強度指標（RSSI）をdBm単位で取得します。 |
getSsid | AndroidおよびiOS両方で利用可能な現在のネットワークのサービスセット識別子（SSID）を取得します。 |
getWifiInfo | 現在接続されているWi-Fiネットワークに関する詳細情報を取得します。このメソッドでは、SSID、BSSID、IPアドレス、周波数、リンクスピード、信号強度などの詳細情報を1回の呼び出しで取得できます。iOSでは、あるフィールドが利用できない場合、undefinedになります。 |
isEnabled | Android上でWi-Fiが有効かどうかを確認します。 |
startScan | Android上でWi-Fiネットワークのスキャンを開始します。結果は‘networksScanned’イベントリスナー経由で提供されます。注意: システムのトラッキングやハードウェアの問題により失敗する可能性があります。 |
checkPermissions | AndroidおよびiOS両方で位置情報アクセスの許可状況を確認します。位置情報許可は両方のプラットフォームでWi-Fi操作に必要です。 |
requestPermissions | AndroidおよびiOS両方で位置情報許可をユーザーに要求します。位置情報許可は両方のプラットフォームでWi-Fi操作に必要です。 |
addListener | Android上で‘networksScanned’イベントのリスナーを追加します。このイベントは、Wi-Fiスキャン結果が利用可能になったときに発生します。 |
removeAllListeners | このプラグインのすべてのリスナーを削除します。 |
getPluginVersion | ネイティブプラグインのバージョンを取得します。 |
ソース・オブ・トゥルース
「ソース・オブ・トゥルース」このリファレンスは src/definitions.ts で capacitor-wifi.
capgoから続けてください @capacitor-wifi
「capgoから続けてください @capacitor-wifi」Capgoを使用している場合 capgo/capacitor-wifi Capgoを使用して Using @capgo/capacitor-wifi for the native capability in Using @capgo/capacitor-wifi, Capgo Plugin Directory Capgo製品ワークフロー用 Capacitor Plugins by Capgo for the implementation detail in Capacitor Plugins by Capgo, プラグインの追加または更新 __CAPGO_KEEP_0__プラグインの追加または更新の実装詳細 イオニック エンタープライズ プラグインの代替 __CAPGO_KEEP_0__製品ワークフロー用イオニック エンタープライズ プラグインの代替