eUICC एपीआई की गड़बड़ियां मैनेज करना

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

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

जब eUICC एपीआई को कॉल करते समय कोई गड़बड़ी होती है, तो 'मंज़ूरी बाकी है' कॉलबैक दिया जाता है. साथ ही, ज़्यादा जानकारी वाला गड़बड़ी कोड पाने के लिए, 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 के साथ इस्तेमाल किया जाता है, जो जीएसएमए (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.
}

इस्तेमाल किए जा सकने वाले ऑपरेशन और गड़बड़ी कोड के कॉम्बिनेशन

नीचे दी गई टेबल में, स्थानीय प्रोफ़ाइल असिस्टेंट (एलपीए) से मिले ऑपरेशन और गड़बड़ी कोड के काम करने वाले कॉम्बिनेशन के बारे में बताया गया है.