语言

TimestampBase 枚举

定义

指定用于相机输出图像时间戳的时间基数。

public enum TimestampBase
type TimestampBase = 
继承
TimestampBase

字段

名称 值 说明
Default 0

默认时间戳基。

相机设备根据输出图面的属性确定时间戳。

对于 SurfaceView 输出图面,时间戳基为 ChoreographerSynced。 当相机设备以固定帧速率运行时,使用显示子系统中的编舞器脉冲重写时间戳,以便更流畅地显示相机帧。 时间戳大致与 SystemClock.uptimeMillis 相同。

对于具有HardwareBuffer.USAGE_VIDEO_ENCODE使用标志的 MediaRecorder、MediaCodec 或 ImageReader 的输出图面,时间戳基数 Monotonic与 SystemClock.uptimeMillis 大致相同。

对于所有其他情况,时间戳基数与 SensorCameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE指定的时间戳相同。 对于 SurfaceTexture 输出图面,相机系统根据图像读出间隔重新设置输出帧的传递空间,从而减少取景器抖动。 图像的时间戳保持不变 Sensor。

请注意,SurfaceView 和 SurfaceTexture 的帧抖动减少与光对光延迟略有增加,这是从光子命中场景到相应像素在屏幕上显示的时间。 如果光对光延迟比取景器的平滑度更重要,则应改用TIMESTAMP_BASE_SENSOR。

Android 参考。android.hardware.camera2.params.OutputConfiguration.TIMESTAMP_BASE_DEFAULT

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

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

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Monotonic 2

时间戳基本与 SystemClock.uptimeMillis 大致相同。

输出映像的时间戳单调增加,大致与 SystemClock.uptimeMillis 相同。 具有此时间基的时间戳可直接用于视频录制中的音频视频同步。

如果相机设备的CameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE为 REALTIME,则具有此时间的时间戳不能直接匹配 CameraCaptureSession.CaptureCallback.onCaptureStarted、CameraCaptureSession.CaptureCallback.onReadoutStarted 中的时间戳或 CaptureResult 中的传感器时间戳。

Android 参考。android.hardware.camera2.params.OutputConfiguration.TIMESTAMP_BASE_MONOTONIC

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

Realtime 3

时间戳基大致与 SystemClock.elapsedRealtime() 相同。

输出映像的时间戳大致与 SystemClock.elapsedRealtime()相同。 此时间基时间戳不能直接用于视频录制中的音频视频同步。

如果相机设备的CameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE未知,则具有此时间的时间戳不能直接匹配 CameraCaptureSession.CaptureCallback.onCaptureStarted、CameraCaptureSession.CaptureCallback.onReadoutStarted 或 CaptureResult 中的传感器时间戳。

如果在仅支持TIMESTAMP_SOURCE_UNKNOWN的设备上使用 REALTIME 时间戳,则时间戳的准确性只是未知文档中保证的。 特别是,对于图像防抖动或增强现实等功能,它们无法保证在将图像数据与惯性传感器输出混为一谈时足够准确。

Android 参考。android.hardware.camera2.params.OutputConfiguration.TIMESTAMP_BASE_REALTIME

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

ChoreographerSynced 4

时间戳将同步到编舞器。

输出图像的时间戳使用显示子系统中的编舞器脉冲重写,以便更流畅地显示相机帧。 SurfaceView 的输出目标默认使用此时间基。 请注意,时间戳替代仅适用于固定相机帧速率。

此时间戳基不适用于 SurfaceTexture 目标。 SurfaceTexture 的 updateTexImage 函数始终使用相机流中的最新图像。 对于 TextureView,图像会立即显示。

具有此时间基的时间戳不能直接匹配 CameraCaptureSession.CaptureCallback.onCaptureStarted、CameraCaptureSession.CaptureCallback.onReadoutStarted 中的时间戳或 CaptureResult 中的传感器时间戳。 如果需要将时间戳用于音频视频同步,则不应使用此时间戳基。

Android 参考。android.hardware.camera2.params.OutputConfiguration.TIMESTAMP_BASE_CHOREOGRAPHER_SYNCED

本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。

注解

将这些值与 TimestampBase. 传感器时间戳使用相机播发的时间戳源。 单调时间戳使用接近系统运行时间的时间基数;实时时间戳使用接近已用实时的时间基数。 编舞同步时间戳遵循固定相机帧速率的显示脉冲。

不要假定可以直接比较来自不同基的时间戳。 具体而言,显示同步的时间戳与捕获回调或捕获结果传感器时间戳不匹配。 默认基数取决于输出目标。

适用于时间戳基数和比较限制的 Android 16 源。

适用于