Android 10 이상에서 Wi-Fi 인프라에는 인터넷 연결을 위한 Wi-Fi 추천 API와 P2P 연결을 위한 Wi-Fi 네트워크 요청 API가 포함됩니다. Android 11 이상에서 설정 인텐트 API를 사용하면 사용자에게 저장된 네트워크 또는 Passpoint 구성 추가를 승인하도록 요청할 수 있습니다.
API
세 가지 API는 서로 다른 사용 사례를 타겟팅하며 기능과 제약 조건이 다릅니다.
추천 API: 인터넷 지원 구성을 프로비저닝하고 제공하는 앱을 타겟팅합니다. 이러한 구성은 사용자가 개별적으로 소유하지 않습니다. 사용자는 특정 구성을 사용 중지하거나 추천 앱을 사용 중지할 수 있지만 삭제할 수는 없습니다.
사용자 승인은 앱에서 제안한 네트워크별이 아닌 앱별로 필요합니다.
이동통신사 Wi-Fi 오프로드 구성 앱과 오프로드 네트워크를 적극적으로 관리할 수 있는 기타 앱을 위한 것입니다.
네트워크 요청 API: IoT 기기를 구성하거나 카메라로 파일을 전송하는 등 피어 기기에 연결해야 하는 앱을 타겟팅합니다. 이 경우 피어 기기가 SoftAP를 시작하고 API를 통해 앱이 사용자가 기기에 연결하도록 안내할 수 있습니다. 결과 네트워크는 인터넷 액세스를 제공하지 않으며 시스템에서 사용할 수 없고 구성 앱을 제외한 어떤 앱에서도 사용할 수 없습니다.
새 피어에 처음 연결할 때는 사용자가 선택하고 승인해야 합니다.
IoT 구성 앱 및 IoT 파일 전송 앱용입니다.
ACTION_WIFI_ADD_NETWORKS API: 앱 (사용자 승인 포함)이 저장된 네트워크 또는 구독 목록에 네트워크 또는 Passpoint 구성을 추가할 수 있습니다. 그러면 이러한 구성이 사용자가 직접 추가한 것처럼 처리됩니다. 예를 들어 사용자는 나중에 이를 삭제할 수 있습니다.
저장된 네트워크를 추가하려면 모든 요청에 대해 사용자 승인이 필요합니다.
홈 액세스 포인트를 구성하고 사용자 저장 네트워크 목록에 구성을 추가해야 하는 앱을 대상으로 합니다. 엔터프라이즈, 제휴 네트워크, 교육 기관 등 사용자 계정 Passpoint 구성을 프로비저닝하는 앱
안전한 Wi-Fi Enterprise 구성
Android 11 QPR1 이상에서는 시스템에서 TLS 기반 Wi-Fi 엔터프라이즈 연결에 엄격한 보안 구성을 요구합니다. 자세한 내용은 보안 Wi-Fi Enterprise 구성을 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-08-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-08-27(UTC)"],[],[],null,["On Android 10 and higher, the Wi-Fi infrastructure includes the Wi-Fi suggestion\nAPI for internet connectivity and the Wi-Fi network request API for peer-to-peer\nconnectivity. On Android 11 and higher, the Settings Intent API lets you\nask the user to approve adding a saved network or Passpoint configuration.\n\nAPIs\n\nThe three APIs target different use cases and have different capabilities and\nconstraints:\n\n- [Suggestion API](/develop/connectivity/wifi/wifi-suggest): targets apps that\n provision and provide internet-capable configurations. These configurations\n are not individually owned by the user. Users can disable specific\n configurations or disable the suggesting app, but can't delete\n them.\n\n - User approval is required per app, not per network suggested by the app.\n - Intended for carrier Wi-Fi offload configuration apps and other apps that may actively manage offload networks.\n- [Network request API](/develop/connectivity/wifi/wifi-bootstrap): targets\n apps that need to connect to a peer device, such as when configuring an IoT\n device or transferring files to a camera. In such cases, the peer device\n starts up a SoftAP and the API allows the app to guide the user to connect to\n the device. The resulting network is not intended to provide internet access,\n can't be used by the system, and can't be used by any app except the\n configuring app.\n\n - User selection and approval is required the first time a connection is made to a new peer.\n - Intended for IoT configuration apps and IoT file transfer apps.\n- [`ACTION_WIFI_ADD_NETWORKS`\n API](/develop/connectivity/wifi/wifi-save-network-passpoint-config): allows\n apps (with user approval) to add networks or Passpoint configurations to the\n saved network or subscription list. These configurations are then treated as\n if the user added them directly. For example, the user can later delete them.\n\n - User approval is required for every request to add saved networks.\n - Intended for apps that configure a home Access Point and need to add the configuration to the user's saved network list. Apps that provision a user-account Passpoint configuration, such as Enterprise, federated networks, and educational institutions.\n\n| **Note:** These APIs are a replacement for the deprecated `WifiManager.addNetwork(WifiConfiguration config)` and related APIs. The other deprecated APIs allowed apps to directly add and manage a Wi-Fi configuration in the saved network list. The replacement APIs provide use-case-targeted alternatives.\n\nSecure Wi-Fi Enterprise configuration\n\nOn Android 11 QPR1 and higher, the system mandates strict security\nconfigurations for TLS-based Wi-Fi Enterprise connections. For more\ninformation, see\n[Secure Wi-Fi Enterprise configuration](/develop/connectivity/wifi-enterprise)."]]
