메인 콘텐츠로 건너뛰기

가이드

WiFi에 대한 튜토리얼

@capgo/capacitor-wifi 사용

__CAPGO_KEEP_0__에서 WiFi 연결 관리를 위한 플러그인

설치

bun add @capgo/capacitor-wifi
bunx cap sync

이 플러그인은 다음을 제공합니다.

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

예시 사용법

addNetwork

Android 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

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

__CAPGO_KEEP_0__:

import { CapacitorWifi } from '@capgo/capacitor-wifi';

const { networks } = await CapacitorWifi.getAvailableNetworks();
networks.forEach(network => {
  console.log(`SSID: ${network.ssid}, Signal: ${network.rssi} dBm`);
});

안드로이드에서만 사용 가능한 마지막 스캔에서 사용 가능한 Wi-Fi 네트워크 목록을 가져옵니다.

Keep going from Using @capgo/capacitor-wifi

__CAPGO_KEEP_0__를 사용하여 계속 진행하세요: @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifi Using @capgo/capacitor-wifi @API/__CAPGO_KEEP_1__-wifi를 사용하여 @capgo/capacitor-wifi @capgo/capacitor-wifi와 연결하세요. @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifi의 구현 세부 사항을 확인하려면 @__CAPGO_KEEP_0__/__CAPGO_KEEP_1__-wifi를 참조하세요. 시작하기 Getting Started에 대한 구현 세부 정보에 대해 API 개요 API 개요에 대한 구현 세부 정보에 대해 소개 소개에 대한 구현 세부 정보에 대해, API 키 API 키에 대한 구현 세부 정보에 대해.