メインコンテンツにジャンプ

ガイド

Wi-Fiのチュートリアル

@capgo/capacitor-wifiを使用

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

Install

bun add @capgo/capacitor-wifi
bunx cap sync

このプラグインが公開するもの

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

Example Usage

addNetwork

AndroidデバイスにWi-Fiネットワークを追加するシステムダイアログを表示します。Android SDK 30+では、ネットワークを事前に埋め込んだシステムWi-Fi設定を開きます。iOSでは、ネットワークに直接接続します。

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.addNetwork({
  ssid: 'MyNetwork',
  password: 'mypassword',
  isHiddenSsid: false,
  securityType: NetworkSecurityType.WPA2_PSK
});

connect

Androidデバイスに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

Androidデバイスから現在のWi-Fiネットワークに接続しているネットワークから切断します。iOSでは、このプラグインを介して追加されたネットワークのみを切断します。

import { CapacitorWifi } from '@capgo/capacitor-wifi';

await CapacitorWifi.disconnect();

getAvailableNetworks

__CAPGO_KEEP_0__:

import { CapacitorWifi } from '@capgo/capacitor-wifi';

const { networks } = await CapacitorWifi.getAvailableNetworks();
networks.forEach(network => {
  console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
});

Androidで最後のスキャンから利用可能なWi-Fiネットワークの一覧を取得します。

Keep going from Using @capgo/capacitor-wifi

@__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifiを使用し続ける Using @capgo/capacitor-wifi @API/__CAPGO_KEEP_1__-wifiを使用し続ける capgoの計画ダッシュボードとオペレーションに接続するには、@capgo/capacitor-wifiと接続する @capgo/capacitor-wifiの実装詳細は@capgo/capacitor-wifiを参照する Getting Started Getting Startedの実装詳細について API オーバービュー for the implementation detail in API Overview, __CAPGO_KEEP_0__ オーバービュー 導入 API Keys API キー