UsageStatsManager 類別

定義

命名空間:: Android.App.Usage

組件:: Mono.Android.dll

重要

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

提供裝置使用歷史與統計資料的存取。

[Android.Runtime.Register("android/app/usage/UsageStatsManager", DoNotGenerateAcw=true)]
public sealed class UsageStatsManager : Java.Lang.Object

[<Android.Runtime.Register("android/app/usage/UsageStatsManager", DoNotGenerateAcw=true)>]
type UsageStatsManager = class
    inherit Object

繼承: Object

JavaObject

Object
UsageStatsManager

屬性: RegisterAttribute

備註

提供裝置使用歷史與統計資料的存取。使用資料會依時間區間聚合：天、週、月和年。

當請求使用資料時，請求內容可能如下：

PAST                   REQUEST_TIME                    TODAY                   FUTURE
            ————————————————————————————||———————————————————————————¦-----------------------|
                                   YEAR ||                           ¦                       |
            ————————————————————————————||———————————————————————————¦-----------------------|
             MONTH            |         ||                MONTH      ¦                       |
            ——————————————————|—————————||———————————————————————————¦-----------------------|
              |      WEEK     |     WEEK||    |     WEEK     |     WE¦EK     |      WEEK     |
            ————————————————————————————||———————————————————|———————¦-----------------------|
                                        ||           |DAY|DAY|DAY|DAY¦DAY|DAY|DAY|DAY|DAY|DAY|
            ————————————————————————————||———————————————————————————¦-----------------------|

在某個時間區間中間請求資料時，會包含該區間。

<b>注意：</b> 此 API 上的大多數方法都需要權限android.permission.PACKAGE_USAGE_STATS。然而，宣告權限意味著使用者有意使用 API，且使用者仍需透過設定應用程式授權。參見 android.provider.Settings#ACTION_USAGE_ACCESS_SETTINGS。僅回傳呼叫套件資訊的方法則不需要此權限。例如 #getAppStandbyBucket() 和 #queryEventsForSelf(long, long)。

Java 文件 android.app.usage.UsageStatsManager。

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

欄位

名稱	Description
ExtraEventAction	一個字串額外，當與一起使用 `UsageEvents.Event#getExtras`時，表示與事件相關的使用者互動動作。
ExtraEventCategory	一個 String extra，當與一起使用 `UsageEvents.Event#getExtras`時，表示與事件相關的使用者互動類別。
StandbyBucketActive	已淘汰. 這個應用程式是最近才被使用，目前仍在使用，或很可能很快會被使用。
StandbyBucketFrequent	已淘汰. 這個應用程式在過去幾天被使用，或很可能在接下來幾天會被使用。
StandbyBucketRare	已淘汰. 該應用程式已經好幾天沒被使用，或很可能幾天內不會再使用。
StandbyBucketRestricted	已淘汰. 該應用程式已經好幾天沒用了，也不太可能再用，而且一直有某種異常行為。
StandbyBucketWorkingSet	已淘汰. 這個應用程式最近有用過，或很可能在接下來幾小時內會被使用。

屬性

名稱	Description
AppStandbyBucket	回傳呼叫應用程式目前的待機桶。
Class	回傳此 `Object`的執行時類別。 (繼承來源 Object)
Handle	底層 Android 實例的帳號。 (繼承來源 Object)
JniIdentityHashCode	取得由互通執行時指派給此 Java 對等端的身份雜湊碼。 (繼承來源 Object)
JniManagedPeerState	提供裝置使用歷史與統計資料的存取。 (繼承來源 JavaObject)
JniPeerMembers	提供裝置使用歷史與統計資料的存取。
PeerReference	取得這個 Java 節點的 JNI 物件參考。 (繼承來源 Object)
ThresholdClass	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)
ThresholdType	此 API 支援 Mono for Android 基礎架構，並非直接從你的程式碼中使用。 (繼承來源 Object)

方法

名稱	Description
Clone()	建立並回傳此物件的副本。 (繼承來源 Object)
Construct(JniObjectReference, JniObjectReferenceOptions)	提供裝置使用歷史與統計資料的存取。 (繼承來源 JavaObject)
Dispose()	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
Dispose(Boolean)	釋放該 Java 節點所持有的資源。 (繼承來源 Object)
DisposeUnlessReferenced()	提供裝置使用歷史與統計資料的存取。 (繼承來源 JavaObject)
Equals(Object)	提供裝置使用歷史與統計資料的存取。 (繼承來源 JavaObject)
Equals(Object)	表示是否有其他物體「等同」於此物。 (繼承來源 Object)
GetHashCode()	回傳物件的雜湊碼值。 (繼承來源 Object)
IsAppInactive(String)	回傳指定的應用程式目前是否被視為非活躍。
JavaFinalize()	已淘汰. 當垃圾回收判定該物件不再有相關參考時，由垃圾回收器呼叫。 (繼承來源 Object)
Notify()	喚醒一個正在該物件監視器上等待的執行緒。 (繼承來源 Object)
NotifyAll()	喚醒所有等待該物件監視器的執行緒。 (繼承來源 Object)
QueryAndAggregateUsageStats(Int64, Int64)	一種方便的方法，查詢給定範圍內的所有統計（使用該區間的最佳區間），合併所得資料，並以套件名稱來檢定。
QueryAppUsageDuration(AppUsageDurationQuery)	取得指定時間範圍內的應用程式使用統計，並依指定區間彙整。
QueryConfigurations(UsageStatsInterval, Int64, Int64)	取得裝置在指定時間範圍內所處硬體配置，並依指定區間彙總。
QueryEvents(Int64, Int64)	查詢給定時間範圍內的事件。
QueryEvents(UsageEventsQuery)	用特定的 UsageEventsQuery 物件查詢事件。
QueryEventsForSelf(Int64, Int64)	像 `#queryEvents(long, long)`，但只回傳呼叫套件的事件。
QueryEventStats(UsageStatsInterval, Int64, Int64)	取得指定時間區間內的事件統計彙整，並依指定區間彙總。
QueryUsageStats(UsageStatsInterval, Int64, Int64)	取得指定時間範圍內的應用程式使用統計，並依指定區間彙整。
SetHandle(IntPtr, JniHandleOwnership)	設定 Handle 屬性。 (繼承來源 Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)	提供裝置使用歷史與統計資料的存取。 (繼承來源 JavaObject)
ToArray<T>()	從這個 Java 陣列包裝器建立一個受管理陣列。 (繼承來源 Object)
ToString()	回傳物件的字串表示。 (繼承來源 Object)
UnregisterFromRuntime()	將此 Java 節點從互通執行時中取消註冊。 (繼承來源 Object)
Wait()	導致目前執行緒等待被喚醒，通常是透過 <em>通知</><em 或 em>中斷</em> 來喚醒。 (繼承來源 Object)
Wait(Int64, Int32)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)
Wait(Int64)	會讓目前執行緒等待喚醒，通常是透過 <em>通知</><em 或 em>中斷</em>，或是經過一定的真實時間。 (繼承來源 Object)

明確介面實作

名稱	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)	取得實例 `self`類型的 JNI 名稱。
JavaAs<TResult>(IJavaPeerable)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。
JavaCast<TResult>(IJavaObject)	執行 Android 執行時檢查型別轉換。
JavaCast<TResult>(IJavaObject)	提供裝置使用歷史與統計資料的存取。
TryJavaCast<TResult>(IJavaPeerable, TResult)	試著強制`self`輸入 `TResult`，檢查強制在 Java 端是否有效。

適用於