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

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

رسیدگی به خطاها

هنگامی که هنگام فراخوانی API eUICC خطایی رخ می دهد، یک تماس با هدف معلق ارائه می شود و 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.2.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.2.2) را ارائه می کنند. این فیلد فقط زمانی پر می شود که کد عملیات OPERATION_SMDX_SUBJECT_REASON_CODE باشد.

این چهار مقدار به تماس گیرنده API eUICC اجازه می دهد تا خطاهای خاص را به صورت جداگانه مدیریت کند. در زیر مثالی از نحوه رسیدگی به این خطاها آورده شده است.

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) را توضیح می دهد.