基于C# NAudio的卡拉OK应用歌词与音频不同步问题排查

用C#和NAudio做卡拉OK应用，歌词和音频正常播放时同步没问题，但用户跳转播放位置后，歌词就和音频不同步了，越靠近音乐结尾，延迟差得越明显。

同步逻辑代码：

while(!_stopSync)
{
    int currentMs = musicPlayer.GetCurrentTimeMS(); // 从WaveOut获取当前播放毫秒数
    bool jumped = musicPlayer.GetIsJumped();
    int finalOffset = lastoffset;
    
    if (previousMs != currentMs || jumped)
    {
        for (int i = 0; i < sortedOffsets.Count; i++)
        {
            var value = sortedOffsets[i];
            if (value > currentMs)
            {
                break;
            }
            finalOffset = value; // 赋值当前偏移量
            finalIndex = i; // 赋值当前歌词索引
        }
    }
    
    Dispatcher.BeginInvoke(System.Windows.Threading.DispatcherPriority.Normal, (Action)(() =>
    {
        UpdateUI(finalIndex, currentMs);
    }));
    
    lastoffset = finalOffset;
    previousMs = currentMs; 
}

其中sortedOffsets是Dictionary<int, int>类型，键是歌词的毫秒偏移量，值对应歌词UI元素的索引。

音乐播放器类的相关实现：

private WaveOutEvent waveOut;
private AudioFileReader audioFileReader;

public void JumpToSecond(double second)
{
    if (waveOut != null && audioFileReader != null)
    {
        audioFileReader.CurrentTime = TimeSpan.FromSeconds(second);
        Jumped = true;
    }        
}

public void JumpToMs(int offset)
{
    JumpToSecond(offset / 1000);
}

public int GetCurrentTimeMS()
{
    if (waveOut.PlaybackState == PlaybackState.Stopped)
        return 0;
    return (int)(audioFileReader.CurrentTime.TotalMilliseconds);
}

public bool GetIsJumped()
{
    bool isJumped = Jumped;
    Jumped = false;
    return isJumped;
}

// 其他初始化、播放、暂停、音量控制代码

• 跳转后索引未彻底重置：如果从后半段跳回前半段，原逻辑的循环从i=0开始，但如果当前音频位置的毫秒数小于之前的finalOffset，循环不会把finalIndex更新到更小的数值，歌词会停留在跳转前的位置，只能缓慢追赶，越到结尾差距越显眼。
• Dictionary遍历顺序不可靠：sortedOffsets是Dictionary类型，直接用索引i访问元素无法保证顺序——哪怕你以为它是按键排序的，实际遍历顺序可能混乱，匹配的歌词索引自然出错，跳转后这种错误会被放大。
• 跳转时间精度丢失：JumpToMs里用offset / 1000是整数除法，比如1500ms会被转成1秒而非1.5秒，跳转位置本身就不准确，后续同步必然出现偏差，播放到结尾时误差累积更明显。
• 播放时间获取不准：仅用audioFileReader.CurrentTime获取播放位置，跳转后这个值和实际播放进度可能存在延迟，NAudio中WaveOutEvent的实际播放进度与文件阅读器的CurrentTime并非完全实时同步。

1. 替换Dictionary为排序后的列表 #

Dictionary不适合按顺序遍历，换成排序后的列表确保时间顺序正确：

// 把原Dictionary改成按偏移量升序排列的列表
private List<(int OffsetMs, int LyricIndex)> sortedLyricOffsets;

// 初始化时排序（假设原数据来自原sortedOffsets）
sortedLyricOffsets = sortedOffsets.OrderBy(kv => kv.Key)
                                 .Select(kv => (kv.Key, kv.Value))
                                 .ToList();

然后用二分查找替代顺序遍历，效率更高也更准确：

if (previousMs != currentMs || jumped)
{
    int left = 0, right = sortedLyricOffsets.Count - 1;
    int matchedIndex = finalIndex;
    while (left <= right)
    {
        int mid = (left + right) / 2;
        if (sortedLyricOffsets[mid].OffsetMs <= currentMs)
        {
            matchedIndex = mid;
            left = mid + 1;
        }
        else
        {
            right = mid - 1;
        }
    }
    finalIndex = matchedIndex;
    finalOffset = sortedLyricOffsets[finalIndex].OffsetMs;
}

2. 修复跳转的时间精度问题 #

把JumpToMs里的整数除法改成浮点除法：

public void JumpToMs(int offset)
{
    JumpToSecond(offset / 1000.0); // 用1000.0保证是浮点运算，保留毫秒精度
}

3. 优化跳转后的同步逻辑 #

跳转时强制重新计算歌词索引，不要依赖之前的状态：

// 同步逻辑里，只要jumped为true，就彻底重新查找当前时间对应的歌词
if (previousMs != currentMs || jumped)
{
    // 直接用上面的二分查找逻辑重新计算finalIndex和finalOffset
}
// 跳转后立刻把previousMs设为当前时间，避免后续逻辑误判
if (jumped)
{
    previousMs = currentMs;
}

4. 更准确地获取播放时间 #

改用WaveOutEvent.GetPosition()获取实际播放的字节数，再转换成时间，比直接用audioFileReader.CurrentTime更准确：

public int GetCurrentTimeMS()
{
    if (waveOut?.PlaybackState != PlaybackState.Playing)
        return 0;
    
    if (audioFileReader == null)
        return 0;
    
    long bytesPlayed = waveOut.GetPosition();
    TimeSpan currentTime = TimeSpan.FromSeconds((double)bytesPlayed / audioFileReader.WaveFormat.AverageBytesPerSecond);
    return (int)currentTime.TotalMilliseconds;
}

内容的提问来源于stack exchange，提问作者Hebele Hübele