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

কাজ করে এমন অপারেশন ও ত্রুটি কোডের কম্বিনেশন

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