2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main
대신 android-latest-release
를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.
5G Non-Standalone(NSA)
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Android 10 및 이후 버전을 실행하는 기기는 5G Non-Standalone(NSA)을 지원할 수 있습니다. 5G NSA는 기존 4G 인프라에서 지원하는 5G 네트워크 솔루션입니다. Android 10을 실행하는 기기는 5G 네트워크에 연결되면 상태 표시줄에 5G 아이콘이 표시될 수 있습니다.
구현
이동통신사 구성
5G 아이콘이 상태 표시줄에 표시되는 방식을 구성하려면 이동통신사는 CarrierConfig
에 KEY_5G_ICON_CONFIGURATION_STRING
키를 사용하면 됩니다.
다음과 같은 시나리오가 5G NSA에서 발생할 수 있습니다.
- 기기가 보조 셀로서 5G 셀에 연결되고 밀리미터파를 사용함
- 기기가 보조 셀로서 5G 셀에 연결되지만, 밀리미터파를 사용하지 않음
- 기기가 5G 기능이 있는 네트워크에 캠핑되며(기기가 보조 셀로서 5G 셀에 연결될 필요는 없음) 5G 사용은 제한되지 않고 무선 리소스 제어(RRC)가
IDLE
상태에 있음(연결 없음)
- 기기가 5G 기능이 있는 네트워크에 캠핑되며(기기가 보조 셀로서 5G 셀에 연결될 필요는 없음) 5G 사용은 제한되지 않고 무선 리소스 제어(RRC)가
CONNECTED
상태에 있음
- 기기가 5G 기능이 있는 네트워크에 캠핑되지만(기기가 보조 셀로서 5G 셀에 연결될 필요는 없음) 5G의 사용이 제한됨
구성 문자열에는 쉼표로 구분된 여러 개의 키-값 쌍이 포함되어 있습니다.
각 쌍에서 키와 값은 콜론으로 구분됩니다. 구성 문자열의 키는 위에 설명한 5G 시나리오에 해당하며 다음 중 하나여야 합니다.
connected_mmwave
connected
not_restricted_rrc_idle
not_restricted_rrc_con
restricted
구성 문자열의 값은 /packages/SettingsLib/res/
디렉터리에 있는 아이콘의 이름과 일치하는 유효한 아이콘 이름이어야 합니다. 5G NSA의 두 가지 기본 아이콘인 5G
및 5G_PLUS
를 사용할 수 있습니다.

그림 1. 기본 5G 및 5G_PLUS 5G 아이콘
기기가 실제로 5G에 연결된 시나리오 1(connected_mmwave
)과 시나리오 2(connected
)에서만 5G 아이콘을 표시합니다. 시나리오 1에는 5G_PLUS
아이콘, 시나리오 2에는 5G
아이콘을 사용합니다. 다음은 CarrierConfig
에 있는 구성 문자열의 예입니다.
connected_mmwave:5G_PLUS,connected:5G
시스템 UI
이동통신사가 특정 상태에 사용할 수 있는 아이콘을 맞춤설정하려면 TelephonyIcons.java
에서 MobileIconGroup
객체를 추가합니다.
MobileIconGroup
의 아이콘 이름이 CarrierConfig
에 사용된 아이콘 이름과 일치해야 합니다. 다음은 이름이 '5G_PLUS'인 맞춤 아이콘을 MobileIconGroup
에 추가하는 방법의 예를 보여줍니다.
static final MobileIconGroup NR_5G_PLUS = new MobileIconGroup(
"5G_PLUS",
null,
null,
AccessibilityContentDescriptions.PHONE_SIGNAL_STRENGTH,
0,
0,
0,
0,
AccessibilityContentDescriptions.PHONE_SIGNAL_STRENGTH[0],
R.string.data_connection_5g_plus,
TelephonyIcons.ICON_5G_PLUS,
true);
유효성 검사
구현의 유효성을 검사하려면 기기가 5G 셀에 연결되었을 때 상태 표시줄에 5G 아이콘이 표시되어 있는지 확인합니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2024-05-01(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"]],["최종 업데이트: 2024-05-01(UTC)"],[],[],null,["# 5G non-standalone (NSA)\n\nDevices running Android 10 or higher can support 5G\nnon-standalone (NSA). 5G NSA\nis a solution for 5G networks where the network is supported by the existing 4G\ninfrastructure. On Android 10, devices can display a\n5G icon on the status bar\nwhen a device connects to a 5G network.\n\nImplementation\n--------------\n\n### Carrier configuration\n\nTo configure how 5G icons are displayed on the status bar, carriers can use the\n[`KEY_5G_ICON_CONFIGURATION_STRING`](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/telephony/java/android/telephony/CarrierConfigManager.java#2459)\nkey in `CarrierConfig`.\n\nThese scenarios are available in 5G NSA:\n\n1. Device connected to 5G cell as the secondary cell and using millimeter wave.\n2. Device connected to 5G cell as the secondary cell but not using millimeter wave.\n3. Device camped on a network that has 5G capability (device doesn't have to be connected to a 5G cell as a secondary cell) and the use of 5G isn't restricted and radio resource control (RRC) is in the `IDLE` state (no connection).\n4. Device camped on a network that has 5G capability (device doesn't have to be connected to a 5G cell as a secondary cell) and the use of 5G isn't restricted and radio resource control (RRC) is in the `CONNECTED` state.\n5. Device camped on a network that has 5G capability (device doesn't have to be connected to a 5G cell as a secondary cell) but the use of 5G is restricted.\n\nThe configuration string contains multiple key-value pairs separated by commas.\nFor each pair, the key and value are separated by a colon. The keys in the\nconfiguration string correspond to the 5G scenarios described above\nand must be one of the following:\n\n1. `connected_mmwave`\n2. `connected`\n3. `not_restricted_rrc_idle`\n4. `not_restricted_rrc_con`\n5. `restricted`\n\nThe values in the configuration string must be valid icon names that match the\nnames of icons in the `/packages/SettingsLib/res/` directory. Two default icons\nfor 5G NSA are available: `5G` and `5G_PLUS`.\n\n**Figure 1.** Default 5G and 5G_PLUS 5G icons\n\nDisplay the 5G icons only for scenario 1 (`connected_mmwave`) and\nscenario 2 (`connected`), where the device has a true 5G connection. Use the\n`5G_PLUS` icon for scenario 1 and the `5G` icon for scenario 2. The\nfollowing is an example of a configuration string in `CarrierConfig`. \n\n connected_mmwave:5G_PLUS,connected:5G\n\n### System UI\n\nTo customize the icons that carriers can use for a specific status, add a\n`MobileIconGroup` object in\n[`TelephonyIcons.java`](https://cs.android.com/android/platform/superproject/+/android-latest-release:frameworks/base/packages/SettingsLib/src/com/android/settingslib/mobile/TelephonyIcons.java).\nThe icon name in `MobileIconGroup` must match the icon name used in\n`CarrierConfig`. The following shows an example of how to add a customized icon\nwith the name \"5G_PLUS\" to `MobileIconGroup`. \n\n static final MobileIconGroup NR_5G_PLUS = new MobileIconGroup(\n \"5G_PLUS\",\n null,\n null,\n AccessibilityContentDescriptions.PHONE_SIGNAL_STRENGTH,\n 0,\n 0,\n 0,\n 0,\n\n AccessibilityContentDescriptions.PHONE_SIGNAL_STRENGTH[0],\n R.string.data_connection_5g_plus,\n TelephonyIcons.ICON_5G_PLUS,\n true);\n\nValidation\n----------\n\nTo validate your implementation, make sure a 5G icon is displayed on the status\nbar when the device is connected to a 5G cell."]]