PJSIP日志报‘codec parsed 0 frames’的原因及发送端注意事项

可能的原因 #

• 不完整的编码载荷：部分 codec（比如G.729、Opus）需要攒够完整的帧数据才能解析，要是发送端只传了半帧数据，解析器会先缓存起来，返回成功但count设为0，等后续数据补全再解析。
• 无效填充数据：发送端在payload里加了不符合 codec 规范的填充字节，这些数据没法被识别成有效帧，但解析器没检测到格式错误，所以返回成功却没解析出帧。
• codec 参数不匹配：发送端和接收端的 codec 配置不一样（比如采样率、帧大小没对齐），接收端解析器认不出有效帧结构，就会出现返回成功但无帧的情况。
• 空/全零payload：发送端发了长度合法但内容是空或者全零的payload，有些 codec 解析器会判定这是合法输入，但没有有效内容，所以count为0且返回成功。

发送端需要注意的点 #

• 严格按 codec 规范发完整帧：根据你用的 codec（比如G.711、Opus），确保每次发的payload是完整的一帧或多帧数据，别把单帧拆成多次发送。比如Opus默认20ms帧长，就得保证每次传的payload对应完整的20ms编码结果。
• 别乱加填充数据：除非是 codec 本身允许的填充机制（比如RTP的padding扩展），否则别在payload里加规范外的填充字节，而且要确保接收端能正确处理这些填充。
• 保持两端 codec 参数一致：发送前确认和接收端的采样率、通道数、帧大小、编码模式等参数完全匹配，别因为参数不对导致解析失败。
• 校验payload有效性：发送前检查payload内容，别发空数据或者无效编码数据，比如可以加个简单的校验，看看payload是不是全零、长度符不符合当前 codec 的帧长要求。
• 处理RTP包边界：如果用RTP传输，确保每个RTP包带的payload是完整的 codec 帧，别把单帧拆到多个RTP包里（除非 codec 支持分片，而且两端都配置了分片处理逻辑）。

内容的提问来源于stack exchange，提问作者René Heuven