NetworkStatsManager 類別
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
提供網路使用歷史與統計資料的存取。
[Android.Runtime.Register("android/app/usage/NetworkStatsManager", ApiSince=23, DoNotGenerateAcw=true)]
public class NetworkStatsManager : Java.Lang.Object[<Android.Runtime.Register("android/app/usage/NetworkStatsManager", ApiSince=23, DoNotGenerateAcw=true)>]
type NetworkStatsManager = class
inherit Object- 繼承
- 屬性
備註
提供網路使用歷史與統計資料的存取。 使用資料會以稱為「桶」的獨立時間區塊收集。 如需詳細資訊，請參閱 NetworkStats.Bucket。
查詢可以以開始與結束時間戳記的形式定義時間區間（Long.MIN_VALUE 和 Long.MAX_VALUE 可用來模擬開放式區間）。 預設情況下，應用程式只能取得自身資料。 請參閱下方說明，說明應用程式可取得其他應用程式資料的特殊情況。
<h3> 摘要查詢 </h3>#querySummaryForDevice
#querySummaryForUser
#querySummary
這些查詢會彙整整個區間的網路使用情況。 因此，對於特定的金鑰、狀態、計量和漫遊組合，只有一個桶。 在使用者範圍及裝置範圍的摘要中，會回傳一個包含總網路使用量的桶。
<h3> 歷史查詢 </h3>#queryDetailsForUid
#queryDetails
這些查詢不會隨時間聚合，但會針對狀態、計量和漫遊進行聚合。 因此，同一鍵可以有多個桶。 然而，所有桶子的 stateNetworkStats.Bucket#STATE_ALLdefaultNetworkNetworkStats.Bucket#DEFAULT_NETWORK_ALL， ，meteredNetworkStats.Bucket#METERED_ALL ， 。 roamingNetworkStats.Bucket#ROAMING_ALL
<b>注意：</b> 撥打 #querySummaryForDevice 或存取非該呼叫應用程式的應用程式統計需要權限 android.Manifest.permission#PACKAGE_USAGE_STATS，這是系統層級的權限，第三方應用程式不會被授予。 然而，宣告權限意味著有使用 API 的意圖，裝置使用者可透過設定應用程式授予權限。
設定檔擁有者應用程式會自動獲得查詢其管理設定檔資料的權限（即除 #querySummaryForDevice） 以外的任何查詢。 裝置擁有者應用程式和電信業者特權應用程式同樣能取得裝置上所有使用者的使用資料。
除了用電量的用電方式外，移除的使用者和應用程式的使用情況，以及系統的使用情況也會包含在擁有這些較高存取權限的來電者中。
<b>注意：</b> 在 API 層 android.os.Build.VERSION_CODES#N級出現之前，所有對這些 API 的呼叫都需要上述權限，甚至存取應用程式自身的資料使用情況，且未包含電信特權應用程式。
Java 文件 android.app.usage.NetworkStatsManager。
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
建構函式
| 名稱 | Description |
|---|---|
| NetworkStatsManager(IntPtr, JniHandleOwnership) |
提供網路使用歷史與統計資料的存取。 |
屬性
| 名稱 | Description |
|---|---|
| Class |
回傳此 |
| Handle |
底層 Android 實例的帳號。 (繼承來源 Object) |
| JniIdentityHashCode |
取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object) |
| JniManagedPeerState |
提供網路使用歷史與統計資料的存取。 (繼承來源 JavaObject) |
| JniPeerMembers |
提供網路使用歷史與統計資料的存取。 |
| PeerReference |
取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object) |
| ThresholdClass |
提供網路使用歷史與統計資料的存取。 |
| ThresholdType |
提供網路使用歷史與統計資料的存取。 |
方法
明確介面實作
| 名稱 | Description |
|---|---|
| IJavaPeerable.Disposed() |
提供網路使用歷史與統計資料的存取。 (繼承來源 JavaObject) |
| IJavaPeerable.Finalized() |
提供網路使用歷史與統計資料的存取。 (繼承來源 JavaObject) |
| IJavaPeerable.JniObjectReferenceControlBlock |
提供網路使用歷史與統計資料的存取。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
提供網路使用歷史與統計資料的存取。 (繼承來源 JavaObject) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
提供網路使用歷史與統計資料的存取。 (繼承來源 JavaObject) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
提供網路使用歷史與統計資料的存取。 (繼承來源 JavaObject) |
擴充方法
| 名稱 | Description |
|---|---|
| GetJniTypeName(IJavaPeerable) |
取得實例 |
| JavaAs<TResult>(IJavaPeerable) |
試著強制 |
| JavaCast<TResult>(IJavaObject) |
執行 Android 執行時檢查型別轉換。 |
| JavaCast<TResult>(IJavaObject) |
提供網路使用歷史與統計資料的存取。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
試著強制 |