개요
“개요” 섹션Capacitor 앱의 WiFi 연결을 관리하세요
시작하기 addNetwork() 그리고 아래에 나열된 다른 핵심 메서드도 살펴보세요.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | 네이티브 |
| Android | 지원 | 네이티브 |
| 웹 | 아니요 | Capacitor.getPlatform()으로 보호하세요 |
핵심 기능
“핵심 기능” 섹션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에서만 사용할 수 있습니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
addNetwork | 시스템 대화 상자를 띄워 기기에 Wi-Fi 네트워크를 추가합니다. Android SDK 30+에서는 네트워크가 미리 입력된 시스템 Wi-Fi 설정이 열립니다. iOS에서는 해당 네트워크에 직접 연결합니다. |
connect | Wi-Fi 네트워크에 연결합니다. Android에서는 기본적으로 트래픽을 해당 네트워크로 라우팅하지 않는 임시 연결이 생성됩니다. 앱 트래픽을 연결된 네트워크에 바인딩하려면(로컬/기기에서 호스팅하는 AP에 유용) autoRouteTraffic를 true로 설정하세요. Android에서 지속 연결이 필요하면 addNetwork()를 대신 사용하세요. iOS에서는 지속 연결이 생성됩니다. |
disconnect | 현재 Wi-Fi 네트워크 연결을 해제합니다. iOS에서는 이 플러그인으로 추가한 네트워크에서만 연결이 해제됩니다. |
getAvailableNetworks | 마지막 스캔에서 사용 가능한 Wi-Fi 네트워크 목록을 가져옵니다. Android에서만 사용할 수 있습니다. |
getIpAddress | 기기의 현재 IP 주소를 가져옵니다. Android와 iOS 모두 지원합니다. |
getRssi | 현재 네트워크의 수신 신호 강도 지표(RSSI)를 dBm 단위로 가져옵니다. Android에서만 사용할 수 있습니다. |
getSsid | 현재 네트워크의 SSID(Service Set Identifier)를 가져옵니다. Android와 iOS 모두 지원합니다. |
getWifiInfo | 현재 연결된 WiFi 네트워크에 대한 상세 정보를 가져옵니다. 이 메서드는 SSID, BSSID, IP 주소, 주파수, 링크 속도, 신호 강도를 포함한 상세 네트워크 정보를 한 번의 호출로 제공합니다. iOS에서는 일부 필드를 사용할 수 없으며 undefined로 반환됩니다. |
isEnabled | 기기의 Wi-Fi 활성화 여부를 확인합니다. Android에서만 사용할 수 있습니다. |
startScan | Wi-Fi 네트워크 스캔을 시작합니다. Android에서만 사용할 수 있습니다. 결과는 ‘networksScanned’ 이벤트 리스너를 통해 전달됩니다. 참고: 시스템 스로틀링 또는 하드웨어 문제로 인해 실패할 수 있습니다. |
checkPermissions | 위치 정보 접근 권한의 현재 상태를 확인합니다. 두 플랫폼 모두에서 Wi-Fi 작업을 위해 위치 권한이 필요합니다. |
requestPermissions | 사용자에게 위치 권한을 요청합니다. 두 플랫폼 모두에서 Wi-Fi 작업을 위해 위치 권한이 필요합니다. |
addListener | ‘networksScanned’ 이벤트에 대한 리스너를 추가합니다. Android에서만 사용할 수 있습니다. Wi-Fi 스캔 결과가 준비되면 이 이벤트가 발생합니다. |
removeAllListeners | 이 플러그인의 모든 리스너를 제거합니다. |
getPluginVersion | 네이티브 플러그인 버전을 가져옵니다. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-wifi.
@capgo/capacitor-wifi에서 계속하기
“@capgo/capacitor-wifi”에서 계속하기사용 중이라면 @capgo/capacitor-wifi 네이티브 플러그인 작업을 계획하려면, 이를 다음 항목과 연결하세요: @capgo/capacitor-wifi 사용 @capgo/capacitor-wifi 사용의 네이티브 기능에 대해 Capgo 플러그인 디렉토리 Capgo Plugin Directory의 제품 워크플로우에 맞춰, Capgo의 Capacitor 플러그인 Capgo의 Capacitor 플러그인 구현 상세 내용에 대해서는, 플러그인 추가 또는 업데이트 플러그인 추가 또는 업데이트 구현 상세 내용에 대해서는, Ionic Enterprise 플러그인 대안 Ionic Enterprise 플러그인 대안의 제품 워크플로우에 대해서는.