2025 年 3 月 27 日より、AOSP のビルドとコントリビューションには aosp-main
ではなく android-latest-release
を使用することをおすすめします。詳細については、AOSP の変更をご覧ください。
信号強度レポート
コレクションでコンテンツを整理
必要に応じて、コンテンツの保存と分類を行います。
テレフォニー フレームワークは、さまざまな信号測定タイプを使用して、モバイルデータ ネットワークの信号強度をレポートします。レポートされた信号強度を利用することで、デバイス上の信号バーの表示方法を制御し、モデムの信号強度レポート基準をカスタマイズできます。Android 11 以降では、フレームワークが使用する各種の信号測定タイプをカスタマイズして、4G LTE および 5G NR の無線アクセス ネットワーク(RAN)の信号強度をレポートできます。
フレームワークは、信号強度をレポートする際、信号強度レポート基準、信号強度しきい値、信号レベルという 3 つの機能を使用します。この 3 つの機能は、Android とモデム ハードウェア間の通信方法に影響します。たとえば、モデムによる不必要な信号強度レポートを抑制することで、電力消費量を削減し、システムの健全性を高めることができます。各機能は次のように定義されます。
- 信号強度レポート基準: Android によって定義される、モデムの信号強度レポートをトリガーする条件。
- 信号強度しきい値: 信号レベルと信号強度レポート基準を提案する際に使用される 4 つの整数のリスト。
- 信号レベル: 信号強度を示す 5 つのレベル(
NONE
、POOR
、MODERATE
、GOOD
、GREAT
)。
複数の信号測定タイプのサポート
Android 11 以上を搭載したデバイスの場合、NGRAN(5G LTE)ネットワークと EUTRAN(4G LTE)ネットワーク向けに、以下の信号測定タイプをカスタマイズできます。各測定値は、3 つの機能(信号強度レポート基準、信号強度しきい値、信号レベル)で使用されます。
- NGRAN(5G NR): SSRSRP、SSRSRQ、SSSINR
- EUTRAN(4G LTE): RSRP、RSRQ、RSSNR
実装
各 RAN 用の信号強度レポート基準をデバイスで設定できるようにするには、setSignalStrengthReportingCriteria_1_5
ハードウェア インターフェースを実装します。RAN ごとに、複数の信号測定タイプがサポートされています。測定タイプのいずれのレポート基準も RAN に対して有効になっていない場合、その RAN 用のレポート基準は Android フレームワークによって定義されます。測定タイプのレポート基準が RAN に対して有効になっている場合、他の測定タイプのレポート基準は無効になります。
4G ネットワークおよび 5G ネットワークの信号強度しきい値を定義するには、以下の携帯通信会社構成キーを使用します。
RAN に対して複数の測定値を選択するには、以下の携帯通信会社構成キーを使用します。
検証
実装を検証するには、CarrierConfigManagerTest
の testGetConfig
CTS テストを使用します。setSignalStrengthReportingCriteria_1_5_*
をテストするには、VTS を使用します。
このページのコンテンツやコードサンプルは、コンテンツ ライセンスに記載のライセンスに従います。Java および OpenJDK は Oracle および関連会社の商標または登録商標です。
最終更新日 2025-03-26 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-03-26 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_*`."]]