opuslib解码Opus头包时出现「corrupt stream」错误求助

核心问题：你提取的是Opus格式头，不是音频编码帧 #

你拿到的首个数据包是OpusHead（Opus格式头），它是OGG封装里的元数据载体，用于声明音频的格式参数（采样率、声道数等），而非实际的音频编码数据。从十六进制开头的4F 70 75 73 48 65 61 64（对应ASCII "OpusHead"）可以明确这一点，libopus解码器无法解码这类元数据，自然会抛出corrupted stream错误。

OGG封装的Opus流结构通常是：

• 第1个数据包：OpusHead（格式头）
• 第2个数据包：OpusTags（可选元数据，如标题、艺术家）
• 第3个及之后的数据包：Opus音频编码帧（这才是libopus需要解码的内容）

修正方案 #

1. 提取正确的数据包：跳过前两个元数据包，提取第三个及之后的OGG数据包作为解码对象。
2. 修正解码参数：decoder.decode()的第二个参数是每帧的总采样数，而非单声道采样数。对于48kHz、20ms、双声道的配置，总采样数为48000 * 0.02 = 960。

修正后的代码示例：

from opuslib import Decoder

SAMPLE_RATE = 48000
FRAME_DURATION = 20
# 计算每帧总采样数：48000Hz * 0.02秒 = 960
SAMPLES_PER_FRAME = int(SAMPLE_RATE * FRAME_DURATION / 1000)
CHANNELS = 2

# 替换为从OGG文件中提取的第三个（及之后）音频帧数据包的十六进制
audio_packet = bytes.fromhex("此处替换为实际音频帧的十六进制数据")

decoder = Decoder(SAMPLE_RATE, CHANNELS)
# 传入总采样数960，而非单声道采样数
result = decoder.decode(audio_packet, SAMPLES_PER_FRAME)

print(result)

额外验证建议 #

• 用opusdec工具导出原始PCM，对比解码结果验证正确性：

  opusdec audio.ogg - | hexdump -C
  

• 提取数据包时严格遵循OGG页结构解析，避免误取页头或元数据段。

内容的提问来源于stack exchange，提问作者Gaberocksall