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

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

गड़बड़ियों को हैंडल करना

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

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

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

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