خطاهای eUICC API را مدیریت کنید

رابط‌های برنامه‌نویسی کاربردی eUICC کدهای خطایی را ارائه می‌دهند تا به برنامه‌ها و کاربران در عیب‌یابی مشکلات مربوط به دانلود، فعال‌سازی، غیرفعال‌سازی و حذف پروفایل‌های eSIM کمک کنند.

مدیریت خطاها

وقتی هنگام فراخوانی eUICC API خطایی رخ می‌دهد، یک فراخوانی معکوس برای intent در حال انتظار ارائه می‌شود و EXTRA_EMBEDDED_SUBSCRIPTION_DETAILED_CODE به عنوان کلید دریافت کد خطای دقیق استفاده می‌شود. از اندروید ۱۱ به بعد، چهار کلید و مقدار زیر در intent حاصل گنجانده شده‌اند:

• 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) را شرح می‌دهد.