NetworkStatsManager クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。
[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- 継承
- 属性
注釈
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 使用状況データは、"Buckets" と呼ばれる時間の個別のビンに収集されます。 詳細については、NetworkStats.Bucket を参照してください。
クエリでは、開始タイムスタンプと終了タイムスタンプの形式で時間間隔を定義できます (Long.MIN_VALUEと Long.MAX_VALUE を使用して、未終了間隔をシミュレートできます)。 既定では、アプリは自身に関するデータのみを取得できます。 アプリが他のアプリケーションに関するデータを取得できる特殊なケースについては、次の注を参照してください。
<h3> Summary クエリ </h3>#querySummaryForDevice
#querySummaryForUser
#querySummary
これらのクエリは、間隔全体のネットワーク使用量を集計します。 そのため、特定のキー、状態、従量制課金、ローミングの組み合わせに対してバケットは 1 つだけ存在します。 ユーザー全体およびデバイス全体の概要の場合は、合計ネットワーク使用量を含む 1 つのバケットが返されます。
<h3> 履歴クエリ </h3>#queryDetailsForUid
#queryDetails
これらのクエリは時間の経過と同時に集計されませんが、状態、従量制課金、ローミングに対して集計されます。 そのため、特定のキーに対して複数のバケットが存在する可能性があります。 ただし、すべてのバケットには、 stateNetworkStats.Bucket#STATE_ALL、 defaultNetworkNetworkStats.Bucket#DEFAULT_NETWORK_ALL、 meteredNetworkStats.Bucket#METERED_ALL、 roamingNetworkStats.Bucket#ROAMING_ALLがあります。
<b>NOTE:</b> 呼び出し元アプリ以外のアプリの #querySummaryForDevice の呼び出しまたは統計へのアクセスには、システム レベルのアクセス許可であり、サード パーティのアプリには付与されないアクセス許可 android.Manifest.permission#PACKAGE_USAGE_STATSが必要です。 ただし、アクセス許可を宣言することは、API を使用する意図を意味し、デバイスのユーザーは Settings アプリケーションを通じてアクセス許可を付与できます。
プロファイル所有者アプリには、管理するプロファイルのデータに対してクエリを実行するアクセス許可が自動的に付与されます (つまり、 #querySummaryForDeviceを除くクエリの場合)。 デバイス所有者アプリと通信事業者特権アプリも同様に、デバイス上のすべてのユーザーの使用状況データにアクセスできます。
テザリングの使用に加えて、削除されたユーザーとアプリによる使用状況、およびシステムによる使用状況も、これらの上位レベルのアクセス権を持つ呼び出し元の結果に含まれます。
<b>NOTE:</b> API レベルの android.os.Build.VERSION_CODES#Nより前は、これらの API のすべての呼び出しに上記のアクセス許可が必要でした。アプリ独自のデータ使用量にアクセスする場合でも、キャリア特権アプリは含まれていませんでした。
このページの一部は、によって作成および共有され、に記載されている条件に従って使用される作業に基づく変更です。
コンストラクター
| 名前 | 説明 |
|---|---|
| NetworkStatsManager(IntPtr, JniHandleOwnership) |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| Class |
この |
| Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
| JniIdentityHashCode |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| JniPeerMembers |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 |
| PeerReference |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| ThresholdClass |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 |
| ThresholdType |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 |
メソッド
| 名前 | 説明 |
|---|---|
| Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
| Dispose() |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| Dispose(Boolean) |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
| GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
| JavaFinalize() |
オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
| Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
| NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
| QueryDetails(ConnectivityType, String, Int64, Int64) |
ネットワーク使用状況の統計情報の詳細を照会します。 |
| QueryDetailsForUid(ConnectivityType, String, Int64, Int64, Int32) |
特定の uid のネットワーク使用状況の統計情報の詳細を照会します。 |
| QueryDetailsForUidTag(ConnectivityType, String, Int64, Int64, Int32, Int32) |
特定の uid とタグのネットワーク使用状況の統計情報の詳細を照会します。 |
| QueryDetailsForUidTagState(ConnectivityType, String, Int64, Int64, Int32, Int32, NetworkUsageState) |
特定の uid、タグ、および状態のネットワーク使用状況の統計情報の詳細を照会します。 |
| QuerySummary(ConnectivityType, String, Int64, Int64) |
ネットワーク使用状況の統計情報の概要を照会します。 |
| QuerySummaryForDevice(ConnectivityType, String, Int64, Int64) |
ネットワーク使用状況の統計情報の概要を照会します。 |
| QuerySummaryForUser(ConnectivityType, String, Int64, Int64) |
ネットワーク使用状況の統計情報の概要を照会します。 |
| RegisterUsageCallback(ConnectivityType, String, Int64, NetworkStatsManager+UsageCallback, Handler) |
指定されたネットワークでのデータ使用状況に関する通知を受信するように登録します。 |
| RegisterUsageCallback(ConnectivityType, String, Int64, NetworkStatsManager+UsageCallback) |
指定されたネットワークでのデータ使用状況に関する通知を受信するように登録します。 |
| SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
| ToArray<T>() |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| ToString() |
オブジェクトの文字列形式を返します。 (継承元 Object) |
| UnregisterFromRuntime() |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| UnregisterUsageCallback(NetworkStatsManager+UsageCallback) |
データの使用に関するコールバックの登録を解除します。 |
| Wait() |
現在のスレッドが起動するまで待機します。通常は、 <em>notified</em> または <em>interrupted</em>。 (継承元 Object) |
| Wait(Int64, Int32) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object) |
| Wait(Int64) |
現在のスレッドは、通常、 <em>notified</em> または <em>interrupted</em>、または一定のリアルタイムが経過するまで、起動されるまで待機します。 (継承元 Object) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IJavaPeerable.Disposed() |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| IJavaPeerable.DisposeUnlessReferenced() |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| IJavaPeerable.Finalized() |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| IJavaPeerable.JniManagedPeerState |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| IJavaPeerable.SetJniIdentityHashCode(Int32) |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
| IJavaPeerable.SetPeerReference(JniObjectReference) |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 (継承元 Object) |
拡張メソッド
| 名前 | 説明 |
|---|---|
| GetJniTypeName(IJavaPeerable) |
インスタンス |
| JavaAs<TResult>(IJavaPeerable) |
|
| JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
| JavaCast<TResult>(IJavaObject) |
ネットワークの使用状況の履歴と統計情報へのアクセスを提供します。 |
| TryJavaCast<TResult>(IJavaPeerable, TResult) |
|