Language

ActivityManager.AppTask.RequestWindowingLayer メソッド

定義

このタスクのウィンドウレイヤーを要求します。

[Android.Runtime.Register("requestWindowingLayer", "(ILjava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetRequestWindowingLayer_ILjava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=37)]
public virtual void RequestWindowingLayer(int layer, Java.Util.Concurrent.IExecutor executor, Android.OS.IOutcomeReceiver callback);
[<Android.Runtime.Register("requestWindowingLayer", "(ILjava/util/concurrent/Executor;Landroid/os/OutcomeReceiver;)V", "GetRequestWindowingLayer_ILjava_util_concurrent_Executor_Landroid_os_OutcomeReceiver_Handler", ApiSince=37)>]
abstract member RequestWindowingLayer : int * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit
override this.RequestWindowingLayer : int * Java.Util.Concurrent.IExecutor * Android.OS.IOutcomeReceiver -> unit

パラメーター

layer
Int32

タスクの移動先の WindowingLayer 。

executor
IExecutor

コールバックの呼び出しに使用される Executor 。

callback
IOutcomeReceiver

要求の結果を受信するコールバック。

属性

注釈

このタスクのウィンドウレイヤーを要求します。 これを使用すると、他のウィンドウに対するアクティビティのウィンドウの Z オーダーに影響を与えることができます。

可能であれば、タスクは要求されたレイヤーに移動されます。 要求が承認または拒否されると、コールバックが呼び出されます。 拒否された場合、コールバックは Exception.getMessage() を介してアクセス可能な説明メッセージを含む例外を受け取ります。

システム状態のために要求が拒否された場合、コールバックはAppTask.WINDOWING_LAYER_REQUEST_REJECTEDを受け取ります。 要求が許可されている場合、コールバックはAppTask.WINDOWING_LAYER_REQUEST_GRANTEDを受け取ります。

システムの整合性と一貫性のあるユーザー エクスペリエンスを確保するために、システムは特定のレイヤーを要求するタスクに制限を課す場合があります。 ピン留めされたレイヤーを要求するときの影響については、AppTask.WINDOWING_LAYER_PINNEDを参照してください。

AppTask.WINDOWING_LAYER_PINNEDが要求された場合は、AppOpsManager.OPSTR_PICTURE_IN_PICTUREを許可し、Manifest.permission.USE_PINNED_WINDOWING_LAYERアクセス許可を付与する必要があります。

開発者エラー (権限の不足や無効な引数など) が原因で要求が失敗した場合、エラーを説明する例外を指定して OutcomeReceiver.onError が呼び出されます。

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

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

適用対象