اعتبارًا من 27 آذار (مارس) 2025، ننصحك باستخدام android-latest-release بدلاً من aosp-main لإنشاء AOSP والمساهمة فيه. لمزيد من المعلومات، يُرجى الاطّلاع على التغييرات في AOSP.
إعداد تقارير قوة الإشارة
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يُبلغ إطار عمل الهاتف عن قوة إشارة الشبكة الخلوية باستخدام
أنواع مختلفة من قياسات الإشارة. يمكنك بعد ذلك استخدام مستويات قوة الإشارة المسجّلة هذه للتحكّم في كيفية عرض أشرطة الإشارة على جهازك وتخصيص معايير إعداد تقارير مستويات
قوة الإشارة من المودم. بدءًا من الإصدار
11 من نظام التشغيل Android، يمكنك تخصيص
أنواع متعددة من قياسات الإشارة التي يستخدمها إطار العمل للإبلاغ عن قوة
الإشارة لشبكات الوصول اللاسلكي (RAN) لشبكات 4G LTE و5G NR.
يستخدم إطار العمل ثلاث وظائف للإبلاغ عن قوة الإشارة: معايير الإبلاغ عن
قوة الإشارة، وحدود قوة الإشارة، ومستويات الإشارة.
تؤثر هذه الوظائف في طريقة تواصل Android مع جهاز المودم، على سبيل المثال، منع المودم من الإبلاغ عن قوة الإشارة غير الضرورية لتقليل استخدام
الطاقة وتحسين حالة النظام. يتم تعريف الدوالّ على النحو التالي:
- معايير إعداد تقارير قوة الإشارة: الشروط التي حدّدها نظام Android لبدء إعداد تقارير قوة الإشارة من المودم
- الحدود الدنيا لقوة الإشارة: قائمة بأربعة أعداد صحيحة تُستخدَم لاقتراح معايير إعداد تقارير
مستوى الإشارة وقوة الإشارة.
- مستويات الإشارة: خمسة مستويات (
NONE وPOOR وMODERATE وGOOD وGREAT)
تتوافق مع قوة الإشارة.
إتاحة أنواع متعددة لقياس الإشارات
بالنسبة إلى الأجهزة التي تعمل بالإصدار 11 من Android أو إصدار أحدث، يمكن تخصيص
أنواع قياس الإشارة التالية
لشبكتَي NGRAN (LTE 5G) وEUTRAN (LTE 4G). تُستخدَم هذه القياسات لمعايير إعداد تقارير قوة الإشارة، وحدود قياس قوة الإشارة، ووظائف مستويات الإشارة.
- NGRAN (5G NR): SSRSRP وSSRSRQ وSSSINR
- EUTRAN (4G LTE): RSRP وRSRQ وRSSNR
التنفيذ
لتفعيل الجهاز على ضبط معايير إعداد تقارير قوة الإشارة لكل شبكة أساسية للاتصالات الراديوية،
نفِّذ واجهة الأجهزة
setSignalStrengthReportingCriteria_1_5. لكل شبكة أساسية للاتصالات الجوّالة، هناك عدة أنواع مقبولة لقياس الإشارة. إذا لم يتم تفعيل أيّ من معايير إعداد التقارير لنوع قياس معيّن
لشبكة RAN، يتم تحديد معايير إعداد التقارير لشبكة RAN هذه من خلال إطار عمل Android. عند تفعيل معايير إعداد التقارير لنوع قياس معيّن لجدول اتّباع الأداء (RAN)، يتم إيقاف معايير إعداد التقارير لأنواع القياس الأخرى.
لتحديد الحدود الدنيا لقوة الإشارة في شبكات 4G و5G، استخدِم
مفاتيح إعدادات مشغّل شبكة الجوّال التالية:
لاختيار قياسات متعددة لشبكة RAN، استخدِم مفاتيح إعدادات مشغّل شبكة الجوَّال التالية:
التحقُّق
للتحقّق من صحة عملية التنفيذ، استخدِم اختبار
testGetConfig
CTS في
CarrierConfigManagerTest.
استخدِم VTS للاختبار
setSignalStrengthReportingCriteria_1_5_*.
يخضع كل من المحتوى وعيّنات التعليمات البرمجية في هذه الصفحة للتراخيص الموضحّة في ترخيص استخدام المحتوى. إنّ Java وOpenJDK هما علامتان تجاريتان مسجَّلتان لشركة Oracle و/أو الشركات التابعة لها.
تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 2025-07-27 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# Signal strength reporting\n\nThe telephony framework reports cellular network signal strength using various\nsignal measurement types. You can then use these reported signal strengths to\ncontrol how signal bars are displayed on your device and customize the signal\nstrength reporting criteria from the modem. Starting from Android\n11, you can customize\nmultiple signal measurement types that the framework uses to report the signal\nstrength of 4G LTE and 5G NR radio access networks (RANs).\n\nThe framework uses three functions for reporting signal strength: signal\nstrength reporting criteria, signal strength thresholds, and signal levels.\nThese functions affect how Android communicates with the modem hardware, for\nexample, preventing unnecessary signal strength reporting by the modem to reduce\npower usage and improve system health. The functions are defined as:\n\n- **Signal strength reporting criteria:** The conditions defined by Android to trigger signal strength reporting from the modem.\n- **Signal strength thresholds:** A list of four integers used for suggesting signal level and signal strength reporting criteria.\n- **Signal levels:** Five levels (`NONE`, `POOR`, `MODERATE`, `GOOD`, `GREAT`) that correspond to signal strength.\n\nSupport for multiple signal measurement types\n---------------------------------------------\n\nFor devices running Android 11 or higher, the\nfollowing signal measurement types\nare customizable for NGRAN (5G LTE) and EUTRAN (4G LTE) networks. These\nmeasurements are used for the signal strength reporting criteria, signal\nstrength thresholds, and signal levels functions.\n\n- **NGRAN (5G NR):** SSRSRP, SSRSRQ, SSSINR\n- **EUTRAN (4G LTE):** RSRP, RSRQ, RSSNR\n\nImplementation\n--------------\n\nTo enable the device to set the signal strength reporting criteria for each RAN,\nimplement the\n[`setSignalStrengthReportingCriteria_1_5`](https://android.googlesource.com/platform/hardware/interfaces/+/refs/heads/android16-release/radio/1.5/IRadio.hal#68)\nhardware interface. For each RAN, multiple signal measurement types are\nsupported. If none of the reporting criteria for a measurement type is enabled\nfor a RAN, the reporting criteria for that RAN is defined by the Android\nframework. When the reporting criteria of a measurement type is enabled for a\nRAN, the reporting criteria of other measurement types are disabled.\n\nTo define the signal strength thresholds for 4G and 5G networks, use the\nfollowing carrier config keys:\n\n- [`KEY_5G_NR_SSRSRP_THRESHOLDS_INT_ARRAY`](https://developer.android.com/reference/android/telephony/CarrierConfigManager#KEY_5G_NR_SSRSRP_THRESHOLDS_INT_ARRAY)\n- [`KEY_5G_NR_SSRSRQ_THRESHOLDS_INT_ARRAY`](https://developer.android.com/reference/android/telephony/CarrierConfigManager#KEY_5G_NR_SSRSRQ_THRESHOLDS_INT_ARRAY)\n- [`KEY_5G_NR_SSSINR_THRESHOLDS_INT_ARRAY`](https://developer.android.com/reference/android/telephony/CarrierConfigManager#KEY_5G_NR_SSSINR_THRESHOLDS_INT_ARRAY)\n- [`KEY_LTE_RSRQ_THRESHOLDS_INT_ARRAY`](https://developer.android.com/reference/android/telephony/CarrierConfigManager#KEY_LTE_RSRQ_THRESHOLDS_INT_ARRAY)\n- [`KEY_LTE_RSSNR_THRESHOLDS_INT_ARRAY`](https://developer.android.com/reference/android/telephony/CarrierConfigManager#KEY_LTE_RSSNR_THRESHOLDS_INT_ARRAY)\n\nTo select multiple measurements for a RAN, use the following carrier config\nkeys:\n\n- [`KEY_PARAMETERS_USED_FOR_LTE_SIGNAL_BAR_INT`](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/telephony/java/android/telephony/CarrierConfigManager.java#2379)\n- [`KEY_PARAMETERS_USE_FOR_5G_NR_SIGNAL_BAR_INT`](https://android.googlesource.com/platform/frameworks/base/+/refs/heads/android16-release/telephony/java/android/telephony/CarrierConfigManager.java#2461)\n\nValidation\n----------\n\nTo validate your implementation, use the\n[`testGetConfig`](https://android.googlesource.com/platform/cts/+/112b1be/tests/tests/telephony/src/android/telephony/cts/CarrierConfigManagerTest.java#70)\nCTS test in\n[`CarrierConfigManagerTest`](https://android.googlesource.com/platform/cts/+/112b1be/tests/tests/telephony/src/android/telephony/cts/CarrierConfigManagerTest.java).\nUse [VTS](/docs/core/tests/vts) for testing\n`setSignalStrengthReportingCriteria_1_5_*`."]]
