eUICC API ऐप्स और उपयोगकर्ताओं को eSIM प्रोफाइल डाउनलोड करने, सक्षम करने, अक्षम करने और हटाने से संबंधित समस्याओं का निवारण करने में मदद करने के लिए त्रुटि कोड प्रदान करता है।
त्रुटियों को संभालना
जब eUICC API को कॉल करते समय कोई त्रुटि होती है, तो एक लंबित इंटेंट कॉलबैक प्रदान किया जाता है और विस्तृत त्रुटि कोड प्राप्त करने के लिए EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE
कुंजी के रूप में उपयोग किया जाता है। एंड्रॉइड 11 से शुरू होकर, निम्नलिखित चार कुंजी और मान परिणामी इरादे में शामिल हैं:
-
EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE
: क्या गलत हुआ इसके बारे में जानकारी प्रदान करता है। उदाहरण के लिए, eSIM प्रोफ़ाइल डाउनलोड करना या हटाना। यह फ़ील्ड कभी खाली नहीं होती. EXTRA_EMBEDDED_SUBSCRIPTION_ERROR_CODE
: त्रुटि क्यों हुई इसके बारे में जानकारी। उदाहरण के लिए, अनुरोध का समय समाप्त हो गया है या डिवाइस वाहक लॉक हो गया है। यह फ़ील्ड निम्नलिखित मामलों में पॉप्युलेट नहीं है:- ऑपरेशन कोड
OPERATION_SMDX_SUBJECT_REASON_CODE
है। - त्रुटि एक निम्न-स्तरीय त्रुटि है जैसे
IOException
याInterruptedException
।
- ऑपरेशन कोड
EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE
:EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE
के साथ उपयोग किया जाता है, जो एक साथ GSMA (SGP.22 v2.2) से SubjectCode[5.2.6.1] और ReasonCode[5.2.6.2] प्रदान करते हैं। यह फ़ील्ड केवल तभी पॉप्युलेट होती है जब ऑपरेशन कोडOPERATION_SMDX_SUBJECT_REASON_CODE
होता है।EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE
:EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE
के साथ उपयोग किया जाता है, जो एक साथ GSMA (SGP.22 v2.2) से SubjectCode[5.2.6.1] और ReasonCode[5.2.6.2] प्रदान करते हैं। यह फ़ील्ड केवल तभी पॉप्युलेट होती है जब ऑपरेशन कोडOPERATION_SMDX_SUBJECT_REASON_CODE
होता है।
ये चार मान ईयूआईसीसी एपीआई के कॉलर को विशिष्ट त्रुटियों को व्यक्तिगत रूप से संभालने की अनुमति देते हैं। इन त्रुटियों से निपटने के तरीके का एक उदाहरण निम्नलिखित है।
int operationCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE)
int errorCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE)
String smdxSubjectCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE)
String smdxReasonCode = intent.get(EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE)
if (operationCode == OPERATION_DOWNLOAD && errorCode == ERROR_CARRIER_LOCKED) {
// handle specific error i.e. tries to download but the device is carrier locked
} else if (operationCode == OPERATION_SMDX) {
// handle all SM-DP+/SM-DS errors
} else if (errorCode == ERROR_TIME_OUT) {
// handle all types of time out issues, regardless of operation.
} else if ("8.1".equals(smdxSubjectCode) && "3.1".equals(smdxReasonCode)) {
// handle specific subject code and reason code: 8.1 and 4.1 means insufficient memory.
}
समर्थित संचालन और त्रुटि कोड संयोजन
निम्न तालिका स्थानीय प्रोफ़ाइल सहायक (एलपीए) से लौटाए गए ऑपरेशन और त्रुटि कोड के समर्थित संयोजन का वर्णन करती है।
संचालन और त्रुटि कोड संयोजन | |||
---|---|---|---|
ऑपरेशन कोड | त्रुटि कोड | विवरण | |
OPERATION_SYSTEM | लागू नहीं | एक आंतरिक त्रुटि हुई। उदाहरण के लिए, थ्रेड बाधित हो गया था या IOException त्रुटि उत्पन्न हुई। | |
OPERATION_SIM_SLOT | लागू नहीं | सिम स्लॉट संचालन करते समय एक आंतरिक त्रुटि उत्पन्न हुई। | |
ERROR_TIME_OUT | सिम स्लॉट संचालन करने का प्रयास करते समय समय समाप्त हो गया। | ||
ERROR_EUICC_MISSING | डिवाइस पर कोई eUICC उपलब्ध या सक्रिय नहीं है। | ||
OPERATION_EUICC_CARD | लागू नहीं | eUICC ऑपरेशन करते समय एक आंतरिक त्रुटि उत्पन्न हुई। | |
ERROR_UNSUPPORTED_VERSION | eUICC (चिप) संस्करण और EuiccCard (सॉफ़्टवेयर) संस्करण संगत नहीं हैं। | ||
ERROR_EUICC_MISSING | डिवाइस में कोई सिम कार्ड उपलब्ध नहीं है. उदाहरण के लिए, एलपीए सिम कार्ड का पता नहीं लगा सकता। | ||
OPERATION_SMDX | लागू नहीं | SM-DP+/SM-DS ऑपरेशन करते समय एक आंतरिक त्रुटि उत्पन्न हुई। | |
ERROR_ADDRESS_MISSING | प्रोफ़ाइल डाउनलोड करने के लिए कोई SM-DP+ पता नहीं। | ||
ERROR_INVALID_CONFIRMATION_CODE | सक्रियण कोड (अमान्य प्रारूप) को पार्स करते समय एक त्रुटि उत्पन्न हुई। | ||
ERROR_CERTIFICATE_ERROR | सत्यापन के लिए टीएलएस कनेक्शन में उपयोग किए जाने पर कीस्टोर या प्रमाणपत्र त्रुटि। | ||
ERROR_NO_PROFILES_AVAILABLE | SM-DP+ से कोई प्रोफ़ाइल उपलब्ध नहीं है। | ||
ERROR_CONNECTION_ERROR | सर्वर से कनेक्शन नहीं बनाया जा सकता. | ||
ERROR_INVALID_RESPONSE | SM-DP+/SM-DS सर्वर से अमान्य प्रतिक्रिया। | ||
OPERATION_SWITCH | लागू नहीं | स्विच ऑपरेशन करते समय एक आंतरिक त्रुटि उत्पन्न हुई। | |
ERROR_CARRIER_LOCKED | प्रोफ़ाइल स्विच करने की अनुमति नहीं है क्योंकि डिवाइस कैरियर लॉक (सिम लॉक) है। | ||
OPERATION_DOWNLOAD | लागू नहीं | डाउनलोड कार्रवाई करते समय एक आंतरिक त्रुटि उत्पन्न हुई। | |
ERROR_DISALLOWED_BY_PPR | eUICC पर नियम प्राधिकरण तालिका शून्य है या प्रोफ़ाइल नीति नियम द्वारा डाउनलोड की अनुमति नहीं है। | ||
ERROR_INVALID_ACTIVATION_CODE | सक्रियण कोड (अमान्य प्रारूप) को पार्स करते समय या बिना किसी सक्रियण कोड के डाउनलोड करने का प्रयास करते समय एक त्रुटि उत्पन्न हुई। | ||
ERROR_CARRIER_LOCKED | डाउनलोड करने की अनुमति नहीं है क्योंकि डिवाइस कैरियर लॉक (सिम लॉक) है। | ||
ERROR_INCOMPATIBLE_CARRIER | वाहक काली सूची में है और एलपीए एसएम-डीपी+/एसएम-डीएस से प्रोफ़ाइल डाउनलोड नहीं कर सकता है। | ||
ERROR_OPERATION_BUSY | प्रोफ़ाइल डाउनलोड प्रगति पर है और सिम स्थिति में बदलाव लाने वाली किसी भी अन्य कार्रवाई की अनुमति नहीं है। | ||
OPERATION_METADATA | लागू नहीं | मेटाडेटा ऑपरेशन करते समय एक आंतरिक त्रुटि उत्पन्न हुई। | |
ERROR_INVALID_ACTIVATION_CODE | सदस्यता मेटाडेटा खाली है या सदस्यता मेटाडेटा के अंदर सक्रियण कोड खाली या अमान्य है। | ||
ERROR_INCOMPATIBLE_CARRIER | वाहक काली सूची में है और एलपीए इस वाहक की प्रोफ़ाइल को SM-DP+/SM-DS से डाउनलोड नहीं कर सकता है। | ||
OPERATION_EUICC_GSMA | लागू नहीं | eUICC GSMA ऑपरेशन करते समय एक आंतरिक त्रुटि उत्पन्न हुई। | |
ERROR_INSTALL_PROFILE | प्रोफ़ाइल स्थापित करने का प्रयास करते समय eUICC में त्रुटि। उदाहरण के लिए, प्रोफ़ाइल पहले से मौजूद है या ICCID मेल नहीं खाता है। | ||
ERROR_EUICC_INSUFFICIENT_MEMORY | प्रोफ़ाइल स्थापित करने का प्रयास करते समय eUICC में त्रुटि। eUICC पर पर्याप्त मेमोरी नहीं है. | ||
ERROR_DISALLOWED_BY_PPR | प्रोफ़ाइल स्थापित करने का प्रयास करते समय eUICC में त्रुटि। प्रोफ़ाइल नीति नियम द्वारा अनुमति नहीं है. | ||
OPERATION_APDU | लागू नहीं | APDU ऑपरेशन करते समय एक आंतरिक त्रुटि उत्पन्न हुई। | |
OPERATION_HTTP | 1-999 | त्रुटि कोड एक HTTP त्रुटि मान है. | |
ऑपरेशन कोड | विषय कोड | कारण कोड | विवरण |
OPERATION_SMDX_SUBJECT_REASON_CODE | स्ट्रिंग में बिंदु द्वारा अलग किए गए 3 अंक हैं, जिसमें कोई अग्रणी शून्य नहीं है। उदाहरण के लिए, 8.1.1 . | स्ट्रिंग में बिंदु द्वारा अलग किए गए 3 अंक हैं जिनमें कोई अग्रणी शून्य नहीं है। उदाहरण के लिए, 3.8 . | जीएसएमए (एसजीपी.22 वी2.2) से सब्जेक्टकोड[5.2.6.1] और रीज़नकोड[5.2.6.2]। उदाहरण के लिए, 8.1.1 का सब्जेक्टकोड और 3.8 का रीज़नकोड का मतलब है कि ईआईडी किसी अन्य डिवाइस से जुड़ा हुआ है। |