Go flac FLAC帧编号与样本编号有什么区别

使用 Go 的 github.com/mewkiz/flac 时，frame.Header.Num 并不始终表示样本位置。先读取 HasFixedBlockSize：固定块模式下 Num 是帧序号，可变块模式下 Num 才是这一帧首个样本的编号。下面按接口语义、最小换算函数和尾帧边界分别说明。

项目文档地址：https://pkg.go.dev/github.com/mewkiz/flac。文中涉及的 SampleNumber 实现固定引用 v1.0.14；不把该实现细节扩展为所有版本的行为。

最小规则：先看分块策略，再解释Num

FLAC 帧头携带分块策略。固定块流的普通帧使用同一个名义块长，帧头可以保存从零开始的帧编号；可变块流每帧的长度可能不同，帧头直接保存首样本编号。这里的“帧”是 FLAC 编码帧，不是一个单独的 PCM 样本，也不是界面刷新帧。

例如 Num 为 3，不能直接推断音频只前进了三个样本。若名义块长是1024，固定块模式下对应位置是3072；可变块模式下 Num=3 才表示位置3。

用明确的名义块长换算首样本位置

把转换写成一个小函数，可以避免日志、进度计算和索引模块各自猜测 Num。下面函数只完成字段换算，不负责验证整个音频文件。调用方必须先从流信息和分块约束确认名义块长；不能把每个当前帧的 BlockSize 无条件传进来。

package position

import (
    "fmt"

    "github.com/mewkiz/flac/frame"
)

// FirstSample把帧头编号转换为每声道时间轴上的首样本位置。
// nominalBlockSize必须是调用方确认的固定块名义长度。
func FirstSample(h frame.Header, nominalBlockSize uint64) (uint64, error) {
    if !h.HasFixedBlockSize {
        // 可变块帧头已直接保存首样本编号。
        return h.Num, nil
    }
    if nominalBlockSize == 0 {
        return 0, fmt.Errorf("固定块名义长度不能为零")
    }
    if h.Num > ^uint64(0)/nominalBlockSize {
        // 避免乘法溢出后产生看似合法的小位置。
        return 0, fmt.Errorf("首样本位置溢出")
    }
    return h.Num * nominalBlockSize, nil
}

这是原创辅助函数示例，未作为实测运行结果展示。它使用 uint64 保持和 Num 一致的范围，并在乘法前检查上界；返回错误时，调用方应停止这次位置计算，而不是把零当成音频开头继续处理。

最小变体如下：固定块头 Num=3、名义块长1024，返回3072；可变块头 Num=3072，即使当前帧长768，也直接返回3072。可变块分支不会使用 nominalBlockSize，传零不影响该分支。

样本编号不按声道翻倍

FLAC 的块长按每个声道拥有的样本数计量。双声道的一帧若 BlockSize=1024，左、右声道各有1024个样本，但时间轴只推进1024个采样位置。不能因为要处理两个声道，就把首样本编号再乘二。

若首样本位置为3072，采样率为48000 Hz，则对应时间是3072÷48000=0.064秒。这是算术示例。声道数会影响解码后交错缓冲区的元素数量和字节数，不改变上述时间计算公式。采样率字段为零时应按格式规则使用流信息中的采样率，不能直接做除法。

同样，样本编号不是压缩文件字节偏移。FLAC 帧的压缩字节长度会变化，不能用样本编号乘一个固定字节数来定位压缩输入；若自行建立索引，需要同时记录帧起始字节位置和首样本位置。

SampleNumber与短尾帧要注意什么

v1.0.14 的 Frame.SampleNumber 方法在固定块分支中使用 frame.Num * uint64(frame.BlockSize)，可变块分支直接返回 Num。普通固定块帧的当前长度等于名义长度时，这个乘法与前面的换算一致。

边界出现在短尾帧：FLAC 允许最后一帧短于固定块名义长度。假设前三帧各1024个样本，第四帧的帧号是3、实际长度是200，它的起点仍是3072。若把这个尾帧的当前长度200拿来乘帧号，就会得到600，无法代表前三帧累计的位置。

因此，依赖该版本方法处理边界帧前，应了解这段实现的适用条件。需要统一的绝对位置时，可用已确认的名义块长换算固定块编号，或在完整顺序遍历中从零累计每帧实际 BlockSize。后一种累计方式不能在随机跳入某一帧后自动恢复其绝对位置。

这里指出的是具体版本的代码边界，不代表 SampleNumber 在普通帧上都不可用，也不推断其他版本是否已经调整。升级时应以目标版本源码为准。

定位与日志中保留哪些字段

建议一条帧日志同时保存分块策略、原始 Num、当前 BlockSize、已确认的名义块长以及换算后的首样本位置。展示时间时再补采样率。这样出现位置异常时，可以区分“编号解释错误”和“采样率使用错误”。

• 读取 Num 前先判断 HasFixedBlockSize，不凭数值大小猜单位。
• 固定块名义长度与尾帧实际长度分开保存。
• 多声道计算时，位置保持每声道时间轴单位。
• 换算失败明确返回错误，不用零位置掩盖异常。
• 文件偏移和样本位置使用不同字段，避免把索引中的两种坐标混用。

能用帧号比较不同文件的播放位置吗？不能单独比较。不同流的分块长度和采样率可能不同，应先换成样本位置，再结合采样率解释时间。

可变块能通过前一帧号加一得到下一帧Num吗？不能。它保存样本编号；连续且有效的流中，下一帧的首样本位置应按本帧起点加本帧块长理解，而不是加一。

参考资料：mewkiz/flac文档；v1.0.14帧头与SampleNumber源码；RFC 9639 FLAC格式规范。