UsageStatsManager.QueryAppUsageDuration(AppUsageDurationQuery) 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
取得指定時間範圍內的應用程式使用統計,並依指定區間彙整。
[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 所創建與分享的作品,並依授權條款所描述的使用進行修改。