معالجة أخطاء eUICC API

توفّر واجهات برمجة تطبيقات eUICC رموز خطأ لمساعدة التطبيقات والمستخدمين في تحديد وحلّ المشاكل المتعلّقة بتنزيل الملفات الشخصية لشرائح eSIM وتفعيلها وإيقافها وحذفها.

معالجة الأخطاء

عند حدوث خطأ أثناء الاتصال بواجهة برمجة التطبيقات eUICC API، يتم تقديم callback للطلب في انتظار المراجعة و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، اللذان يقدّمان معًا SubjectCode[5.2.6.1] وreasonCode[5.2.6.2] من بروتوكول GSMA (SGP.22 v2.2). لا تتم تعبئة هذا الحقل إلا عندما يكون رمز العملية هو OPERATION_SMDX_SUBJECT_REASON_CODE.

• ‫EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_REASON_CODE: يُستخدَم مع EXTRA_EMBEDDED_SUBSCRIPTION_SMDX_SUBJECT_CODE، اللذان يقدّمان معًا SubjectCode[5.2.6.1] وReasonCode[5.2.6.2] من GSMA (SGP.22 v2.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).