eSIM 및 SIM 카드 감지
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
SIM 카드와 eSIM이 있는 Android 지원 기기는 TelephonyManager
및 SubscriptionManager
을 비롯한 전화 통신 API에서 다음 ID를 사용합니다.
- 구독 ID: 모바일 구독을 위한 고유 ID.
- 논리 슬롯 색인 또는 ID: 논리 SIM 슬롯을 참조하는 고유 색인.
논리 슬롯 ID는 0에서 시작하며 기기에서 지원되는 활성 슬롯 수에 따라 증가합니다. 예를 들어 듀얼 SIM 기기에는 일반적으로 슬롯 0과 슬롯 1이 있습니다. 기기에 실물 슬롯이 여러 개 있지만 활성 슬롯을 하나만 지원하는 경우 논리 슬롯 ID는 0입니다.
- 물리적 슬롯 인덱스 또는 ID: 실물 SIM 슬롯을 나타내는 고유 인덱스.
실제 슬롯 ID는 0에서 시작하여 기기의 실제 슬롯 수에 따라 증가합니다. 이는 기기에 있는 논리 슬롯의 수와는 다르며, 이는 기기에서 사용할 수 있는 활성 슬롯의 수에 해당합니다. 예를 들어 듀얼 SIM과 단일 SIM 모드 간에 전환하는 기기에는 항상 물리적인 슬롯이 두 개 있을 수 있지만, 단일 SIM 모드에서는 논리 슬롯이 하나만 있습니다.
- 카드 ID: UiccCard를 식별하는 데 사용하는 고유 ID.

위 다이어그램에서 각 항목의 의미는 다음과 같습니다.
- 기기에는 두 개의 논리 슬롯이 있습니다.
- 물리적 슬롯 0에는 활성 프로필이 있는 물리적 UICC 카드가 있습니다.
- 물리적 슬롯 2는 활성 프로필이 있는 eUICC입니다.
- 실제 슬롯 1은 현재 사용되지 않습니다.

위 다이어그램에서 각 항목의 의미는 다음과 같습니다.
- 기기에는 세 개의 논리 슬롯이 있습니다.
- 물리적 슬롯 0에는 활성 프로필이 있는 물리적 UICC 카드가 있습니다.
- 실제 슬롯 1은 다운로드된 프로필이 두 개 있는 eUICC이며 둘 다 MEP (다중 지원 프로필)를 사용하여 활성 상태입니다.
OMAPI (Open Mobile API) 리더 지원
Android 11 이상에서는 OMAPI (Open Mobile API)를 통해 다음 플래그가 있는 기기에서 eSE, SD, UICC 지원 하드웨어를 확인할 수 있습니다.
이 값을 getSystemAvailableFeatures()
또는 hasSystemFeature()
와 함께 사용하여 기기 지원 여부를 확인하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-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-07-27(UTC)"],[],[],null,["# Detect eSIMs and SIM cards\n\nAndroid-powered devices with SIM cards and eSIMs use the following IDs in the telephony\nAPIs, including\n[`TelephonyManager`](/reference/android/telephony/TelephonyManager) and\n[`SubscriptionManager`](/reference/android/telephony/SubscriptionManager):\n\n- Subscription ID: unique ID for a mobile subscription.\n- Logical slot index or ID: unique index referring to a logical SIM slot. Logical slot IDs start at 0 and go up depending on the number of supported active slots on a device. For example, a dual-SIM device typically has slot 0 and slot 1. If a device has multiple physical slots but only supports one active slot, it will have only the logical slot ID 0.\n- Physical slot index or ID: unique index referring to a physical SIM slot. Physical slot IDs start at 0 and go up depending on the number of physical slots on the device. This differs from the number of logical slots a device has, which corresponds to the number of active slots a device is capable of using. For example, a device which switches between dual-SIM and single-SIM mode may always have two physical slots, but in single-SIM mode it will have only one logical slot.\n- Card ID: unique ID used to identify a UiccCard.\n\nIn the preceding diagram:\n\n- The device has two logical slots.\n- In physical slot 0 there is a physical UICC card with an active profile.\n- In physical slot 2 is an eUICC with an active profile.\n- Physical slot 1 is not currently in use.\n\nIn the preceding diagram:\n\n- The device has three logical slots.\n- In physical slot 0 there is a physical UICC card with an active profile.\n- In physical slot 1 is an eUICC that has two downloaded profiles, both active using MEP (Multiple Enabled Profiles).\n\nOpen Mobile API (OMAPI) reader support\n--------------------------------------\n\nOn Android 11 and higher, Open Mobile API (OMAPI) supports checking for eSE, SD,\nand UICC support hardware on devices with the following flags:\n\n- [`FEATURE_SE_OMAPI_ESE`](/reference/android/content/pm/PackageManager#FEATURE_SE_OMAPI_ESE)\n- [`FEATURE_SE_OMAPI_SD`](/reference/android/content/pm/PackageManager#FEATURE_SE_OMAPI_SD)\n- [`FEATURE_SE_OMAPI_UICC`](/reference/android/content/pm/PackageManager#FEATURE_SE_OMAPI_UICC)\n\nUse these values with\n[`getSystemAvailableFeatures()`](/reference/android/content/pm/PackageManager#getSystemAvailableFeatures())\nor\n[`hasSystemFeature()`](/reference/android/content/pm/PackageManager#hasSystemFeature(java.lang.String))\nto check for device support."]]