Kể từ ngày 27 tháng 3 năm 2025, bạn nên sử dụng android-latest-release thay vì aosp-main để xây dựng và đóng góp cho AOSP. Để biết thêm thông tin, hãy xem phần Thay đổi đối với AOSP.
Báo cáo cường độ tín hiệu
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Khung điện thoại báo cáo cường độ tín hiệu mạng di động bằng nhiều loại đo lường tín hiệu. Sau đó, bạn có thể sử dụng các cường độ tín hiệu được báo cáo này để kiểm soát cách các thanh tín hiệu hiển thị trên thiết bị và tuỳ chỉnh các tiêu chí báo cáo cường độ tín hiệu từ modem. Kể từ Android 11, bạn có thể tuỳ chỉnh nhiều loại đo lường tín hiệu mà khung này sử dụng để báo cáo cường độ tín hiệu của mạng truy cập vô tuyến (RAN) 4G LTE và 5G NR.
Khung này sử dụng 3 hàm để báo cáo cường độ tín hiệu: tiêu chí báo cáo cường độ tín hiệu, ngưỡng cường độ tín hiệu và mức tín hiệu.
Các hàm này ảnh hưởng đến cách Android giao tiếp với phần cứng modem, ví dụ: ngăn modem báo cáo cường độ tín hiệu không cần thiết để giảm mức sử dụng pin và cải thiện tình trạng hệ thống. Các hàm được xác định như sau:
- Tiêu chí báo cáo cường độ tín hiệu: Các điều kiện do Android xác định để kích hoạt tính năng báo cáo cường độ tín hiệu từ modem.
- Ngưỡng cường độ tín hiệu: Danh sách gồm 4 số nguyên dùng để đề xuất tiêu chí báo cáo cường độ tín hiệu và mức tín hiệu.
- Cấp độ tín hiệu: 5 cấp (
NONE, POOR, MODERATE, GOOD, GREAT) tương ứng với cường độ tín hiệu.
Hỗ trợ nhiều loại đo lường tín hiệu
Đối với các thiết bị chạy Android 11 trở lên, bạn có thể tuỳ chỉnh các loại đo lường tín hiệu sau đây cho mạng NGRAN (5G LTE) và EUTRAN (4G LTE). Các phép đo này được dùng cho tiêu chí báo cáo cường độ tín hiệu, ngưỡng cường độ tín hiệu và hàm mức tín hiệu.
- NGRAN (5G NR): SSRSRP, SSRSRQ, SSSINR
- EUTRAN (4G LTE): RSRP, RSRQ, RSSNR
Triển khai
Để cho phép thiết bị đặt tiêu chí báo cáo cường độ tín hiệu cho từng RAN, hãy triển khai giao diện phần cứng setSignalStrengthReportingCriteria_1_5. Đối với mỗi RAN, nhiều loại đo lường tín hiệu được hỗ trợ. Nếu không có tiêu chí báo cáo nào cho một loại đo lường được bật cho RAN, thì khung Android sẽ xác định tiêu chí báo cáo cho RAN đó. Khi bạn bật tiêu chí báo cáo của một loại phương pháp đo lường cho một RAN, tiêu chí báo cáo của các loại phương pháp đo lường khác sẽ bị tắt.
Để xác định ngưỡng cường độ tín hiệu cho mạng 4G và 5G, hãy sử dụng các khoá cấu hình nhà mạng sau:
Để chọn nhiều phép đo cho một RAN, hãy sử dụng các khoá cấu hình của nhà mạng sau:
Xác nhận kết quả
Để xác thực quá trình triển khai, hãy sử dụng quy trình kiểm thử CTS testGetConfig trong CarrierConfigManagerTest.
Sử dụng VTS để kiểm thử setSignalStrengthReportingCriteria_1_5_*.
Nội dung và mã mẫu trên trang này phải tuân thủ các giấy phép như mô tả trong phần Giấy phép nội dung. Java và OpenJDK là nhãn hiệu hoặc nhãn hiệu đã đăng ký của Oracle và/hoặc đơn vị liên kết của Oracle.
Cập nhật lần gần đây nhất: 2025-07-27 UTC.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 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_*`."]]
