VideoStreamMetadata

class torchcodec.decoders.VideoStreamMetadata(duration_seconds_from_header: Optional[float], begin_stream_seconds_from_header: Optional[float], bit_rate: Optional[float], codec: Optional[str], stream_index: int, begin_stream_seconds_from_content: Optional[float], end_stream_seconds_from_content: Optional[float], width: Optional[int], height: Optional[int], num_frames_from_header: Optional[int], num_frames_from_content: Optional[int], average_fps_from_header: Optional[float])

单个视频流的元数据。

使用 VideoStreamMetadata 的示例

使用 VideoDecoder 解码视频

使用 VideoDecoder 解码视频

property average_fps: Optional[float]

视频流的平均帧率。如果执行了扫描，则根据帧数和视频流时长计算此值。否则，将回退到 average_fps_from_header。

average_fps_from_header: Optional[float]

从头部信息获取的视频流平均帧率（浮点数或 None）。建议使用 average_fps 属性。

property begin_stream_seconds: float

视频流的开始时间，以秒为单位（浮点数）。概念上，这对应于第一帧的 pts。如果 begin_stream_seconds_from_content 不是 None，则返回该值。否则，此值为 0。

begin_stream_seconds_from_content: Optional[float]

视频流的开始时间，以秒为单位（浮点数或 None）。概念上，这对应于第一帧的 pts。此值仅在进行扫描时计算，为视频流中所有帧的 min(frame.pts)。通常此值等于 0。

begin_stream_seconds_from_header: Optional[float]

从头部信息获取的视频流开始时间，以秒为单位（浮点数或 None）。通常此值等于 0。

bit_rate: Optional[float]

视频流的比特率（浮点数或 None）。

codec: Optional[str]

编解码器（字符串或 None）。

property duration_seconds: Optional[float]

视频流时长，以秒为单位。如果执行了扫描，我们尝试从实际帧计算时长。否则，将回退到 duration_seconds_from_header。

duration_seconds_from_header: Optional[float]

从头部信息获取的视频流时长，以秒为单位（浮点数或 None）。此值可能不准确。

property end_stream_seconds: Optional[float]

视频流的结束时间，以秒为单位（浮点数或 None）。概念上，这对应于 last_frame.pts + last_frame.duration。如果 end_stream_seconds_from_content 不是 None，则返回该值。否则，返回 duration_seconds。

end_stream_seconds_from_content: Optional[float]

视频流的结束时间，以秒为单位（浮点数或 None）。概念上，这对应于 last_frame.pts + last_frame.duration。此值仅在进行扫描时计算，为视频流中所有帧的 max(frame.pts + frame.duration)。请注意，在此时间点没有帧播放，因此调用 get_frame_played_at() 并传入此值会导致错误。获取最后一帧的最佳方法是直接通过索引 [-1] 访问 VideoDecoder 对象。

height: Optional[int]

帧高度（整数或 None）。

property num_frames: Optional[int]

视频流中的帧数。如果进行了扫描，则此值对应于 num_frames_from_content，否则对应于 num_frames_from_header。

num_frames_from_content: Optional[int]

TorchCodec 通过扫描视频流内容计算出的帧数（扫描不涉及解码）。此值比 num_frames_from_header 更准确。建议使用 num_frames 属性。（整数或 None）。

num_frames_from_header: Optional[int]

从视频流元数据获取的帧数。此值可能不准确。建议使用 num_frames 属性。（整数或 None）。

stream_index: int

此元数据所属视频流的索引（整数）。

width: Optional[int]

帧宽度（整数或 None）。