Go oggvorbis 怎样取得Vorbis文件的采样率和声道数

用 Go 的 github.com/jfreymuth/oggvorbis 读取 Vorbis 音频参数，最直接的做法是调用 oggvorbis.GetFormat，再读取返回值的 SampleRate 和 Channels 字段。若后面还要解码音频，则创建 oggvorbis.Reader，通过 r.SampleRate() 和 r.Channels() 取得同样的元数据。

官方地址：https://pkg.go.dev/github.com/jfreymuth/oggvorbis

只读元数据时优先使用 GetFormat

GetFormat 会从输入中读取 Ogg 的首个 page 来取得音频格式，返回的 Format 包含采样率、声道数和码率。这个路径适合上传校验、媒体列表展示和入库前检查，不需要先创建完整解码器。

package main

import (
    "fmt"
    "os"

    "github.com/jfreymuth/oggvorbis"
)

func printFormat(path string) error {
    f, err := os.Open(path)
    if err != nil {
        return fmt.Errorf("打开音频文件: %w", err)
    }
    defer f.Close() // 文件句柄只在本次格式读取期间保持打开。

    format, err := oggvorbis.GetFormat(f)
    if err != nil {
        return fmt.Errorf("读取 Vorbis 格式: %w", err)
    }

    // SampleRate 是每秒采样数，Channels 是声道数量。
    fmt.Printf("采样率: %d Hz\n声道数: %d\n", format.SampleRate, format.Channels)
    return nil
}

这里要区分“容器可打开”和“格式能解析”：文件存在并不代表它一定是可读的 OGG/Vorbis。生产代码应保留构造错误，让调用方把损坏文件、非 Vorbis 流和权限问题分开处理。

需要继续解码时改用 NewReader

如果读完参数后还要处理音频样本，直接创建 Reader 更顺手。SampleRate() 和 Channels() 给出流的播放维度，Read 将解码出的浮点值写入调用方提供的切片。

func inspectAudio(path string) error {
    f, err := os.Open(path)
    if err != nil {
        return fmt.Errorf("打开文件: %w", err)
    }
    defer f.Close() // Reader 结束后关闭底层文件。

    r, err := oggvorbis.NewReader(f)
    if err != nil {
        return fmt.Errorf("创建 Vorbis reader: %w", err)
    }

    channels := r.Channels()
    sampleRate := r.SampleRate()
    buffer := make([]float32, 4096)
    for {
        n, err := r.Read(buffer)
        // buffer[:n] 是本次得到的交错声道采样值。
        _ = buffer[:n]
        if err == io.EOF {
            break
        }
        if err != nil {
            return fmt.Errorf("解码音频: %w", err)
        }
    }
    fmt.Printf("%d Hz, %d channels\n", sampleRate, channels)
    return nil
}

示例需要补充 io 导入。Read 返回的数量是“采样值 × 声道”的总数，因此通常是 Channels() 的倍数；不要把它直接当成单声道帧数。

GetLength、ReadSeeker 与 Read 的边界

需要文件总长度时可以调用 GetLength，但输入必须实现 io.ReadSeeker，例如本地打开的文件。返回值的单位是 samples；如果底层输入不可寻址，Reader.Length() 可能返回 0，这表示长度未知，不等于音频确实是零秒。

常见问题

采样率和声道数应该从哪里取？

只检查文件时从 GetFormat 返回的 Format 取；已经创建 Reader 时调用 SampleRate() 和 Channels()。

GetFormat 之后还能继续用同一个输入解码吗？

它会读取输入内容，因此不要假设当前位置仍在开头。需要继续解码时重新打开文件，或使用可寻址输入回到合适位置后再创建 Reader。

Read 返回的 n 为什么不是音频帧数？

返回值是写入切片的浮点采样值数量，包含所有声道；需要按声道数换算帧时，再结合 Channels() 处理。