CameraCharacteristics.AvailableSessionKeys プロパティ

public System.Collections.Generic.IList<Android.Hardware.Camera2.CaptureRequest.Key>? AvailableSessionKeys { [Android.Runtime.Register("getAvailableSessionKeys", "()Ljava/util/List;", "", ApiSince=28)] get; }

[<get: Android.Runtime.Register("getAvailableSessionKeys", "()Ljava/util/List;", "", ApiSince=28)>]
member this.AvailableSessionKeys : System.Collections.Generic.IList<Android.Hardware.Camera2.CaptureRequest.Key>

プロパティ値

キャプチャ セッションの初期化中に渡すことができるキーの一覧。 カメラ デバイスがそのようなキーをサポートしていない場合、リストは null になる可能性があります。

属性

RegisterAttribute

注釈

キャプチャ セッションの初期化の一環としてカメラ デバイスが渡すことができる #getAvailableCaptureRequestKeys キーのサブセットを返します。

この一覧には、フレームごとに適用するのが困難なキーが含まれており、キャプチャ セッションの有効期間中に変更すると予期しない遅延が発生する可能性があります。 一般的な例としては、時間のかかるハードウェアの再構成や内部カメラ パイプラインの変更を必要とするパラメーターがあります。 パフォーマンス上の理由から、クライアントは SessionConfiguration#setSessionParametersの一部として初期値を渡すようにお勧めします。 カメラ キャプチャ セッションが有効になったら、 SessionConfiguration#setSessionParameters で設定された初期値から変更しないようにすることもお勧めします。 セッション パラメーターの制御はキャプチャ要求で引き続き実行できますが、クライアントはアプリケーション中に遅延を認識し、期待する必要があります。 使用シナリオの例は次のようになります。

<ul><li>カメラクライアントは、 android.hardware.camera2.CameraCharacteristics#getAvailableSessionKeys .<を介してセッションパラメータキーリストに対してクエリを実行することから始まります/li><li>キャプチャ セッションの作成シーケンスをトリガーする前に、特定のユース ケースに一致する適切なテンプレートを使用して CameraDevice#createCaptureRequest を使用してキャプチャ要求をビルドする必要があります</li><li>クライアントはセッション パラメーターの一覧を調べ、一覧に示されているキーの一部が、最初のキャプチャ要求の一部として変更するパラメーターと一致するかどうかを確認する必要があります</li><li>そのような一致がない場合は、キャプチャ要求を変更なしで SessionConfiguration#setSessionParameters .< に渡すことができます。/li><li>一致が存在する場合、クライアントはそれぞれの値を更新し、要求を SessionConfiguration#setSessionParameters .< に渡す必要があります。/li><li>キャプチャ セッションの初期化が完了した後、セッション パラメーターのキー リストは、追加の要求を投稿または更新するときに引き続き参照として機能できます。 前述のように、セッション パラメーターに対するその他の変更は避けるのが理想的ですが、更新が必要な場合は、クライアントがパラメータースイッチ中に遅延/グリッチを期待する可能性があります。</li></ul>

返されるリストは変更できないため、変更しようとすると UnsupportedOperationExceptionがスローされます。

各キーは、一覧に 1 回だけ表示されます。 キーの順序は定義されていません。

Javaドキュメント。

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