Vane Data / API 参考
audio_metadata
audio_metadata 在限定的字节数内读取 AUDIOFILE 元数据,不解码音频样本。
签名
vane.audio_metadata(value, *, max_bytes=8388608) -> ExpressionSQL:audio_metadata(file [, max_bytes])。Expression 方法:expr.audio_metadata(...)。
参数
| 名称 | 类型 | 说明 | 默认值 |
|---|---|---|---|
| value | AUDIOFILE 值或 Expression | 待查看的编码音频对象 | 必填 |
| max_bytes | 整数或 Expression | 元数据探测的字节数上限 | 8 MiB(上限 64 MiB) |
返回值与错误
返回元数据 STRUCT,含 format、subtype、采样率、通道数、帧数和时长。NULL 返回 NULL;不可读或不支持的音频报错。
示例
import vane con = vane.connect() con.sql("SELECT audio_metadata(audio_file('sample.wav'))").show()