Vane Data / API 参考

video_metadata

video_metadata 在限定的探测字节数内读取视频流元数据。它选择第一个不带 attached_pic 标记的视频流，跳过封面图等附带图片。

签名

example.py

vane.video_metadata(value, *, max_bytes=8388608) -> Expression

SQL：video_metadata(file [, max_bytes])。Expression 方法：expr.video_metadata(...)。

名称	类型	说明	默认值
value	VIDEOFILE 值或 Expression	待查看的编码视频对象	必填
max_bytes	整数或 Expression	元数据探测的字节数上限	8 MiB（上限 64 MiB）

返回 STRUCT，含 width、height、fps、duration、container_duration、frame_count 和 time_base。duration 只描述所选视频流，container_duration 描述整个容器。未知时长和帧数仍为 NULL。

example.py

import vane


con = vane.connect()
con.sql("SELECT video_metadata(video_file('clip.mp4'))").show()