OutputConfiguration.StreamUseCase 屬性

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

屬性值

目前設定的串流使用情境

屬性

RegisterAttribute

備註

財產取得者文件：

取得目前的串流使用案例

若先呼叫 no #setStreamUseCase ，則此函數回傳 CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES_DEFAULT DEFAULT。

Java 文件 android.hardware.camera2.params.OutputConfiguration.getStreamUseCase()。

屬性設定文件：

為此設定串流使用情境 OutputConfiguration

串流的使用情境用來描述串流的用途，無論是用於即時預覽、靜態影像擷取、錄影，或是兩者的組合。 此旗標適用於當前消費者目標不足以顯示串流使用情況的情況。

串流使用情境與擷取意圖的主要差異在於，前者讓攝影機能根據每個串流的使用者情境優化攝影機硬體與軟體管線，而後者主要是提示攝影機決定適用於整個會話的最佳 3A 策略。 相機裝置執行如選擇調諧參數、選擇相機感測器模式，以及根據串流的使用情境建構影像處理流程等配置。 擷取意圖隨後用於微調3A行為，例如調整AE/AF收斂速度，且擷取意圖在會話生命週期中可能改變。 例如，對於PREVIEW_VIDEO_STILL用例串流與STILL_CAPTURE用例串流的會話，捕捉意圖可能是具備快速 3A 收斂速度與閃光測光並自動控制以進行即時預覽的預覽，STILL_CAPTURE 採用最佳 3A 參數以捕捉靜態照片，或VIDEO_RECORD採用較慢的 3A 融合速度以提升影片播放體驗。

攝影機裝置所支援的串流使用案例可透過查詢 android.hardware.camera2.CameraCharacteristics#SCALER_AVAILABLE_STREAM_USE_CASES。

涉及串流使用案例的強制串流組合可在 android.hardware.camera2.CameraDevice#createCaptureSession找到，並可透過 android.hardware.camera2.params.MandatoryStreamCombination查詢。 強烈建議選擇保證的串流組合之一，且所有串流的使用情境皆設為非預設值。 若應用程式選擇不在強制清單中的串流組合，攝影機裝置可能因硬體限制或實作細節而忽略某些使用案例標誌。

此函數必須在 或 CameraDevice#createCaptureSessionByOutputConfigurations之前CameraDevice#createCaptureSession被呼叫。 在 or CameraDevice#createCaptureSessionByOutputConfigurations 之後CameraDevice#createCaptureSession呼叫這個函式對相機工作階段沒有影響。

Java 文件 android.hardware.camera2.params.OutputConfiguration.setStreamUseCase(long)。

本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。