@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의 구현 세부 사항은 시작하기 시작하기 문서의 구현 상세 내용은, API 개요 API Overview의 구현 상세 내용은 소개 Introduction의 구현 세부 사항과, API 키 API Keys의 구현 세부 사항을 참고하세요.