TelephonyManager.AllCellInfo 属性

定义

命名空间:

Android.Telephony

程序集:

Mono.Android.dll

从设备上的所有无线电请求所有可用的单元格信息，包括训练/注册、服务和邻近的单元格。

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>

属性值

IList<CellInfo>

如果单元格信息不可用，则为 android.telephony.CellInfonull。

属性

RegisterAttribute RequiresPermissionAttribute

注解

从设备上的所有无线电请求所有可用的单元格信息，包括训练/注册、服务和邻近的单元格。

响应可以包含任意组合中的一个或多个 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 开始，如果此 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 文档

本页的某些部分是根据 Android 开放源代码项目创建和共享的工作进行的修改，并根据 Creative Commons 2.5 属性许可证中所述的术语使用。