@capgo/capacitor-wifi 사용 중
기기의 WiFi 연결을 관리하기 위한 WiFi 플러그인입니다.
설치
bun add @capgo/capacitor-wifi
bunx cap sync
플러그인이 제공하는 기능
addNetwork- 기기에 Wi-Fi 네트워크를 추가하는 시스템 대화 상자를 표시합니다. Android SDK 30 이상에서는 네트워크 정보가 입력된 상태로 시스템 Wi-Fi 설정이 열립니다. iOS에서는 해당 네트워크에 직접 연결합니다.connect- Wi-Fi 네트워크에 연결합니다. Android에서는 기본적으로 트래픽을 라우팅하지 않는 임시 연결을 생성합니다. 앱 트래픽을 연결된 네트워크에 바인딩하려면 autoRouteTraffic을 true로 설정하세요(로컬/기기 호스트 AP 사용 시 유용). Android에서 영구적인 연결이 필요한 경우 addNetwork()를 사용하세요. iOS에서는 영구적인 연결을 생성합니다.disconnect- 현재 Wi-Fi 네트워크에서 연결을 해제합니다. iOS에서는 이 플러그인을 통해 추가된 네트워크만 연결이 해제됩니다.getAvailableNetworks- 마지막 스캔에서 사용 가능한 Wi-Fi 네트워크 목록을 가져옵니다. Android에서만 사용할 수 있습니다.
사용 예시
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
마지막 스캔에서 사용 가능한 Wi-Fi 네트워크 목록을 가져옵니다. Android에서만 사용할 수 있습니다.
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/capacitor-wifi 사용하기 대시보드 및 API 운영을 계획하려면, 이를 다음과 연결하세요 @capgo/capacitor-wifi @capgo/capacitor-wifi의 구현 세부 사항은 시작하기 Getting Started의 구현 상세 내용은 API 개요 구현 세부 사항은 API 개요에서 소개 Introduction의 구현 상세 내용은, 그리고 API 키 API Keys의 구현 상세 내용은