ตั้งแต่วันที่ 27 มีนาคม 2025 เป็นต้นไป เราขอแนะนำให้ใช้ android-latest-release แทน aosp-main เพื่อสร้างและมีส่วนร่วมใน AOSP โปรดดูข้อมูลเพิ่มเติมที่หัวข้อการเปลี่ยนแปลงใน AOSP
การรายงานความแรงของสัญญาณ
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
เฟรมเวิร์กโทรศัพท์จะรายงานความแรงของสัญญาณเครือข่ายมือถือโดยใช้การวัดสัญญาณประเภทต่างๆ จากนั้น คุณสามารถใช้ระดับสัญญาณที่รายงานเหล่านี้เพื่อควบคุมลักษณะที่แถบสัญญาณแสดงบนอุปกรณ์และปรับแต่งเกณฑ์การรายงานระดับสัญญาณจากโมเด็ม ตั้งแต่ Android 11 เป็นต้นไป คุณสามารถปรับแต่งการวัดสัญญาณหลายประเภทที่เฟรมเวิร์กใช้เพื่อรายงานความแรงของสัญญาณเครือข่ายเข้าถึงระบบวิทยุ (RAN) 4G LTE และ 5G NR
เฟรมเวิร์กนี้ใช้ฟังก์ชัน 3 รายการในการรายงานความแรงของสัญญาณ ได้แก่ เกณฑ์การรายงานความแรงของสัญญาณ เกณฑ์ความแรงของสัญญาณ และระดับสัญญาณ
ฟังก์ชันเหล่านี้ส่งผลต่อวิธีที่ Android สื่อสารกับฮาร์ดแวร์ของโมเด็ม เช่น การป้องกันไม่ให้โมเด็มรายงานความแรงของสัญญาณที่ไม่จำเป็นเพื่อลดการใช้พลังงานและปรับปรุงประสิทธิภาพของระบบ ฟังก์ชันจะกำหนดดังนี้
- เกณฑ์การรายงานความแรงของสัญญาณ: เงื่อนไขที่ Android กำหนดเพื่อทริกเกอร์การรายงานความแรงของสัญญาณจากโมเด็ม
- เกณฑ์ความแรงของสัญญาณ: รายการจำนวนเต็ม 4 รายการที่ใช้เพื่อแนะนำเกณฑ์การรายงานระดับสัญญาณและความแรงของสัญญาณ
- ระดับสัญญาณ: 5 ระดับ (
NONE, POOR, MODERATE, GOOD, GREAT) ที่สอดคล้องกับความแรงของสัญญาณ
รองรับการวัดสัญญาณหลายประเภท
สำหรับอุปกรณ์ที่ใช้ Android 11 ขึ้นไป คุณสามารถปรับแต่งประเภทการวัดสัญญาณต่อไปนี้สำหรับเครือข่าย NGRAN (5G LTE) และ EUTRAN (4G LTE) ได้ การวัดเหล่านี้ใช้สำหรับเกณฑ์การรายงานความแรงสัญญาณ เกณฑ์ความแรงสัญญาณ และฟังก์ชันระดับสัญญาณ
- NGRAN (5G NR): SSRSRP, SSRSRQ, SSSINR
- EUTRAN (4G LTE): RSRP, RSRQ, RSSNR
การใช้งาน
หากต้องการให้อุปกรณ์ตั้งค่าเกณฑ์การรายงานสัญญาณความแรงสำหรับ RAN แต่ละรายการ ให้ติดตั้งใช้งานsetSignalStrengthReportingCriteria_1_5
อินเทอร์เฟซฮาร์ดแวร์ ระบบรองรับการวัดสัญญาณหลายประเภทสำหรับ RAN แต่ละประเภท หากไม่มีการเปิดใช้เกณฑ์การรายงานสําหรับประเภทการวัดผลสําหรับ RAN ใดเลย เฟรมเวิร์ก Android จะกําหนดเกณฑ์การรายงานสําหรับ RAN นั้น เมื่อเปิดใช้เกณฑ์การรายงานของประเภทการวัดผลสําหรับ RAN ระบบจะปิดใช้เกณฑ์การรายงานของประเภทการวัดผลอื่นๆ
หากต้องการกำหนดเกณฑ์ความแรงของสัญญาณสำหรับเครือข่าย 4G และ 5G ให้ใช้คีย์การกําหนดค่าผู้ให้บริการต่อไปนี้
หากต้องการเลือกการวัดผลหลายรายการสําหรับ RAN ให้ใช้คีย์การกําหนดค่าผู้ให้บริการต่อไปนี้
การตรวจสอบความถูกต้อง
หากต้องการตรวจสอบการติดตั้งใช้งาน ให้ใช้การทดสอบ testGetConfig กับ CTS ใน CarrierConfigManagerTest
ใช้ VTS ในการทดสอบ
setSignalStrengthReportingCriteria_1_5_*
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2025-07-27 UTC
[[["เข้าใจง่าย","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 UTC"],[],[],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_*`."]]
