OutputConfiguration.StreamUseCase 屬性

定義

命名空間:

Android.Hardware.Camera2.Params

組件:

Mono.Android.dll

取得目前的數據流使用案例 -或- 設定此 OutputConfiguration 的數據流使用案例

public long StreamUseCase { [Android.Runtime.Register("getStreamUseCase", "()J", "", ApiSince=33)] get; [Android.Runtime.Register("setStreamUseCase", "(J)V", "", ApiSince=33)] set; }

[<get: Android.Runtime.Register("getStreamUseCase", "()J", "", ApiSince=33)>]
[<set: Android.Runtime.Register("setStreamUseCase", "(J)V", "", ApiSince=33)>]
member this.StreamUseCase : int64 with get, set

屬性值

Int64

目前設定的數據流使用案例

屬性

RegisterAttribute

備註

屬性 getter 檔：

取得目前的數據流使用案例

#setStreamUseCase如果未先呼叫 ，則此函式會傳CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES_DEFAULT DEFAULT回 。

的 android.hardware.camera2.params.OutputConfiguration.getStreamUseCase()Java 檔。

屬性 setter 檔：

設定此 OutputConfiguration 的數據流使用案例

串流使用案例可用來描述串流的目的，無論是用於即時預覽、仍影像擷取、視訊錄製或其組合。 此旗標適用於立即取用者目標不足以指出數據流使用量的案例。

串流使用案例和擷取意圖的主要差異在於，前者可讓相機裝置根據每個數據流的使用者案例優化相機硬體和軟體管線，而後者主要是相機的提示，以決定適用於整個會話的最佳 3A 策略。 相機裝置會執行設定，例如選取微調參數、選擇相機感測器模式，以及根據數據流的使用案例建構影像處理管線。 接著會使用擷取意圖來微調 3A 行為，例如調整 AE/AF 聚合速度，而擷取意圖可能會在會話的存留期內變更。 例如，對於具有PREVIEW_VIDEO_STILL使用案例串流和STILL_CAPTURE使用案例串流的會話，擷取意圖可能是具有快速 3A 聚合速度的預覽，以及具有自動控制即時預覽的快閃計量，STILL_CAPTURE使用最佳 3A 參數進行相片擷取，或是使用較慢的 3A 聚合速度 VIDEO_RECORD進行較慢的 3A 聚合速度，以取得更佳的視訊播放體驗。

相機裝置支援的串流使用案例可由 查詢 android.hardware.camera2.CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES。

您可以在 中找到 android.hardware.camera2.CameraDevice#createCaptureSession涉及串流使用案例的必要數據流組合，並透過 android.hardware.camera2.params.MandatoryStreamCombination查詢。 強烈建議應用程式選取其中一個保證數據流組合，其中所有數據流的使用案例都設定為非 DEFAULT 值。 如果應用程式選擇不在強制清單中的數據流組合，相機裝置可能會因為硬體條件約束或實作詳細數據而忽略某些使用案例旗標。

必須在 或CameraDevice#createCaptureSessionByOutputConfigurations之前CameraDevice#createCaptureSession呼叫此函式。 在 或 CameraDevice#createCaptureSessionByOutputConfigurations 之後CameraDevice#createCaptureSession呼叫此函式，對相機會話沒有任何作用。

的 android.hardware.camera2.params.OutputConfiguration.setStreamUseCase(long)Java 檔。

此頁面的部分是根據 Android 開放原始碼專案所建立和共用的工作進行修改，並根據 Creative Commons 2.5 屬性授權中所述的詞彙使用。