語言

CameraCaptureSession.CaptureCallback.OnReadoutStarted 方法

定義

命名空間:
Android.Hardware.Camera2
組件:
Mono.Android.dll

此方法在相機裝置開始讀取請求的輸出影像時，也就是感測器影像讀出的開始時所呼叫。

[Android.Runtime.Register("onReadoutStarted", "(Landroid/hardware/camera2/CameraCaptureSession;Landroid/hardware/camera2/CaptureRequest;JJ)V", "GetOnReadoutStarted_Landroid_hardware_camera2_CameraCaptureSession_Landroid_hardware_camera2_CaptureRequest_JJHandler", ApiSince=34)]
public virtual void OnReadoutStarted(Android.Hardware.Camera2.CameraCaptureSession session, Android.Hardware.Camera2.CaptureRequest request, long timestamp, long frameNumber);
[<Android.Runtime.Register("onReadoutStarted", "(Landroid/hardware/camera2/CameraCaptureSession;Landroid/hardware/camera2/CaptureRequest;JJ)V", "GetOnReadoutStarted_Landroid_hardware_camera2_CameraCaptureSession_Landroid_hardware_camera2_CaptureRequest_JJHandler", ApiSince=34)>]
abstract member OnReadoutStarted : Android.Hardware.Camera2.CameraCaptureSession * Android.Hardware.Camera2.CaptureRequest * int64 * int64 -> unit
override this.OnReadoutStarted : Android.Hardware.Camera2.CameraCaptureSession * Android.Hardware.Camera2.CaptureRequest * int64 * int64 -> unit

參數

session
CameraCaptureSession

會議回程 CameraDevice#createCaptureSession

request
CaptureRequest

剛開始的讀數請求

timestamp
Int64

對於一般請求，讀取開始的時間戳記，或重新處理請求輸入影像讀取開始時的時間戳，單位為奈秒。

frameNumber
Int64

此擷取的幀數

屬性
RegisterAttribute

備註

此方法在相機裝置開始讀取請求的輸出影像時，也就是感測器影像讀出的開始時所呼叫。

對於擷取請求，此回調會在 之後 #onCaptureStarted立即啟動。 與 #onCaptureStarted不同，這個回調不會傳遞曝光開始的時間戳，而是傳遞相機資料讀取開始的時間戳。 這很有用，因為對於固定幀率運作的相機來說，讀取開始間隔是固定的，這對於曝光開始不一定如此，特別是當自動曝光會在幀間改變曝光時間時。

時間戳記與啟用讀出時間戳（透過 OutputConfiguration#setReadoutTimestampEnabled）的輸出表面時間戳記相符，若：

<ul>li 時間戳基底為 OutputConfiguration#TIMESTAMP_BASE_DEFAULT 和輸出 <ul><li> 不是 SurfaceView 表面，/<li<>li> 也不是 MediaRecoder、MediaCodec 或 ImageReader 的 android.hardware.HardwareBuffer#USAGE_VIDEO_ENCODE surface 帶有使用標誌，裝置的 CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE surface 是<UNKNOWN /li></ul></li<>li> 時間戳基底是 OutputConfiguration#TIMESTAMP_BASE_SENSOR，</li><li> 時間戳基底是OutputConfiguration#TIMESTAMP_BASE_MONOTONIC，裝置CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE的<UNKNOWN ，/li><li> 時間戳基底是OutputConfiguration#TIMESTAMP_BASE_REALTIME><裝置CameraCharacteristics#SENSOR_INFO_TIMESTAMP_SOURCE的<REALTIME /li></ul>

否則，時間戳記就不會和輸出表面的時間戳記相符。 詳情請參見可能的參數 OutputConfiguration#setTimestampBase 。

只有當 CameraCharacteristics#SENSOR_READOUT_TIMESTAMP 是 時 CameraMetadata#SENSOR_READOUT_TIMESTAMP_HARDWARE才會呼叫這個回調，且是在 #onCaptureStarted之後 。

Java 文件 android.hardware.camera2.CameraCaptureSession.CaptureCallback.onReadoutStarted(android.hardware.camera2.CameraCaptureSession, android.hardware.camera2.CaptureRequest, long, long)。

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

適用於