使用:@capgo/capacitor-wifi
デバイスのWi-Fi接続を管理するためのWi-Fi プラグイン
インストール
bun add @capgo/capacitor-wifi
bunx cap sync
このプラグインが公開するもの
addNetwork- Android SDK 30+ では、システム Wi-Fi 設定を開き、ネットワークを事前に埋め込む。iOS では、ネットワークに直接接続します。connect- Android では、ネットワークに一時的な接続を作成します。この接続は、デフォルトではネットワークを経由してトラフィックをルーティングしません。autoRouteTraffic を true に設定すると、接続されたネットワークにアプリのトラフィックをバインドできます (ローカル/デバイスホスト AP の場合に便利)。Android で持続的な接続を作成するには、addNetwork() を使用してください。iOS では、持続的な接続を作成します。disconnect- iOS では、このプラグインを介して追加されたネットワークのみから接続を解除します。getAvailableNetworks- Android では、最後のスキャンから利用可能な Wi-Fi ネットワークのリストを取得できます。
使用例
addNetwork
システムのダイアログを表示して、デバイスに Wi-Fi ネットワークを追加します。Android SDK 30+ では、システム Wi-Fi 設定を開き、ネットワークを事前に埋め込む。iOS では、ネットワークに直接接続します。
import { CapacitorWifi, NetworkSecurityType } from '@capgo/capacitor-wifi';
await CapacitorWifi.addNetwork({
ssid: 'MyNetwork',
password: 'mypassword',
isHiddenSsid: false,
securityType: NetworkSecurityType.WPA2_PSK
});
connect
Wi-Fi ネットワークに接続します。Android では、デフォルトではネットワークを経由してトラフィックをルーティングしない一時的な接続を作成します。autoRouteTraffic を true に設定すると、接続されたネットワークにアプリのトラフィックをバインドできます (ローカル/デバイスホスト AP の場合に便利)。Android で持続的な接続を作成するには、addNetwork() を使用してください。iOS では、持続的な接続を作成します。
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.connect({
ssid: 'MyNetwork',
password: 'mypassword',
autoRouteTraffic: true // Android only: route app traffic through this network
});
disconnect
現在の Wi-Fi ネットワークから接続を解除します。iOS では、このプラグインを介して追加されたネットワークのみから接続を解除します。
import { CapacitorWifi } from '@capgo/capacitor-wifi';
await CapacitorWifi.disconnect();
getAvailableNetworks
Android上で実行可能な最後のスキャンから利用可能なWi-Fiネットワークの一覧を取得します。
import { CapacitorWifi } from '@capgo/capacitor-wifi';
const { networks } = await CapacitorWifi.getAvailableNetworks();
networks.forEach(network => {
console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
});
フルリファレンス
- GitHub: https://github.com/Cap-go/capacitor-wifi/
- ドキュメント: /docs/plugins/wifi/
@capgo/capacitor-wifiを継続して使用
__CAPGO_KEEP_0__を使用している場合 Using @capgo/capacitor-wifi APIを使用し続けると、APIの実装詳細については@API/__CAPGO_KEEP_1__-wifiを参照してください。 @capgo/capacitor-wifi @capgo/capacitor-wifi @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifiの実装詳細については@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifiを参照してください。 Capacitor WiFi プラグインの実装詳細については、Getting Started を参照してください。 API オーバービュー Capacitor WiFi プラグインの実装詳細については、API オーバービューを参照してください。 概要 Capacitor WiFi プラグインの実装詳細については、概要を参照してください。また API キー Capacitor WiFi プラグインの実装詳細については、API キーを参照してください。