TelephonyManager.AllCellInfo Eigenschaft

Definition

Namespace:

Android.Telephony

Assembly:

Mono.Android.dll

Fordert alle verfügbaren Zellinformationen von allen Radios auf dem Gerät an, einschließlich der gelagerten/registrierten, dienenden und benachbarten Zellen.

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>

Eigenschaftswert

IList<CellInfo>

Liste von android.telephony.CellInfo; NULL, wenn Zellinformationen nicht verfügbar sind.

Attribute

RegisterAttribute RequiresPermissionAttribute

Hinweise

Fordert alle verfügbaren Zellinformationen von allen Radios auf dem Gerät an, einschließlich der gelagerten/registrierten, dienenden und benachbarten Zellen.

Die Antwort kann eine oder android.telephony.CellInfoGsm CellInfoGsmmehrere , , android.telephony.CellInfoCdma CellInfoCdma, android.telephony.CellInfoTdscdma CellInfoTdscdma, android.telephony.CellInfoLte CellInfoLteund android.telephony.CellInfoWcdma CellInfoWcdma Objekte in beliebiger Kombination enthalten. Es ist typisch, Instanzen einer oder mehrerer dieser Instanzen in der Liste anzuzeigen. Darüber hinaus können null oder mehr der zurückgegebenen Objekte als registriert betrachtet werden; d. h., ihre android.telephony.CellInfo#isRegistered CellInfo.isRegistered() Methoden können "true" zurückgeben, was angibt, dass die Zelle verwendet wird oder bei Bedarf für die Signalkommunikation verwendet wird.

Beginnend mit android.os.Build.VERSION_CODES#Q Android Q, wenn diese API zu einer Änderung der zwischengespeicherten CellInfo führt, wird diese Änderung über android.telephony.PhoneStateListener#onCellInfoChanged onCellInfoChanged().

Apps für die Zielbestimmung android.os.Build.VERSION_CODES#Q Android Q oder höher lösen keine Aktualisierung der zwischengespeicherten CellInfo mehr aus, indem sie diese API aufrufen. Stattdessen erhalten diese Apps die neuesten zwischengespeicherten Ergebnisse, die möglicherweise nicht aktuell sind. Apps, android.os.Build.VERSION_CODES#Q Android Q die aktualisierte CellInfo anfordern möchten, sollten aufgerufen android.telephony.TelephonyManager#requestCellInfoUpdate requestCellInfoUpdate()werden. In allen Fällen werden Updates jedoch mit einer Rate begrenzt und nicht garantiert. Um die Reency von CellInfo-Daten zu ermitteln, sollten Anrufer überprüfen android.telephony.CellInfo#getTimeStamp CellInfo#getTimeStamp().

Diese Methode gibt gültige Daten für Geräte mit android.content.pm.PackageManager#FEATURE_TELEPHONY FEATURE_TELEPHONY. In Fällen, in denen nur Teilinformationen für einen bestimmten CellInfo-Eintrag verfügbar sind, werden nicht verfügbare Felder als android.telephony.CellInfo#UNAVAILABLEgemeldet. Alle gemeldeten Zellen enthalten mindestens einen gültigen Satz technologiespezifischer Identifikationsinformationen und eine Messung des Leistungsniveaus.

Diese Methode wird gegenüber der Verwendung android.telephony.TelephonyManager#getCellLocation getCellLocation()bevorzugt.

Java-Dokumentation für android.telephony.TelephonyManager.getAllCellInfo().

Teile dieser Seite sind Änderungen auf der Grundlage von Arbeiten, die vom Android Open Source-Projekt erstellt und freigegeben werden und gemäß den in der Creative Commons 2.5 Attribution License beschriebenen Begriffen verwendet werden.