CameraCharacteristics.AvailableSessionKeys プロパティ

定義

名前空間:

Android.Hardware.Camera2

アセンブリ:

Mono.Android.dll

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

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>

プロパティ値

IList<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 ドキュメントandroid.hardware.camera2.CameraCharacteristics.getAvailableSessionKeys()

このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。