eUICC API ত্রুটিগুলি পরিচালনা করুন৷

eUICC APIs অ্যাপ এবং ব্যবহারকারীদের eSIM প্রোফাইল ডাউনলোড, সক্ষম, অক্ষম এবং মুছে ফেলা সংক্রান্ত সমস্যা সমাধানে সহায়তা করার জন্য ত্রুটি কোড প্রদান করে।

ত্রুটিগুলি পরিচালনা করুন

eUICC API কল করার সময় একটি ত্রুটি ঘটলে, একটি মুলতুবি অভিপ্রায় কলব্যাক প্রদান করা হয় এবং বিস্তারিত ত্রুটি কোড পাওয়ার জন্য EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE কী হিসাবে ব্যবহৃত হয়৷ Android 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 এর সাথে ব্যবহার করা হয়, যা একসাথে সাবজেক্ট কোড[5.2.6.1] এবং ReasonCode [5.2.6.2] GSMA (v..2.S.) থেকে প্রদান করে। অপারেশন কোড OPERATION_SMDX_SUBJECT_REASON_CODE হলেই এই ক্ষেত্রটি পপুলেট করা হয়।

• EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE : EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE এর সাথে ব্যবহার করা হয়, যা একসাথে সাবজেক্ট কোড[5.2.6.1] এবং ReasonCode [5.2.6.2] GSMA (v2SGP) থেকে প্রদান করে। অপারেশন কোড 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.
}

সমর্থিত অপারেশন এবং ত্রুটি কোড সমন্বয়

নিম্নলিখিত সারণীটি স্থানীয় প্রোফাইল সহকারী (LPA) থেকে ফিরে আসা অপারেশন এবং ত্রুটি কোডগুলির সমর্থিত সংমিশ্রণ বর্ণনা করে।