TelephonyManager.AllCellInfo 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
请求设备上所有无线电的所有可用单元格信息,包括已设置/已注册、服务单元和相邻单元格。
public virtual System.Collections.Generic.IList<Android.Telephony.CellInfo>? AllCellInfo { [Android.Runtime.Register("getAllCellInfo", "()Ljava/util/List;", "GetGetAllCellInfoHandler")] [Android.Runtime.RequiresPermission("android.permission.ACCESS_FINE_LOCATION")] get; }
[<get: Android.Runtime.Register("getAllCellInfo", "()Ljava/util/List;", "GetGetAllCellInfoHandler")>]
[<get: Android.Runtime.RequiresPermission("android.permission.ACCESS_FINE_LOCATION")>]
member this.AllCellInfo : System.Collections.Generic.IList<Android.Telephony.CellInfo>
属性值
android.telephony.CellInfo
的列表;如果单元格信息不可用,则为 null。
- 属性
注解
请求设备上所有无线电的所有可用单元格信息,包括已设置/已注册、服务单元和相邻单元格。
响应可以包含任意组合中的一个或多个 android.telephony.CellInfoGsm CellInfoGsm
、 android.telephony.CellInfoCdma CellInfoCdma
、 android.telephony.CellInfoTdscdma CellInfoTdscdma
、 android.telephony.CellInfoLte CellInfoLte
和 android.telephony.CellInfoWcdma CellInfoWcdma
对象。 通常,在列表中查看其中一个或多个实例。 此外,零个或多个返回的对象可能被视为已注册;也就是说,其 android.telephony.CellInfo#isRegistered CellInfo.isRegistered()
方法可能返回 true,指示单元格正在使用或将在必要时用于信号通信。
从 android.os.Build.VERSION_CODES#Q Android Q
开始,如果此 API 导致缓存的 CellInfo 发生更改,将通过 报告 android.telephony.PhoneStateListener#onCellInfoChanged onCellInfoChanged()
该更改。
面向 android.os.Build.VERSION_CODES#Q Android Q
或更高版本的应用将不再通过调用此 API 来触发缓存的 CellInfo 刷新。 相反,这些应用将收到最新的缓存结果,这些结果可能不是最新的。 希望 android.os.Build.VERSION_CODES#Q Android Q
请求更新 CellInfo 的目标应用或更高版本的应用应调用 android.telephony.TelephonyManager#requestCellInfoUpdate requestCellInfoUpdate()
;但是,在所有情况下,更新将受到速率限制,并且不能保证。 若要确定 CellInfo 数据的时效性,调用方应检查 android.telephony.CellInfo#getTimeStamp CellInfo#getTimeStamp()
。
此方法返回具有 android.content.pm.PackageManager#FEATURE_TELEPHONY FEATURE_TELEPHONY
的设备的有效数据。 如果特定 CellInfo 条目仅提供部分信息,则不可用的字段将报告为 android.telephony.CellInfo#UNAVAILABLE
。 所有报告的单元格将至少包含一组有效的特定于技术的标识信息和功率级别测量。
此方法优先于使用 android.telephony.TelephonyManager#getCellLocation getCellLocation()
。
的 android.telephony.TelephonyManager.getAllCellInfo()
Java 文档。
此页面的某些部分是基于 创建和共享的工作进行的修改,并根据 署名许可中所述的条款使用。