CaptureResult.ControlSettingsOverride プロパティ

[Android.Runtime.Register("CONTROL_SETTINGS_OVERRIDE", ApiSince=34)]
public static Android.Hardware.Camera2.CaptureResult.Key ControlSettingsOverride { get; }

[<Android.Runtime.Register("CONTROL_SETTINGS_OVERRIDE", ApiSince=34)>]
static member ControlSettingsOverride : Android.Hardware.Camera2.CaptureResult.Key

プロパティ値

必要な CaptureRequest 設定は、特定のキーが早く有効になるように、以前に適用される設定よりも優先されます。

属性

RegisterAttribute

注釈

必要な CaptureRequest 設定は、特定のキーが早く有効になるように、以前に適用される設定よりも優先されます。

CaptureRequest 内のコントロールを同時に有効にする必要がない場合は、他のキーよりも早く適用できる CaptureRequest キーがいくつかあります。 そのような例の 1 つはズームです。 ズームは、カメラ パイプラインの後の段階で適用できます。 カメラ デバイスが CaptureRequest を受け取るとすぐに、要求されたズーム値をパイプラインに既に存在する以前の要求に適用できるため、ズームの待機時間が短縮されます。

キャプチャ結果のこのキーの値は、このキャプチャのコントロールが新しい要求によって "by" オーバーライドされるかどうかを反映します。 つまり、キャプチャ要求が設定のオーバーライドをオンにした場合、以前の要求のキャプチャ結果には ZOOM のキー値が含まれます。 一方、キャプチャ要求で設定オーバーライドが有効になっていても、新しい要求がすべて無効になっている場合、このキャプチャは新しいキャプチャによってオーバーライドされないため、キャプチャ結果のキーの値は OFF になります。 次の 2 つの例では、キャプチャ結果列にさまざまなシナリオでの settingsOverride 値が示されています。

Camera session created
Request 1 (zoom=1.0x, override=ZOOM) ->
Request 2 (zoom=1.2x, override=ZOOM) ->
Request 3 (zoom=1.4x, override=ZOOM) ->  Result 1 (zoom=1.2x, override=ZOOM)
Request 4 (zoom=1.6x, override=ZOOM) ->  Result 2 (zoom=1.4x, override=ZOOM)
Request 5 (zoom=1.8x, override=ZOOM) ->  Result 3 (zoom=1.6x, override=ZOOM)
                                     ->  Result 4 (zoom=1.8x, override=ZOOM)
                                     ->  Result 5 (zoom=1.8x, override=OFF)

アプリケーションでは、設定のオーバーライドを有効にして、通常どおりズームを使用できます。 この例では、それ以降のズーム値 (1.2x、1.4x、1.6x、1.8x) によって、以前の要求 (#1、#2、#3、#4) のズーム値 (1.0x、1.2x、1.4x、1.8x) が上書きされることを示しています。

アプリケーションでは、設定のオーバーライドが、要求された出力ターゲットで CaptureRequest 内のすべてのコントロールの同時アプリケーションを必要とするユーザー体験に干渉しないようにする必要があります。 たとえば、アプリケーションが CameraCaptureSession#capture を使用してまだキャプチャを受け取り、繰り返し要求がオーバーライドを使用してすぐに別のズーム値を設定する場合、処理中のキャプチャでは、ズーム値が予期せず上書きされる可能性があります。

そのため、アプリケーションは、静止/バースト キャプチャを取得するときに settingsOverride をオフにし、ビューファインダー要求が繰り返され、処理中の静止/バースト キャプチャがない場合は再びオンにすることを強くお勧めします。

Request 1 (zoom=1.0x, override=OFF)
Request 2 (zoom=1.2x, override=OFF)
Request 3 (zoom=1.4x, override=ZOOM)  -> Result 1 (zoom=1.0x, override=OFF)
Request 4 (zoom=1.6x, override=ZOOM)  -> Result 2 (zoom=1.4x, override=ZOOM)
Request 5 (zoom=1.8x, override=OFF)   -> Result 3 (zoom=1.6x, override=ZOOM)
                                      -> Result 4 (zoom=1.6x, override=OFF)
                                      -> Result 5 (zoom=1.8x, override=OFF)

この例では、アプリケーションの "傾斜" 設定は、コントロールを ZOOM に設定することでオーバーライドされることを示しています。 この例では、要求 #3 でズーム設定のオーバーライドが有効になります。 カメラ デバイスはズームを 1 フレームずつ高速に適用できるため、要求 #2 の出力には 1.4 倍のズームがあり、要求 #3 で指定された値になります。アプリケーションは、コントロールを OFF に設定することで、設定のオーバーライドを "傾斜" します。 この例では、要求 #5 によってオーバーライドが OFF に変更されます。 要求 #4 のズームは結果 #3 で有効になるため、結果 #4 のズームは、結果 #5 で新しい値が有効になるまで同じままです

使用可能な値: OFF;ZOOM

このデバイスで使用できる値: android.control.availableSettingsOverrides

省略可能 - 一部のデバイスでは、このキーの値が null になる場合があります。

android.hardware.camera2.CaptureResult.CONTROL_SETTINGS_OVERRIDEの Android リファレンス。

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