본문으로 건너뛰기

가이드

와이파이 튜토리얼

장치에서 테스트

다운로드 Capgo 앱, 그리고 QR code를 스캔하세요.

WiFi 플러그인 미리보기 QR code

@capgo/capacitor-wifi를 사용합니다.

장치 WiFi 연결성을 관리하는 WiFi 플러그인입니다.

설치

bun add @capgo/capacitor-wifi
bunx cap sync

이 플러그인이 제공하는 것

  • addNetwork - 시스템 다이얼로그를 통해 장치에 WiFi 네트워크를 추가합니다. 안드로이드 SDK 30+에서는 네트워크를 미리 채워진 시스템 WiFi 설정을 열고, iOS에서는 네트워크에 직접 연결합니다.
  • connect - WiFi 네트워크에 연결합니다. 안드로이드에서는 기본적으로 트래픽을 네트워크를 통해 라우팅하지 않도록 임시 연결을 생성합니다. autoRouteTraffic를 true로 설정하여 앱 트래픽을 연결된 네트워크에 바인딩할 수 있습니다(로컬/장치 호스팅 AP의 경우 유용합니다). 안드로이드에서 지속적인 연결을 사용하려면 addNetwork()를 사용하세요. iOS에서는 지속적인 연결을 생성합니다.
  • disconnect - 현재 WiFi 네트워크에서 연결을 끊습니다. iOS에서는 이 플러그인을 통해 추가된 네트워크만 끊습니다.
  • getAvailableNetworks - 마지막으로 스캔한 WiFi 네트워크 목록을 가져옵니다. 안드로이드에서만 사용할 수 있습니다.

예제 사용

addNetwork

시스템 다이얼로그를 통해 장치에 WiFi 네트워크를 추가합니다. 안드로이드 SDK 30+에서는 네트워크를 미리 채워진 시스템 WiFi 설정을 열고, 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`);
});

전체 참조

Using @capgo/capacitor-wifi

__CAPGO_KEEP_0__를 사용하여 대시보드와 __CAPGO_KEEP_0__를 계획하고 운영할 경우 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifi와 연결하세요. capgo를 사용하여 대시보드와 capgo를 계획하고 운영할 경우 @capgo/capacitor-wifi와 연결하세요. API를 사용하여 대시보드와 API를 계획하고 운영할 경우 @API/__CAPGO_KEEP_1__-wifi와 연결하세요. capgo를 사용하여 대시보드와 capgo를 계획하고 운영할 경우 @capgo/capacitor-wifi와 연결하세요. implementation detail in @capgo/capacitor-wifi 에서 Getting Started implementation detail in Getting Started 에서 API Overview implementation detail in API Overview 에서 소개 implementation detail in __CAPGO_KEEP_0__ Keys 에서 API Keys API 앱을 위한 150+ 프로덕션 준비 완료 플러그인으로 güç을 주세요