본문으로 바로가기
플러그인으로 돌아가기
@capgo/capacitor-wifi
튜토리얼
github.com/Cap-go에 의해

와이파이

Capacitor 앱의 와이파이 연결 관리

가이드

WiFi 튜토리얼

WiFi 플러그인 사용 (@capgo/capacitor-wifi)

장치 WiFi 연결 관리를 위한 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__: 안드로이드에서만 사용 가능한 마지막 스캔에서 사용 가능한 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`);
});

Full Reference

capgo를 사용하여 계속 진행하세요: @capgo/capacitor-wifi

__CAPGO_KEEP_0__를 사용 중이시면 @capgo/capacitor-wifi를 사용하여 API를 사용하여 대시보드와 API 운영을 계획하고자 하신다면 @API/__CAPGO_KEEP_1__-wifi와 연결하세요. @capgo/capacitor-wifi의 구현 세부 정보를 확인하려면 @capgo/capacitor-wifi를 참조하세요. Getting Started with capgo and capacitor-wifi plugin. __CAPGO_KEEP_0__: __CAPGO_KEEP_1__-wifi 플러그인을 사용하여 __CAPGO_KEEP_0__를 사용하는 방법을 알아보세요. __CAPGO_KEEP_0__ 구현 세부 사항에 대한 설명을 위해 Capgo API 개요 API 구현 세부 사항에 대한 설명을 위해 Capgo API 개요 소개 __CAPGO_KEEP_0__ 구현 세부 사항에 대한 설명을 위해 소개 API 키 API 구현 세부 사항에 대한 설명을 위해 API 키