ActivityManager.SetProcessStateSummary(Byte[]) メソッド

定義

名前空間:

Android.App

アセンブリ:

Mono.Android.dll

このプロセスのカスタム状態データを設定します。

[Android.Runtime.Register("setProcessStateSummary", "([B)V", "GetSetProcessStateSummary_arrayBHandler", ApiSince=30)]
public virtual void SetProcessStateSummary (byte[]? state);

[<Android.Runtime.Register("setProcessStateSummary", "([B)V", "GetSetProcessStateSummary_arrayBHandler", ApiSince=30)>]
abstract member SetProcessStateSummary : byte[] -> unit
override this.SetProcessStateSummary : byte[] -> unit

パラメーター

state

Byte[]

状態データ。 お勧めするには、 <b>DO NOT</b> には機密情報/データ (PII、SPII、またはその他の機密ユーザー データ) がここに含まれています。 最大長は 128 バイトです。

属性

RegisterAttribute

注釈

このプロセスのカスタム状態データを設定します。 これは、現在の呼び出しプロセスの死亡時の のレコードApplicationExitInfoに含まれます。アプリの新しいプロセスでは、 によって#getHistoricalProcessExitReasons返されたレコードに対して を呼び出android.app.ApplicationExitInfo#getProcessStateSummary() ApplicationExitInfo.getProcessStateSummary()すことによって、この状態データを取得できます。

これは、呼び出し元のアプリがステートフル データを保存するのに役立ちます。何らかの理由で後で強制終了された場合、アプリの新しいプロセスは、アプリの以前のプロセスが何を行っていたかを知ることができます。 たとえば、これを使用して、ゲーム内の現在のレベル、または有効にされた一連の機能/実験をエンコードできます。 後で、アプリがクラッシュしたり、メモリを使いすぎたりする傾向がある状況を分析できます。 ただし、アプリケーションの以前の UI 状態を復元するためにこれに依存することはお勧めしません。これは、アプリケーションの正常な状態を分析することのみを目的としています。

システムは、この API への呼び出しを調整することを決定する場合があります。そのため、妥当な方法でこの API を呼び出すと、この API を過剰に呼び出すと、 が発生する java.lang.RuntimeException可能性があります。

の android.app.ActivityManager.setProcessStateSummary(byte[])Java ドキュメント。

このページの一部は、によって作成および共有された作業に基づく変更であり、に記載されている条件に従って使用されます。