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.CellInfoСписок ; null, если сведения о ячейке недоступны.

Атрибуты

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 приводит к изменению кэшированного CellInfo, это изменение будет сообщаться через android.telephony.PhoneStateListener#onCellInfoChanged onCellInfoChanged().

Приложения, предназначенные android.os.Build.VERSION_CODES#Q Android Q для или более поздних версий, больше не будут запускать обновление кэшированного Объекта CellInfo путем вызова этого API. Вместо этого эти приложения будут получать последние кэшированные результаты, которые могут быть не актуальными. Приложения, предназначенные 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().

Документация по Java для android.telephony.TelephonyManager.getAllCellInfo().

Части этой страницы являются изменениями, основанными на работе, созданной и совместно используемой проектом Android и используемой в соответствии с условиями, Creative Commons 2.5 Attribution License.