TelephonyManager.AllCellInfo Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Richiede tutte le informazioni sulle celle disponibili da tutte le radio sul dispositivo, incluse le celle camped/registered, serve e vicino.
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>
Valore della proprietà
Elenco di android.telephony.CellInfo
; null se le informazioni sulla cella non sono disponibili.
- Attributi
Commenti
Richiede tutte le informazioni sulle celle disponibili da tutte le radio sul dispositivo, incluse le celle camped/registered, serve e vicino.
La risposta può includere uno o più android.telephony.CellInfoGsm CellInfoGsm
oggetti , android.telephony.CellInfoTdscdma CellInfoTdscdma
android.telephony.CellInfoCdma CellInfoCdma
, android.telephony.CellInfoLte CellInfoLte
, e android.telephony.CellInfoWcdma CellInfoWcdma
in qualsiasi combinazione. È tipico visualizzare le istanze di uno o più di questi nell'elenco. Inoltre, zero o più degli oggetti restituiti possono essere considerati registrati; ovvero i relativi android.telephony.CellInfo#isRegistered CellInfo.isRegistered()
metodi possono restituire true, a indicare che la cella viene usata o che verrà usata per la comunicazione di segnalazione, se necessario.
android.os.Build.VERSION_CODES#Q Android Q
A partire da , se questa API comporta una modifica dell'elemento CellInfo memorizzato nella cache, tale modifica verrà segnalata tramite android.telephony.PhoneStateListener#onCellInfoChanged onCellInfoChanged()
.
Le app destinate android.os.Build.VERSION_CODES#Q Android Q
o superiori non attiveranno più un aggiornamento dell'elemento CellInfo memorizzato nella cache richiamando questa API. Queste app riceveranno invece i risultati memorizzati nella cache più recenti, che potrebbero non essere aggiornati. android.os.Build.VERSION_CODES#Q Android Q
Le app destinate o superiori che desiderano richiedere CellInfo aggiornato devono chiamare android.telephony.TelephonyManager#requestCellInfoUpdate requestCellInfoUpdate()
. Tuttavia, in tutti i casi, gli aggiornamenti saranno limitati alla frequenza e non sono garantiti. Per determinare la pertinenza dei dati CellInfo, i chiamanti devono controllare android.telephony.CellInfo#getTimeStamp CellInfo#getTimeStamp()
.
Questo metodo restituisce dati validi per i dispositivi con android.content.pm.PackageManager#FEATURE_TELEPHONY FEATURE_TELEPHONY
. Nei casi in cui solo le informazioni parziali sono disponibili per una determinata voce CellInfo, i campi non disponibili verranno segnalati come android.telephony.CellInfo#UNAVAILABLE
. Tutte le celle segnalate includeranno almeno un set valido di informazioni di identificazione specifiche della tecnologia e una misurazione del livello di alimentazione.
Questo metodo è preferibile rispetto all'uso di android.telephony.TelephonyManager#getCellLocation getCellLocation()
.
Documentazione java per android.telephony.TelephonyManager.getAllCellInfo()
.
Le parti di questa pagina sono modifiche basate sul lavoro creato e condiviso dal progetto Open Source Android e usato in base ai termini descritti nella licenza Creative Commons 2.5 Attribuzione.