語言

TimestampBase 列舉

定義

指定相機輸出影像時間戳的時間基準。

public enum TimestampBase
type TimestampBase = 
繼承
TimestampBase

欄位

名稱 值 Description
Default 0

預設的時間戳記基礎。

攝影機裝置根據輸出表面的特性決定時間戳記。

對於 SurfaceView 輸出曲面,時間戳基底為 ChoreographerSynced。 時間戳會被顯示子系統的編舞脈衝覆蓋,以便在固定幀率下,讓攝影機畫面顯示更流暢。 時間戳記大致與 SystemClock.uptimeMillis() 的時間基序相同。

對於HardwareBuffer.USAGE_VIDEO_ENCODE具有使用標誌的 MediaRecorder、MediaCodec 或 ImageReader 的輸出表面,其時間戳記基底為 Monotonic,與 SystemClock.uptimeMillis() 大致相同的時間基底。

在其他所有情況下,時間戳基底為 Sensor,與 CameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE 所指定的相同。 對於 SurfaceTexture 輸出表面,相機系統會根據影像讀出間隔重新調整輸出畫面的傳送間隔,以減少觀景器抖動。 影像的時間戳記仍為 Sensor。

請注意,SurfaceView 和 SurfaceTexture 減少影格抖動後,光子對光子延遲會略有增加,也就是從光子進入場景到對應像素出現在螢幕上的時間。 如果光子間延遲比取景窗的平滑度更重要,則應該改用TIMESTAMP_BASE_SENSOR。

Android 參考資料。android.hardware.camera2.params.OutputConfiguration.TIMESTAMP_BASE_DEFAULT

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

Sensor 1

時間戳記為CameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE。

輸出影像的時間戳記依照 CameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE 規定的時間基底。 應用程式可以透過將時間戳記與 CameraCaptureSession.CaptureCallback.onCaptureStarted,或如果使用讀取時間戳記,則以 CameraCaptureSession.CaptureCallback.onReadoutStarted,來查詢對應的結果元資料。

Android 參考資料。android.hardware.camera2.params.OutputConfiguration.TIMESTAMP_BASE_SENSOR

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

Monotonic 2

時間戳基底大致與 SystemClock.uptimeMillis()。

輸出影像的時間戳記單調遞增,且大致與 SystemClock.uptimeMillis() 的時間基底相同。 帶有此時間基準的時間戳可以直接用於錄影中的音視頻同步。

若攝影機裝置的CameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE為即時,則使用此時間基準的時間戳記無法直接匹配 CameraCaptureSession.CaptureCallback.onCaptureStarted、CameraCaptureSession.CaptureCallback.onReadoutStarted 或 CaptureResult 中的感測器時間戳。

Android 參考資料。android.hardware.camera2.params.OutputConfiguration.TIMESTAMP_BASE_MONOTONIC

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

Realtime 3

時間戳記基數大致與 SystemClock.elapsedRealtime( 相同)。

輸出影像的時間戳大致與 SystemClock.elapsedRealtime() 的時間基底相同。 帶有此時間基準的時間戳無法直接用於錄影中的音視頻同步。

若相機裝置的CameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE為未知,則使用此時間基準的時間戳記無法直接與 CameraCaptureSession.CaptureCallback.onCaptureStarted、CameraCaptureSession.CaptureCallback.onReadoutStarted 或 CaptureResult 中的感測器時間戳記相符。

如果在只支援 TIMESTAMP_SOURCE_UNKNOWN 的裝置上使用即時時間戳記基底,時間戳的準確性僅在 UNKNOWN 文件中保證。 特別是,對於影像資料與慣性感測器輸出融合影像資料(如影像穩定或擴增實境)的準確性,無法保證其準確性。

Android 參考資料。android.hardware.camera2.params.OutputConfiguration.TIMESTAMP_BASE_REALTIME

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

ChoreographerSynced 4

時間戳記會與編舞家同步。

輸出影像的時間戳會被顯示子系統的編舞脈衝覆蓋,以提升攝影機畫面的平滑顯示。 SurfaceView 的輸出目標預設使用此時間基準。 請注意,時間戳覆寫僅適用於固定攝影機的幀率。

這個時間戳基底不適用於 SurfaceTexture 目標。 SurfaceTexture 的 updateTexImage 函式總是使用相機串流中最新的影像。 以 TextureView 為例,圖片會立即顯示。

使用此時間基底的時間戳記無法直接匹配 CameraCaptureSession.CaptureCallback.onCaptureStarted、CameraCaptureSession.CaptureCallback.onReadoutStarted 或 CaptureResult 中的感測器時間戳記。 如果需要用來進行音視訊同步,這個時間戳記底座就不應該使用。

Android 參考資料。android.hardware.camera2.params.OutputConfiguration.TIMESTAMP_BASE_CHOREOGRAPHER_SYNCED

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

備註

使用這些值 。TimestampBase 感測器時間戳記使用相機標示的時間戳來源。 單調時間戳記使用接近系統運作時間的時間基準;即時時間戳記使用接近經過的即時時間基準。 編舞師同步的時間戳會跟隨固定攝影機幀率的顯示脈衝。

不要假設不同基地的時間戳可以直接比較。 特別是,顯示同步的時間戳記不會直接匹配擷取回撥或擷取結果感測器的時間戳。 預設基底取決於輸出目標。

Android 16 時間戳基底與比較限制的來源。

適用於