OutputConfiguration クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
キャプチャ セッションを作成するための特定の構成を含む Surface
カメラ出力を記述するためのクラス。
[Android.Runtime.Register("android/hardware/camera2/params/OutputConfiguration", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class OutputConfiguration : Java.Lang.Object, Android.OS.IParcelable, IDisposable, Java.Interop.IJavaPeerable
[<Android.Runtime.Register("android/hardware/camera2/params/OutputConfiguration", ApiSince=24, DoNotGenerateAcw=true)>]
type OutputConfiguration = class
inherit Object
interface IParcelable
interface IJavaObject
interface IDisposable
interface IJavaPeerable
- 継承
- 属性
- 実装
注釈
キャプチャ セッションを作成するための特定の構成を含む Surface
カメラ出力を記述するためのクラス。
OutputConfigurations をインスタンス化、変更、および使用するには、いくつかの方法があります。 最も一般的で推奨される使用パターンを次の一覧にまとめます。
<ul><li>コンストラクターに a Surface
を渡し、引数として OutputConfiguration インスタンスを使用します CameraDevice#createCaptureSessionByOutputConfigurations
。 これは最も頻繁な使用であり、クライアントは他のより複雑な代替手段の前に最初にそれを考慮する必要があります。 </李>
<li>コンストラクターへの引数としてサーフェス ソース クラスのみを渡します。 通常、この後にキャプチャ セッションを作成する呼び出しが続きます (有効なSurface
呼び出しをSurface
参照CameraDevice#createCaptureSessionByOutputConfigurations
して追加します#addSurface
。 シーケンスは次で CameraCaptureSession#finalizeOutputConfigurations
完了します。 これは、UI の初期化の一部として準備が整うのを待android.view.SurfaceView
つなど、リソースを集中的に使用するキャプチャ セッションの作成呼び出しを初期化とSurface
並行して実行できるようにすることで、パフォーマンスを向上することを目的とした遅延使用ケースです。</李>
<li>3 番目の最も複雑な使用パターンには、サーフェス共有が含まれます。 インスタンス化されると、OutputConfiguration を使用して #enableSurfaceSharing
サーフェス共有を有効にすることができます。 これは、新しいキャプチャ セッションを作成し、呼び出しを有効にする前に CameraCaptureSession#updateOutputConfiguration
行う必要があります。 サーフェス共有が有効な OutputConfiguration は、次を介して#addSurface
#removeSurface
変更できます。 この OutputConfiguration の更新は、例外をスローせずに戻った後 CameraCaptureSession#updateOutputConfiguration
にのみ有効になります。 このような更新は、セッションがアクティブである限り実行できます。 クライアントは常に、出力サーフェスに配置される追加の要件と制限事項を考慮する必要があります (詳細については、,, #addSurface
を#removeSurface
CameraCaptureSession#updateOutputConfiguration
参照#enableSurfaceSharing
してください)。 追加の複雑さと柔軟性の間にはトレードオフがあります。 正しくサーフェス共有を実行すると、継続的な繰り返しキャプチャ要求を中断することなく、異なる出力サーフェスを切り替えることができます。 これにより、時間が節約され、ユーザー エクスペリエンスが大幅に向上します。</李>
<li>Surface 共有は、遅延サーフェスと組み合わせて使用できます。 どちらの場合もルールが組み合わされ、クライアントはキャプチャ セッションを作成する前に呼び出す #enableSurfaceSharing
必要があります。 を使用CameraCaptureSession#finalizeOutputConfigurations
して#addSurface
/#removeSurface
出力サーフェスをアタッチまたは削除し、構成を最終処理します。 CameraCaptureSession#updateOutputConfiguration
は、構成の最終処理メソッドが例外なしで返された後に呼び出すことができます。</李>
<li>カメラデバイスがマルチ解像度出力ストリームをサポートしている場合は、 CameraCharacteristics#SCALER_MULTI_RESOLUTION_STREAM_CONFIGURATION_MAP
フォーマットとそれに対応するストリーム情報が含まれます。 アプリケーションでは、マルチ解像度ストリーム情報を照会して作成された MultiResolutionStreamConfigurationMap#getOutputInfo
OutputConfiguration を使用して、 android.hardware.camera2.MultiResolutionImageReader
可変サイズのイメージをキャプチャできます。
</ul>
現在、デバイスのandroid.os.Build.VERSION_CODES#P Android P
サポートに応じて、共有を除くImageFormat#JPEG
ImageFormat#RAW_PRIVATE
すべての形式を使用できます。 以前の API レベルでは、形式のみを ImageFormat#PRIVATE
使用できます。
の Java ドキュメントandroid.hardware.camera2.params.OutputConfiguration
このページの一部は、Android オープンソース プロジェクトによって作成および共有され、クリエイティブ コモンズ 2.5 属性ライセンスに記載されている条件に従って使用される作業に基づく変更です。
コンストラクター
OutputConfiguration(Int32, Surface) |
サーフェス グループ ID を持つ |
OutputConfiguration(Size, Class) |
必要な Surface サイズと Surface ソース クラスを使用して、新しい |
OutputConfiguration(Surface) |
を使用して新しい |
フィールド
MirrorModeAuto |
古い.
カメラ向きに基づく自動ミラーリング |
MirrorModeH |
古い.
カメラの出力が水平方向にミラーリングされる |
MirrorModeNone |
古い.
ミラー変換が適用されない |
MirrorModeV |
古い.
カメラ出力が垂直方向にミラー化される |
SurfaceGroupIdNone |
無効なサーフェス グループ ID。 |
TimestampBaseChoreographerSynced |
古い.
タイムスタンプは振付家に同期されます。 |
TimestampBaseDefault |
古い.
既定のタイムスタンプ ベース。 |
TimestampBaseMonotonic |
古い.
タイムスタンプのベースは 、ほぼ同じです |
TimestampBaseRealtime |
古い.
タイムスタンプのベースは 、ほぼ同じです |
TimestampBaseSensor |
古い.
Timestamp base of |
プロパティ
Class |
この |
Creator |
キャプチャ セッションを作成するための特定の構成を含む |
DynamicRangeProfile |
現在のダイナミック レンジ プロファイルを返します。 または、サポートされている特定のデバイスのダイナミック レンジ プロファイルを設定します。 |
Handle |
基になる Android インスタンスへのハンドル。 (継承元 Object) |
JniIdentityHashCode |
キャプチャ セッションを作成するための特定の構成を含む |
JniPeerMembers |
キャプチャ セッションを作成するための特定の構成を含む |
MaxSharedSurfaceCount |
サポートされている共有 |
MirrorMode |
現在のミラーリング モードを取得します。または、この出力ターゲットのミラーリング モードを設定します |
PeerReference |
キャプチャ セッションを作成するための特定の構成を含む |
ReadoutTimestampEnabled |
この OutputConfiguration に読み取り出力タイムスタンプが使用されるかどうか。 または、カメラ センサーの読み取り時間を画像のタイムスタンプに使用します。 |
StreamUseCase |
現在のストリームのユース ケースを取得します。または、この OutputConfiguration のストリームユース ケースを設定します |
Surface |
これに |
SurfaceGroupId |
これに関連付けられているサーフェス グループ ID を取得します |
Surfaces |
これに |
ThresholdClass |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object) |
ThresholdType |
この API は Android 用 Mono インフラストラクチャをサポートしており、コードから直接使用するためのものではありません。 (継承元 Object) |
TimestampBase |
現在のタイムスタンプベースを取得するか、この出力ターゲットのタイムスタンプベースを設定します |
メソッド
AddSensorPixelModeUsed(Int32) |
この OutputConfiguration が使用されるセンサー ピクセル モードを追加します。 |
AddSurface(Surface) |
この OutputConfiguration にサーフェスを追加します。 |
Clone() |
このオブジェクトのコピーを作成して返します。 (継承元 Object) |
CreateInstancesForMultiResolutionOutput(MultiResolutionImageReader) |
によって使用される出力のインスタンスの |
DescribeContents() |
キャプチャ セッションを作成するための特定の構成を含む |
Dispose() |
キャプチャ セッションを作成するための特定の構成を含む |
Dispose(Boolean) |
キャプチャ セッションを作成するための特定の構成を含む |
EnableSurfaceSharing() |
同じ OutputConfiguration を共有する複数のサーフェスを有効にする |
Equals(Object) |
他のオブジェクトがこのオブジェクトと "等しい" かどうかを示します。 (継承元 Object) |
GetHashCode() |
オブジェクトのハッシュ コード値を返します。 (継承元 Object) |
JavaFinalize() |
オブジェクトへの参照がなくなったとガベージ コレクションによって判断されたときに、オブジェクトのガベージ コレクターによって呼び出されます。 (継承元 Object) |
Notify() |
このオブジェクトのモニターで待機している 1 つのスレッドを起動します。 (継承元 Object) |
NotifyAll() |
このオブジェクトのモニターで待機しているすべてのスレッドを起動します。 (継承元 Object) |
RemoveSensorPixelModeUsed(Int32) |
この OutputConfiguration から、addSensorPixelModeUsed によって以前に追加されたセンサー ピクセル モードを削除します。 |
RemoveSurface(Surface) |
この OutputConfiguration からサーフェスを削除します。 |
SetHandle(IntPtr, JniHandleOwnership) |
Handle プロパティを設定します。 (継承元 Object) |
SetPhysicalCameraId(String) |
この OutputConfiguration の物理カメラの ID を設定する |
ToArray<T>() |
キャプチャ セッションを作成するための特定の構成を含む |
ToString() |
オブジェクトの文字列表現を返します。 (継承元 Object) |
UnregisterFromRuntime() |
キャプチャ セッションを作成するための特定の構成を含む |
Wait() |
現在のスレッドが目覚めるまで待機させます。通常<は、通知<>/em> または <em>割り込み/em> を受け<取ります。 (継承元 Object) |
Wait(Int64, Int32) |
現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object) |
Wait(Int64) |
現在のスレッドが目覚めるまで待機します。通常<><は、通知/em> または <em>中断</em> によって、または一定のリアルタイムが経過するまで待機します。 (継承元 Object) |
WriteToParcel(Parcel, ParcelableWriteFlags) |
キャプチャ セッションを作成するための特定の構成を含む |
明示的なインターフェイスの実装
IJavaPeerable.Disposed() |
キャプチャ セッションを作成するための特定の構成を含む |
IJavaPeerable.DisposeUnlessReferenced() |
キャプチャ セッションを作成するための特定の構成を含む |
IJavaPeerable.Finalized() |
キャプチャ セッションを作成するための特定の構成を含む |
IJavaPeerable.JniManagedPeerState |
キャプチャ セッションを作成するための特定の構成を含む |
IJavaPeerable.SetJniIdentityHashCode(Int32) |
キャプチャ セッションを作成するための特定の構成を含む |
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates) |
キャプチャ セッションを作成するための特定の構成を含む |
IJavaPeerable.SetPeerReference(JniObjectReference) |
キャプチャ セッションを作成するための特定の構成を含む |
拡張メソッド
JavaCast<TResult>(IJavaObject) |
Android ランタイムチェック型変換を実行します。 |
JavaCast<TResult>(IJavaObject) |
キャプチャ セッションを作成するための特定の構成を含む |
GetJniTypeName(IJavaPeerable) |
キャプチャ セッションを作成するための特定の構成を含む |