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

定義

名前空間:: Android.App

アセンブリ:: Mono.Android.dll

重要

一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。

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

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

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

android.app.ActivityManager.setProcessStateSummaryの Android リファレンス。

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

適用対象