@capgo/capacitor-wifi 사용
장치 Wi-Fi 연결성을 관리하는 Wi-Fi 플러그인.
설치
bun add @capgo/capacitor-wifi
bunx cap sync
이 플러그인이 제공하는 것
addNetwork- 장치에 Wi-Fi 네트워크를 추가하는 시스템 대화 상자를 표시합니다. 안드로이드 SDK 30+에서 이 대화 상자는 네트워크를 미리 채워진 상태로 시스템 Wi-Fi 설정을 열게 됩니다. iOS에서 이 대화 상자는 네트워크에 직접 연결합니다.connect- Wi-Fi 네트워크에 연결합니다. 안드로이드에서는 이 네트워크를 기본적으로 트래픽을 라우팅하지 않도록 임시 연결을 생성합니다. autoRouteTraffic를 true로 설정하여 앱 트래픽을 연결된 네트워크에 바인딩할 수 있습니다 (로컬/장치 호스팅 AP를 위한 유용한 옵션입니다). 안드로이드에서 지속적인 연결을 사용하려면 addNetwork() 대신 사용하세요. iOS에서는 지속적인 연결을 생성합니다.disconnect- 현재 Wi-Fi 네트워크에서 연결을 끕니다. iOS에서는 이 플러그인을 통해 추가된 네트워크만 끊습니다.getAvailableNetworks- 마지막으로 스캔한 Wi-Fi 네트워크 목록을 가져옵니다. 안드로이드에서만 사용 가능합니다.
예제 사용
addNetwork
장치에 Wi-Fi 네트워크를 추가하는 시스템 대화 상자를 표시합니다. 안드로이드 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
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`);
});
전체 참조
- GitHub https://github.com/Cap-go/capacitor-wifi/
- 문서: /docs/plugins/wifi/
Using @capgo/capacitor-wifi
__CAPGO_KEEP_0__를 사용하여 capgo/capacitor-wifi를 사용하여 API를 계획하고 API를 운영할 때, @API/__CAPGO_KEEP_1__-wifi와 연결하세요. @capgo/capacitor-wifi @capgo/capacitor-wifi에 대한 구현 세부 정보를 참조하십시오. Getting Started @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifi에 대한 구현 세부 정보를 참조하십시오. API 개요에 대한 구현 세부 정보를 참조하십시오. for the implementation detail in API Overview, __CAPGO_KEEP_0__ 키에 대한 구현 세부 정보를 참조하십시오. Footer API 앱을 사용하여 150개 이상의 프로덕션 준비 완료 플러그인을 사용하여 API 앱을 구동하십시오.