TelephonyManager.AllCellInfo 屬性
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
從裝置上的所有無線電要求所有可用的儲存格資訊,包括已訓練/註冊、服務及鄰近的儲存格。
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>
屬性值
如果儲存格資訊無法使用,則為 android.telephony.CellInfo
null。
- 屬性
備註
從裝置上的所有無線電要求所有可用的儲存格資訊,包括已訓練/註冊、服務及鄰近的儲存格。
回應可以包含任何組合中的一或多個 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
用此 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()
。
的 android.telephony.TelephonyManager.getAllCellInfo()
Java 檔。
此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改,並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。