TelephonyManager.AllCellInfo Propriété
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Demande toutes les informations de cellule disponibles à partir de toutes les radios sur l’appareil, y compris les cellules campées/inscrites, servantes et voisines.
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>
Valeur de propriété
Liste de android.telephony.CellInfo
; Null si les informations de cellule ne sont pas disponibles.
- Attributs
Remarques
Demande toutes les informations de cellule disponibles à partir de toutes les radios sur l’appareil, y compris les cellules campées/inscrites, servantes et voisines.
La réponse peut inclure un ou plusieurs android.telephony.CellInfoGsm CellInfoGsm
objets , , android.telephony.CellInfoLte CellInfoLte
android.telephony.CellInfoCdma CellInfoCdma
android.telephony.CellInfoTdscdma CellInfoTdscdma
et android.telephony.CellInfoWcdma CellInfoWcdma
ce, dans n’importe quelle combinaison. Il est courant de voir les instances d’une ou plusieurs de ces instances dans la liste. En outre, zéro ou plus des objets retournés peuvent être considérés comme inscrits ; autrement dit, leurs android.telephony.CellInfo#isRegistered CellInfo.isRegistered()
méthodes peuvent retourner true, indiquant que la cellule est utilisée ou serait utilisée pour signaler la communication si nécessaire.
android.os.Build.VERSION_CODES#Q Android Q
À compter de , si cette API entraîne une modification de CellInfo mise en cache, cette modification sera signalée via android.telephony.PhoneStateListener#onCellInfoChanged onCellInfoChanged()
.
Les applications ciblant android.os.Build.VERSION_CODES#Q Android Q
ou ultérieure ne déclenchent plus d’actualisation de CellInfo mise en cache en appelant cette API. Au lieu de cela, ces applications recevront les derniers résultats mis en cache, qui peuvent ne pas être actuels. Les applications ciblant android.os.Build.VERSION_CODES#Q Android Q
ou supérieure qui souhaitent demander la mise à jour de CellInfo doivent appeler android.telephony.TelephonyManager#requestCellInfoUpdate requestCellInfoUpdate()
; toutefois, dans tous les cas, les mises à jour seront limitées et ne sont pas garanties. Pour déterminer la récurrence des données CellInfo, les appelants doivent vérifier android.telephony.CellInfo#getTimeStamp CellInfo#getTimeStamp()
.
Cette méthode retourne des données valides pour les appareils avec android.content.pm.PackageManager#FEATURE_TELEPHONY FEATURE_TELEPHONY
. Dans les cas où seules les informations partielles sont disponibles pour une entrée CellInfo particulière, les champs non disponibles sont signalés comme android.telephony.CellInfo#UNAVAILABLE
. Toutes les cellules signalées incluent au moins un ensemble valide d’informations d’identification spécifiques à la technologie et une mesure au niveau de l’alimentation.
Cette méthode est préférée à l’utilisation android.telephony.TelephonyManager#getCellLocation getCellLocation()
.
Documentation Java pour android.telephony.TelephonyManager.getAllCellInfo()
.
Les parties de cette page sont des modifications basées sur le travail créé et partagé par le projet Android Open Source et utilisés en fonction des termes décrits dans la licence d’attribution Creative Commons 2.5.