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

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

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

eUICC API কল করার সময় কোনো ত্রুটি ঘটলে, একটি পেন্ডিং ইন্টেন্ট কলব্যাক প্রদান করা হয় এবং বিস্তারিত ত্রুটি কোড পাওয়ার জন্য EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE কে কী (key) হিসেবে ব্যবহার করা হয়। অ্যান্ড্রয়েড ১১ থেকে, ফলাফলস্বরূপ ইন্টেন্টটিতে নিম্নলিখিত চারটি কী এবং ভ্যালু অন্তর্ভুক্ত থাকে:

• 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) থেকে প্রাপ্ত সমর্থিত অপারেশন সংমিশ্রণ এবং ত্রুটি কোডগুলি বর্ণনা করা হয়েছে।