语言

NetworkStatsManager.QueryDetails 方法

定义

查询网络使用情况统计信息详细信息。

[Android.Runtime.Register("queryDetails", "(ILjava/lang/String;JJ)Landroid/app/usage/NetworkStats;", "GetQueryDetails_ILjava_lang_String_JJHandler", ApiSince=23)]
public virtual Android.App.Usage.NetworkStats? QueryDetails(Android.Net.ConnectivityType networkType, string? subscriberId, long startTime, long endTime);
[<Android.Runtime.Register("queryDetails", "(ILjava/lang/String;JJ)Landroid/app/usage/NetworkStats;", "GetQueryDetails_ILjava_lang_String_JJHandler", ApiSince=23)>]
abstract member QueryDetails : Android.Net.ConnectivityType * string * int64 * int64 -> Android.App.Usage.NetworkStats
override this.QueryDetails : Android.Net.ConnectivityType * string * int64 * int64 -> Android.App.Usage.NetworkStats

参数

networkType
ConnectivityType

如中 ConnectivityManager定义,例如 ConnectivityManager#TYPE_MOBILE, ConnectivityManager#TYPE_WIFI 等等。

subscriberId
String

如果适用,网络接口的订阅服务器 ID。 <p>从 API 级别 29 开始, subscriberId 受其他限制保护。 调用不符合访问 subscriberId 新要求的应用可在查询移动网络类型以接收所有移动网络的使用情况时提供 null 值。 有关其他详细信息,请参阅 TelephonyManager#getSubscriberId()。 <p>从 API 级别 31 开始,调用应用可以提供 subscriberId wifi 网络类型,以接收在给定订阅下(如果适用)的 wifi 网络的使用情况。 否则,在查询所有 wifi 网络时传递 null 。

startTime
Int64

时间段的开始。 在“Unix 时间”方面定义,请参阅 java.lang.System#currentTimeMillis。

endTime
Int64

句点结束。 在“Unix 时间”方面定义,请参阅 java.lang.System#currentTimeMillis。

返回

统计信息对象或 null(如果权限不足或统计信息收集期间发生错误)。

特性

注解

查询网络使用情况统计信息详细信息。 筛选结果以仅包含属于调用用户的 uid。 结果通过状态聚合,但不会随时间推移聚合、uid、标记、按流量计费或漫游。 这意味着存储桶的开始和结束时间戳将在“startTime”和“endTime”参数之间。 状态将是 NetworkStats.Bucket#STATE_ALL,uid 将有所不同,标记 NetworkStats.Bucket#TAG_NONE,默认网络 NetworkStats.Bucket#DEFAULT_NETWORK_ALL将是,按流量计费 NetworkStats.Bucket#METERED_ALL将是,漫游将是 NetworkStats.Bucket#ROAMING_ALL。

仅包括以原子方式在非独占时间范围内发生的存储桶。 不会跨部分存储桶内插。 由于存储桶长度按小时顺序排列,因此此方法不能用于测量细化时间刻度的数据使用情况。 这可能需要很长时间,应用应避免在其主线程上调用此内容。

Java文档android.app.usage.NetworkStatsManager.queryDetails(int, java.lang.String, long, long)。

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

适用于