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

注釈

キャンプ済み/登録済み、サービス提供、近隣セルを含む、デバイス上のすべての無線から使用可能なすべてのセル情報を要求します。

応答には、任意の組み合わせで 1 つ以上 android.telephony.CellInfoGsm CellInfoGsmの 、 android.telephony.CellInfoCdma CellInfoCdma、 android.telephony.CellInfoTdscdma CellInfoTdscdma、 android.telephony.CellInfoLte CellInfoLte、および android.telephony.CellInfoWcdma CellInfoWcdma オブジェクトを含めることができます。 これらの 1 つ以上のインスタンスが一覧に表示されるのが一般的です。 さらに、返されるオブジェクトの 0 個以上が登録済みと見なされる場合があります。つまり、その 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 アプリでは、この API を呼び出すことで、キャッシュされた CellInfo の更新がトリガーされなくなります。 代わりに、これらのアプリは最新のキャッシュされた結果を受け取りますが、最新ではない可能性があります。 更新された CellInfo を android.os.Build.VERSION_CODES#Q Android Q 要求する対象以上のアプリは を呼び出 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()。

このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。