語言

UsageStatsManager.QueryAppUsageDuration(AppUsageDurationQuery) 方法

定義

取得指定時間範圍內的應用程式使用統計,並依指定區間彙整。

[Android.Runtime.Register("queryAppUsageDuration", "(Landroid/app/usage/AppUsageDurationQuery;)Ljava/util/List;", "", ApiSince=37)]
[Android.Runtime.RequiresPermission("android.permission.QUERY_APP_USAGE")]
public System.Collections.Generic.IList<Android.App.Usage.AppUsageDuration> QueryAppUsageDuration(Android.App.Usage.AppUsageDurationQuery query);
[<Android.Runtime.Register("queryAppUsageDuration", "(Landroid/app/usage/AppUsageDurationQuery;)Ljava/util/List;", "", ApiSince=37)>]
[<Android.Runtime.RequiresPermission("android.permission.QUERY_APP_USAGE")>]
member this.QueryAppUsageDuration : Android.App.Usage.AppUsageDurationQuery -> System.Collections.Generic.IList<Android.App.Usage.AppUsageDuration>

參數

query
AppUsageDurationQuery

用來指定查詢參數的 AppUsageDurationQuery。 這個值不可能為零值。

傳回

這是每個應用程式在指定時間區間內的 AppUsageDuration 清單。 這個值不可能為零值。

屬性

備註

取得指定時間範圍內的應用程式使用統計,並依指定區間彙整。

使用統計數據會預先彙總到與日曆對齊的邊界(例如,INTERVAL_DAILY 的一天定義為當地時間午夜至午夜)。 回傳的清單只會包含在此期間內已使用的應用程式。

回傳的清單會包含每個套件一個或多個 AppUsageDuration 物件,使用資料會彙整於每個區間桶內,該區間位於 AppUsageDurationQuery.getStartTimeMillis() 與 AppUsageDurationQuery.getEndTimeMillis() 之間的時間範圍內,這可能包含上述擴展的區間期間。

資料只能查詢過去30天的資料。 查詢較長時間範圍的查詢會回傳一個空清單。 需要Manifest.permission.QUERY_APP_USAGE

Android 參考資料。android.app.usage.UsageStatsManager.queryAppUsageDuration

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

適用於