NetworkStatsManager.QuerySummary メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ネットワーク使用状況の統計情報の概要を照会します。
[Android.Runtime.Register("querySummary", "(ILjava/lang/String;JJ)Landroid/app/usage/NetworkStats;", "GetQuerySummary_ILjava_lang_String_JJHandler", ApiSince=23)]
public virtual Android.App.Usage.NetworkStats? QuerySummary(Android.Net.ConnectivityType networkType, string? subscriberId, long startTime, long endTime);
[<Android.Runtime.Register("querySummary", "(ILjava/lang/String;JJ)Landroid/app/usage/NetworkStats;", "GetQuerySummary_ILjava_lang_String_JJHandler", ApiSince=23)>]
abstract member QuerySummary : Android.Net.ConnectivityType * string * int64 * int64 -> Android.App.Usage.NetworkStats
override this.QuerySummary : 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 で開始すると、呼び出し元アプリは wifi ネットワークの種類を持つ subscriberId を提供して、該当する場合は、特定のサブスクリプションの下にある Wifi ネットワークの使用状況を受信できます。
それ以外の場合は、すべての wifi ネットワークに対してクエリを実行するときに null を渡します。
- startTime
- Int64
期間の開始。 「Unix 時間」の観点から定義されている「 java.lang.System#currentTimeMillis」を参照してください。
- endTime
- Int64
期間の終了。 「Unix 時間」の観点から定義されている「 java.lang.System#currentTimeMillis」を参照してください。
返品
統計オブジェクト。権限が不十分な場合、または統計収集中にエラーが発生した場合は null。
- 属性
注釈
ネットワーク使用状況の統計情報の概要を照会します。 呼び出し元ユーザーに属する uid のみを含むようにフィルター処理された結果。 結果は時間の経過と同時に集計されるため、すべてのバケットの開始タイムスタンプと終了タイムスタンプが同じになります。 状態、uid、既定のネットワーク、従量制課金、またはローミングでは集計されません。 つまり、バケットの開始タイムスタンプと終了タイムスタンプは、'startTime' パラメーターと 'endTime' パラメーターと同じになります。 状態、uid、従量制課金、ローミングは変化し、タグは同じになります。 これには時間がかかる場合があり、アプリはメイン スレッドでこれを呼び出さないようにする必要があります。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。