語言

ScalerAvailableStreamUseCases 列舉

定義

public enum ScalerAvailableStreamUseCases
type ScalerAvailableStreamUseCases = 
繼承
ScalerAvailableStreamUseCases

欄位

名稱 值 Description
Default 0

預設串流使用情境。

這種使用情境和應用程式沒有設定串流使用情境的情況是一樣的。 相機裝置會利用輸出目標的屬性,例如格式、DataSpace 或 surface class 類型,來優化影像處理流程。

Android 參考資料。android.hardware.camera2.CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_DEFAULT

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

Preview 1

直播會顯示給使用者。

優化了作為取景器的效能和易用性,但不一定是為了畫質。 輸出並非為了保存成儲存的圖片或影片。

只要 android.control.* 設定為 FAST,就不會卡頓。 如果設定為HIGH_QUALITY,可能會有熄火。 此使用情境與預設的 SurfaceView 和 SurfaceTexture 目標相同。 此外,此應用情境也可用於應用內影像分析。

Android 參考資料。android.hardware.camera2.CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_PREVIEW

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

StillCapture 2

靜態照片捕捉。

優化為高品質高解析度擷取,且不預期能維持類似預覽的幀率。

無論 android.control.* 是否HIGH_QUALITY,串流都可能出現停頓。 此使用情境與預設的 JPEG 和 RAW 相關格式行為相同。

Android 參考資料。android.hardware.camera2.CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_STILL_CAPTURE

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

VideoRecord 3

錄製影片片段。

優化為高品質影片拍攝,若裝置支援並由應用程式啟用,則具備高品質影像穩定功能。 因此,可能產生來自即時的輸出幀,延遲相當大,以便進行最高品質的穩定或其他處理。 因此,這類輸出不適合直接繪製到螢幕上,預期會持續保存到磁碟或類似軟體,以便日後播放或處理。 只有設定VIDEO_RECORD使用情境的串流,當視訊穩定控制設定為開啟時,才保證會啟用影片穩定,而非PREVIEW_STABILIZATION。

此使用情境與預設的 MediaRecorder 及 MediaCodec 目標具有相同的行為。

Android 參考資料。android.hardware.camera2.CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_VIDEO_RECORD

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

PreviewVideoStill 4

單一串流用於預覽、影片和靜態拍攝的綜合用途。

對於這種多功能串流,攝影機裝置致力於在個別使用情境間做出最佳取捨。 例如,STILL_CAPTURE的使用情境本身可能有延遲以達到最佳影像品質。 但若結合 PREVIEW 與 VIDEO_RECORD,相機必須在額外的影像處理與速度之間取得平衡,避免預覽與錄影變慢。

同樣地,VIDEO_RECORD 可能產生有明顯延遲的影格,但PREVIEW_VIDEO_STILL必須有最小的輸出延遲。 這表示要在此使用情境下啟用視訊穩定,裝置必須支援且應用程式必須選擇影片穩定的PREVIEW_STABILIZATION模式。

Android 參考資料。android.hardware.camera2.CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_PREVIEW_VIDEO_STILL

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

VideoCall 5

長時視訊通話優化於能源效率與影像品質。

相機感光元件可能會以較低解析度模式運作,以降低功耗,但代價是部分影像與數位變焦品質。 與VIDEO_RECORD不同,VIDEO_CALL輸出預期能在黑暗環境中運作,因此通常會搭配可變的幀率設定,以便在低光環境下有足夠的曝光時間。

Android 參考資料。android.hardware.camera2.CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_VIDEO_CALL

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

CroppedRaw 6

當客戶端選擇裁切視野時,裁切了 RAW 串流。

某些類型的影像感測器可在分箱模式下運行,以提升捕捉畫面時的訊噪比。 然而,在特定變焦等級及/或其他場景條件適合時,相機子系統可能會選擇取消分箱並重新拼接感測器輸出。 這會產生一個在視野中裁切的 RAW 幀,但像素數與全視野 RAW 相同,從而提升影像細節。

RAW 串流的最終視野將大於或等於可裁切的非 RAW 串流。 此 RAW 串流的有效裁切區域會反映在 CaptureResult 鍵中,稱為 android.scaler.rawCropRegion。

如果這個串流的使用場景設定在非 RAW 的串流上,也就是說不是以下之一:RAW_SENSOR;RAW10;RAW12;RAW14

會話設定並不保證成功。

此串流使用情境可能不支援某些裝置。

Android 參考資料。android.hardware.camera2.CameraMetadata.SCALER_AVAILABLE_STREAM_USE_CASES_CROPPED_RAW

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

適用於