NetworkStatsManager.QueryDetails 方法

定義

命名空間:: Android.App.Usage

組件:: Mono.Android.dll

重要

部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。

查詢網路使用統計資料。

[Android.Runtime.Register("queryDetails", "(ILjava/lang/String;JJ)Landroid/app/usage/NetworkStats;", "GetQueryDetails_ILjava_lang_String_JJHandler", ApiSince=23)]
public virtual Android.App.Usage.NetworkStats? QueryDetails(Android.Net.ConnectivityType networkType, string? subscriberId, long startTime, long endTime);

[<Android.Runtime.Register("queryDetails", "(ILjava/lang/String;JJ)Landroid/app/usage/NetworkStats;", "GetQueryDetails_ILjava_lang_String_JJHandler", ApiSince=23)>]
abstract member QueryDetails : Android.Net.ConnectivityType * string * int64 * int64 -> Android.App.Usage.NetworkStats
override this.QueryDetails : Android.Net.ConnectivityType * string * int64 * int64 -> Android.App.Usage.NetworkStats

參數

networkType: ConnectivityType

如定義於 ConnectivityManager，例如 ConnectivityManager#TYPE_MOBILE， ConnectivityManager#TYPE_WIFI 等等。

subscriberId: String

如適用，請提供網路介面的用戶 ID。 <p>從 API 等級 29 開始，受到 subscriberId 額外的限制保護。呼叫不符合新存取需求的 subscriberId 應用程式，可以在查詢行動網路類型時提供 null 一個值，以接收所有行動網路的使用情況。更多細節請參見 TelephonyManager#getSubscriberId()。 <p>從 API 等級 31 開始，呼叫應用程式可以提供 subscriberId 一種 WiFi 網路類型，以接收 WiFi 網路的使用量，若適用，則屬於該訂閱。否則，查詢所有 WiFi 網路時就不 null 行。

startTime: Int64

課堂開始。以「Unix 時間」定義，請參見 java.lang.System#currentTimeMillis。

endTime: Int64

課程結束。以「Unix 時間」定義，請參見 java.lang.System#currentTimeMillis。

傳回

NetworkStats

統計物件或空，若權限不足或統計收集過程中發生錯誤。

屬性: RegisterAttribute

備註

查詢網路使用統計資料。結果篩選為只包含呼叫使用者的 UID。結果會依州內聚合，但不會依時間、UID、標籤、計量或漫遊進行聚合。這表示桶的開始與結束時間戳會介於「startTime」和「endTime」參數之間。狀態會是 NetworkStats.Bucket#STATE_ALL，uid 會變動，標籤 NetworkStats.Bucket#TAG_NONE，預設網路會是 NetworkStats.Bucket#DEFAULT_NETWORK_ALL，計量會是 NetworkStats.Bucket#METERED_ALL，漫遊會是 NetworkStats.Bucket#ROAMING_ALL。

只包含原子層次發生在包含時間範圍內的桶。不會跨部分桶插值。由於桶長度約為小時，此方法無法用於細緻時間尺度上的資料使用量。這可能需要很長時間，應用程式應避免在主串中呼叫此訊息。

Java 文件 android.app.usage.NetworkStatsManager.queryDetails(int, java.lang.String, long, long)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。

適用於