TimestampBase 枚举
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
指定用于相机输出图像时间戳的时间基数。
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 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| Sensor | 1 | CameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE的时间戳基数。 输出图像的时间戳位于由CameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE指定的时间基中。 应用程序可以通过将时间戳与 CameraCaptureSession.CaptureCallback.onCaptureStarted 匹配,或使用 CameraCaptureSession.CaptureCallback.onReadoutStarted 来查找相应的结果元数据(如果使用读取时间戳)。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| Monotonic | 2 | 时间戳基本与 SystemClock.uptimeMillis 大致相同。 输出映像的时间戳单调增加,大致与 SystemClock.uptimeMillis 相同。 具有此时间基的时间戳可直接用于视频录制中的音频视频同步。 如果相机设备的CameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE为 REALTIME,则具有此时间的时间戳不能直接匹配 CameraCaptureSession.CaptureCallback.onCaptureStarted、CameraCaptureSession.CaptureCallback.onReadoutStarted 中的时间戳或 CaptureResult 中的传感器时间戳。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| Realtime | 3 | 时间戳基大致与 SystemClock.elapsedRealtime() 相同。 输出映像的时间戳大致与 SystemClock.elapsedRealtime()相同。 此时间基时间戳不能直接用于视频录制中的音频视频同步。 如果相机设备的CameraCharacteristics.SENSOR_INFO_TIMESTAMP_SOURCE未知,则具有此时间的时间戳不能直接匹配 CameraCaptureSession.CaptureCallback.onCaptureStarted、CameraCaptureSession.CaptureCallback.onReadoutStarted 或 CaptureResult 中的传感器时间戳。 如果在仅支持TIMESTAMP_SOURCE_UNKNOWN的设备上使用 REALTIME 时间戳,则时间戳的准确性只是未知文档中保证的。 特别是,对于图像防抖动或增强现实等功能,它们无法保证在将图像数据与惯性传感器输出混为一谈时足够准确。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
| ChoreographerSynced | 4 | 时间戳将同步到编舞器。 输出图像的时间戳使用显示子系统中的编舞器脉冲重写,以便更流畅地显示相机帧。 SurfaceView 的输出目标默认使用此时间基。 请注意,时间戳替代仅适用于固定相机帧速率。 此时间戳基不适用于 SurfaceTexture 目标。 SurfaceTexture 的 updateTexImage 函数始终使用相机流中的最新图像。 对于 TextureView,图像会立即显示。 具有此时间基的时间戳不能直接匹配 CameraCaptureSession.CaptureCallback.onCaptureStarted、CameraCaptureSession.CaptureCallback.onReadoutStarted 中的时间戳或 CaptureResult 中的传感器时间戳。 如果需要将时间戳用于音频视频同步,则不应使用此时间戳基。
Android 参考。 本页的某些部分是根据 创建和共享的工作进行的修改,并根据 许可证中所述的条款使用。 |
注解
将这些值与 TimestampBase. 传感器时间戳使用相机播发的时间戳源。 单调时间戳使用接近系统运行时间的时间基数;实时时间戳使用接近已用实时的时间基数。 编舞同步时间戳遵循固定相机帧速率的显示脉冲。
不要假定可以直接比较来自不同基的时间戳。 具体而言,显示同步的时间戳与捕获回调或捕获结果传感器时间戳不匹配。 默认基数取决于输出目标。