同步频率与网络延迟

什么是同步频率

同步频率决定 Lyricify 多久向 Spotify 服务器请求一次「当前播放进度」。频率越高（间隔越小），歌词跟随歌声越精准，但 API 调用次数也越多——直接影响 429 限流出现的概率。

这个设置在主菜单 → 账户 → 「同步频率」里调整。

推荐值

默认值是 2（毫秒？不，是秒级的步进）——开发者原话：跳得越小同步速度越快，但也越容易爆掉。推荐值为 2，必须是整数。

调低的好处与代价

好处：歌词和歌声对齐更精准，尤其是播放到快速段落或歌词切换密集的地方，低同步频率能让歌词切换更跟手。

代价：

• Spotify API 调用频率增加，429 限流出现概率提高（尤其是没有配置自定义 API Client 时）
• 网络条件差时，高频请求反而可能加剧延迟（请求还没回来，下一次请求又发出去了）
• 开发者明确说过："跳得越小同步越快，但也越容易爆掉"

什么时候该调低 vs 调高

调低到 1：配置了自定义 API Client + Premium 订阅 + 网络条件好 + 对精准度特别敏感。这样请求走的是独立配额，不会触发公共 API 的限流。

调高到 4 或更高：

• 没有配置自定义 API Client，429 经常出现
• 网络条件一般，不想高频请求加重负担
• 不是特别在意几百毫秒的偏差

有了 Media Session 之后还需要关心这个吗

如果你开了 Media Session 增强并且连接正常，Lyricify 会优先使用本地 Media Session 接口来获取播放进度——这条通道不走 Spotify Web API，不消耗配额，所以同步频率设置对它没有影响。

但 Media Session 只能控制本设备的 Spotify 客户端；如果你想让电脑上的 Lyricify 跟随手机上 Spotify 放的歌，还是要走 Spotify Web API 的云端通道，这时候同步频率就很重要。

和 429 限流的关系

同步频率是 429 限流的主要触发因素之一。没配自定义 API Client 的话，保持在默认值 2 就好，不要轻易往下调。频繁出现 429 时第一检查这个设置。