eUICC API की गड़बड़ियां ठीक करना

eUICC API, गड़बड़ी कोड उपलब्ध कराते हैं. इनसे ऐप्लिकेशन और उपयोगकर्ताओं को, eSIM प्रोफ़ाइल डाउनलोड करने, चालू करने, बंद करने, और मिटाने से जुड़ी समस्याओं को हल करने में मदद मिलती है.

गड़बड़ियां ठीक करना

eUICC API को कॉल करते समय कोई गड़बड़ी होने पर, एक पेंडिंग इंटेंट कॉलबैक दिया जाता है. साथ ही, गड़बड़ी के बारे में ज़्यादा जानकारी देने वाले कोड को पाने के लिए, EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE का इस्तेमाल किया जाता है. Android 11 से, नतीजे के तौर पर मिले इंटेंट में ये चार कुंजियां और वैल्यू शामिल होती हैं:

• EXTRA_EMBEDDED_SUBSCRIPTION_OPERATION_CODE: इससे यह पता चलता है कि क्या गड़बड़ी हुई है. उदाहरण के लिए, ई-सिम प्रोफ़ाइल डाउनलोड या मिटाना. इस फ़ील्ड को कभी खाली नहीं छोड़ा जाता.

• 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 हो.

इन चार वैल्यू की मदद से, eUICC API को कॉल करने वाला व्यक्ति, किसी गड़बड़ी को अलग-अलग तरीके से ठीक कर सकता है. इन गड़बड़ियों को ठीक करने का तरीका यहां दिया गया है.

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.
}

कार्रवाई और गड़बड़ी के कोड के कॉम्बिनेशन

इस टेबल में, एलपीए से मिले ऑपरेशन और गड़बड़ी के कोड के बारे में बताया गया है.