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

कॉन्टेंट बनाने 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) से SubjectCode[5.2.6.1] और ReasonCode[5.2.6.2] की जानकारी दें वर्शन 2.2). यह फ़ील्ड सिर्फ़ तब भरता है, जब ऑपरेशन कोड OPERATION_SMDX_SUBJECT_REASON_CODE.

  • EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE: EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE के साथ इस्तेमाल किया जाता है. यह एक साथ इस्तेमाल होता है GSMA (SGP.22) से SubjectCode[5.2.6.1] और ReasonCode[5.2.6.2] की जानकारी दें वर्शन 2.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.
}

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

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

ऑपरेशन और गड़बड़ी के कोड के कॉम्बिनेशन
ऑपरेशन कोड गड़बड़ी कोड ब्यौरा
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 के लिए TLS कनेक्शन में उपयोग किए जाने पर कीस्टोर या प्रमाणपत्र त्रुटि पुष्टि करने के लिए.
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 मोबाइल और इंटरनेट सेवा देने वाली कंपनी ब्लैकलिस्ट में है और एलपीए यहां से प्रोफ़ाइल डाउनलोड नहीं कर सकता SM-DP+/SM-DS.
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 में गड़बड़ी हुई. उदाहरण के लिए, प्रोफ़ाइल आईसीसीआईडी पहले से मौजूद है या मैच नहीं करता.
ERROR_EUICC_INSUFFICIENT_MEMORY प्रोफ़ाइल इंस्टॉल करते समय eUICC में गड़बड़ी हुई. डिवाइस में ज़रूरत के मुताबिक मेमोरी नहीं है ईयूआईसीसी.
ERROR_DISALLOWED_BY_PPR प्रोफ़ाइल इंस्टॉल करते समय eUICC में गड़बड़ी हुई. अनुमति नहीं है प्रोफ़ाइल नीति का नियम.
OPERATION_APDU लागू नहीं APDU कार्रवाई करते समय कोई अंदरूनी गड़बड़ी हुई.
OPERATION_HTTP 1-999 गड़बड़ी का कोड, एचटीटीपी की गड़बड़ी वाली वैल्यू है.
ऑपरेशन कोड विषय का कोड वजह का कोड ब्यौरा
OPERATION_SMDX_SUBJECT_REASON_CODE स्ट्रिंग में बिंदु से अलग किए गए 3 अंक होते हैं और उनकी शुरुआत में शून्य का इस्तेमाल नहीं किया जाता. इसके लिए उदाहरण, 8.1.1. स्ट्रिंग में तीन अंक होते हैं और उन्हें बिंदु से अलग किया जाता है. इसकी शुरुआत में शून्य का इस्तेमाल नहीं किया जाता. इसके लिए उदाहरण, 3.8. GSMA (SGP.22 v2.2) की SubjectCode[5.2.6.1] और ReasonCode[5.2.6.2]. इसके लिए उदाहरण के लिए, 8.1.1 का SubjectCode और ReasonCode का 3.8 का मतलब ईआईडी होता है किसी अन्य डिवाइस से बाइंड किया गया हो.