Skip to content

@capgo/capacitor-wifi

デバイスのWi-Fi接続を管理するためのWi-Fi プラグイン

Wi-Fi プラグインでデバイスの Wi-Fi 接続性を管理します。

  • addNetwork - Android SDK 30 以降では、システムの Wi-Fi 設定を開き、ネットワークを事前に入力した状態で開きます。iOS では、ネットワークに直接接続します。
  • connect - Android では、ネットワークに一時的な接続を作成します。この接続は、デフォルトではネットワークのトラフィックをルーティングしません。autoRouteTraffic を true に設定すると、接続されたネットワークにアプリのトラフィックをバインドできます (ローカル/デバイスホスト AP の場合に便利)。Android では、持続的な接続を作成するには、addNetwork() を使用してください。iOS では、持続的な接続を作成します。
  • disconnect - iOS では、ネットワークからのみ、ネットワークをこのプラグインで追加したものを切断します。
  • getAvailableNetworks - Android では、最後のスキャンから利用可能な Wi-Fi ネットワークのリストを取得できます。

Public API

Public API
メソッド説明
addNetworkShow 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.
connectWi-Fiネットワークに接続します。Androidでは、デフォルトではネットワークを経由してアプリのトラフィックをルーティングしない、暫定接続を作成します。autoRouteTraffic を true に設定すると、接続したネットワークにアプリのトラフィックをバインドできます (ローカル/デバイスホスト AP の場合に便利)。Android では、持続的な接続を作成するには addNetwork() を使用してください。iOS では、持続的な接続を作成します。
disconnect現在接続している Wi-Fi ネットワークから切断します。iOS では、このプラグインを使用して追加されたネットワークのみを切断します。
getAvailableNetworksAndroid では、最後のスキャンから利用可能な Wi-Fi ネットワークのリストを取得します。
getIpAddressデバイスの現在の IP アドレスを取得します。Android と iOS の両方で利用可能です。
getRssi現在接続しているネットワークの受信信号強度 (RSSI) を dBm で取得します。Android ではのみ利用可能です。
getSsid現在接続しているネットワークのサービス セット ID (SSID) を取得します。Android と iOS の両方で利用可能です。
getWifiInfo現在接続している Wi-Fi ネットワークの詳細情報を取得します。このメソッドでは、SSID、BSSID、IP アドレス、周波数、リンク スピード、信号強度などの詳細情報を 1 回の呼び出しで取得できます。iOS では、あるフィールドが利用可能でない場合、undefined になります。
isEnabledデバイス上の Wi-Fi が有効かどうかを確認します。Android ではのみ利用可能です。
startScanWi-Fi ネットワークをスキャン開始します。Androidのみ対応。結果は 'networksScanned' イベントリスナー経由で提供されます。注意: システムのトラッキングやハードウェアの問題により失敗する可能性があります。
checkPermissions現在の位置情報の許可状況を確認してください。両方のプラットフォームでWi-Fi操作に必要な位置情報の許可は必要です。
requestPermissionsユーザーから位置情報の許可を要求してください。両方のプラットフォームでWi-Fi操作に必要な位置情報の許可は必要です。
addListener‘networksScanned’ イベントのリスナーを追加してください。Androidのみ対応。このイベントはWi-Fi スキャン結果が利用可能になったときに発生します。
removeAllListenersこのプラグインのすべてのリスナーを削除してください。
getPluginVersionネイティブプラグインのバージョンを取得してください。

このリファレンスは src/definitions.ts in capacitor-wifi.

Capgoを使用している場合 @capgo/capacitor-wifi をnative pluginの作業計画に接続する Capgoを使用してnative capabilityの@capgo/capacitor-wifi native capabilityの@capgo/capacitor-wifiの@capgo/capacitor-wifi @Capgo プラグイン ディレクトリ @Capgo プラグイン ディレクトリの製品ワークフロー @Capacitor プラグイン (@Capgo によって提供) @Capacitor プラグイン (@Capgo によって提供)の実装詳細 プラグインの追加または更新 プラグインの追加または更新の実装詳細 Ionic Enterprise Plugin Alternatives Ionic Enterprise Plugin Alternativesの製品ワークフロー