__CAPGO_KEEP_0__ 로고
플러그인으로 돌아가기
@capgo/capacitor-wifi
튜토리얼
github.com/Cap-go에서 제공하는 github

와이파이

Capacitor 앱의 와이파이 연결 관리

__CAPGO_KEEP_0__

__CAPGO_KEEP_1__

Using @capgo/capacitor-wifi

__CAPGO_KEEP_0__ 설치

__CAPGO_KEEP_0__에 대한 설명

bun add @capgo/capacitor-wifi
bunx cap sync

__CAPGO_KEEP_0__

  • addNetwork SDK WiFi 연결 가이드
  • connect __CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifi를 사용하여 WiFi를 연결합니다.
  • disconnect __CAPGO_KEEP_0__ WiFi 연결을 관리하는 플러그인입니다.
  • getAvailableNetworks - 안드로이드에서 마지막으로 스캔한 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.

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

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

connect

Wi-Fi 네트워크에 연결합니다. 안드로이드에서 이 메서드는 기본적으로 네트워크를 통해 트래픽을 라우팅하지 않습니다. autoRouteTraffic를 true로 설정하여 앱 트래픽을 연결된 네트워크에 바인딩할 수 있습니다 (로컬/장치 호스팅 AP의 경우 유용합니다). 안드로이드에서 지속적인 연결을 원하는 경우 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

안드로이드에서 마지막으로 스캔한 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`);
});

전체 참조