Android/frameworks_base
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge "Update CellInfo Documentation on Updates"

Browse Source
This commit is contained in:
Nathan Harold
2019-02-08 01:24:22 +00:00
committed by Gerrit Code Review
parent fde347156d 1aee57aaf1
commit f199334e3e
1 changed files with 5 additions and 4 deletions
Download Patch File Download Diff File Expand all files Collapse all files

9
telephony/java/android/telephony/TelephonyManager.java
View File

@@ -4866,12 +4866,13 @@ public class TelephonyManager {
* *
* <p>Apps targeting {@link android.os.Build.VERSION_CODES#Q Android Q} or higher will no * <p>Apps targeting {@link android.os.Build.VERSION_CODES#Q Android Q} or higher will no
* longer trigger a refresh of the cached CellInfo by invoking this API. Instead, those apps * longer trigger a refresh of the cached CellInfo by invoking this API. Instead, those apps
* will receive the latest cached results. Apps targeting * will receive the latest cached results, which may not be current. Apps targeting
* {@link android.os.Build.VERSION_CODES#Q Android Q} or higher that wish to request updated * {@link android.os.Build.VERSION_CODES#Q Android Q} or higher that wish to request updated
* CellInfo should call * CellInfo should call
* {android.telephony.TelephonyManager#requestCellInfoUpdate requestCellInfoUpdate()} and * {@link android.telephony.TelephonyManager#requestCellInfoUpdate requestCellInfoUpdate()};
* listen for responses via {@link android.telephony.PhoneStateListener#onCellInfoChanged * however, in all cases, updates will be rate-limited and are not guaranteed. To determine the
* onCellInfoChanged()}. * recency of CellInfo data, callers should check
* {@link android.telephony.CellInfo#getTimeStamp CellInfo#getTimeStamp()}.
* *
* <p>This method returns valid data for devices with * <p>This method returns valid data for devices with
* {@link android.content.pm.PackageManager#FEATURE_TELEPHONY FEATURE_TELEPHONY}. In cases * {@link android.content.pm.PackageManager#FEATURE_TELEPHONY FEATURE_TELEPHONY}. In cases