NetworkStatsManager 类

定义

[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

继承

Object

Object

NetworkStatsManager

属性

RegisterAttribute

注解

提供对网络使用情况历史记录和统计信息的访问权限。 使用情况数据在称为“Buckets”的离散时间箱中收集。 有关详细信息，请参阅NetworkStats.Bucket。

查询可以采用开始和结束时间戳的形式定义时间间隔（Long.MIN_VALUE和 Long.MAX_VALUE 可用于模拟开放式结束间隔）。 默认情况下，应用只能获取有关自己的数据。 有关应用可以获取有关其他应用程序的数据的特殊情况，请参阅以下说明。 <h3> 摘要查询 </h3>#querySummaryForDevice

#querySummaryForUser

#querySummary

这些查询在整个间隔内聚合网络使用情况。 因此，对于特定键、状态、按流量计费和漫游组合，只有一个存储桶。 对于用户范围和设备范围的摘要，将返回包含总网络使用情况的单个存储桶。 <h3> 历史记录查询 </h3>#queryDetailsForUid

#queryDetails

这些查询不会随时间推移聚合，但会聚合状态、按流量计费和漫游。 因此，特定键可以有多个存储桶。 但是，所有存储桶都将具有stateNetworkStats.Bucket#STATE_ALL，defaultNetworkNetworkStats.Bucket#DEFAULT_NETWORK_ALL即meteredNetworkStats.Bucket#METERED_ALLroamingNetworkStats.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。

本页的某些部分是根据 创建和共享的工作进行的修改，并根据 许可证中所述的条款使用。