Moonlight（moonlight-qt）是一款面向 Windows、Mac、Linux 与 Steam Link 的 GameStream 串流客户端。本文带你弄懂 Moonlight V+ 的两大核心优化：HQ 麦克风高质量语音推流与ABR 自适应码率，让你在联机开黑时语音清晰、画面稳定不卡顿，并给出一套开箱即用的画质调优清单。

HQ麦克风：为什么串流语音也能做到"高清"

🎙️ 传统串流软件里麦克风常常是"能用就行"，但 Moonlight 的 HQ 麦克风走的是专业路线：

核心逻辑位于 micstream.cpp：编码器在独立音频线程中初始化（见 micstream.cpp#L63-L68），PCM 数据按 20 ms 一帧 切分编码，发送队列满时丢弃最旧帧而不是积压——保证的是实时性优先，这正是语音场景的正确取舍。每 5 秒还会打印一次统计摘要（发送包数、丢帧数、回调耗时），方便排查问题。

如何启用 HQ 麦克风

1. 自动开启：勾选偏好中的enableMicrophone（定义于 streamingpreferences.h#L271），开始串流时客户端会通过 Session::startMicrophone 自动启动语音推流；
2. 串流中随时切换：在串流画面的覆盖菜单里点 Mic 按钮即可开/关，无需退出游戏（实现见 session.cpp#L5771-L5782）；
3. macOS 用户注意：首次使用会弹出麦克风权限请求，权限流程刻意保留在主线程执行（micstream.cpp#L339-L344），若被拒绝，请在系统设置中手动授权后重启 Moonlight。

ABR自适应码率：画质防卡顿的自动巡航

📶 ABR（Adaptive Bitrate，自适应码率）是 Moonlight 与 Sunshine 主机协同的一套码率自动调节机制，目标是：网络好时画质拉满，网络抖时先保流畅再谈清晰。

工作原理：每 3 秒一次的"体检"

客户端持续统计网络质量，并在固定间隔（ABR_FEEDBACK_INTERVAL_MS = 3000，见 session.cpp#L5100）向 Sunshine 上报四项关键指标：

• 丢包率：综合 FEC 失败包、乱序包、无效包统计（session.cpp#L3704-L3715）
• RTT 往返时延及其抖动
• 解码帧率
• 丢帧数

Sunshine 据此计算并返回新的newBitrate，客户端立即记录并生效（反馈任务见 session.cpp#L3688-L3731）。整个过程无需任何手动干预。

💡 建议用上面的 4K 高清壁纸（3840×2160）作为测试画面：在 ABR 降码率时，细密纹理与文字边缘最先出现压缩块状伪影，能直观判断当前画质余量。

在哪里开启 ABR 并设置上限

设置页的"基本设置"中（界面代码见 BasicSettingsPage.qml#L635-L648）：

1. 打开"Automatically adjust bitrate (ABR)"开关——需要兼容的 Sunshine 主机支持；
2. 此时码率滑杆的含义变为码率上限（Video bitrate limit），即 ABR 可选择的最高值，滑杆支持 500 kbps ~ 800 Mbps 的分段刻度（BasicSettingsPage.qml#L18-L58）；
3. 手动输入或拖动滑杆会固定码率并自动关闭 ABR；点击"Use recommended bitrate"可一键恢复按分辨率/帧率计算的建议值。

配套：FEC 前向纠错

同一设置页还提供服务码率百分比（FEC）选项：网络波动大的环境下，FEC 用额外带宽换取抗丢包能力，代价是更占带宽。ABR 与 FEC 可以独立使用，按"先 ABR 保底、再 FEC 补强"的思路组合最稳妥。

实测调优清单：音质画质一步到位

串流过程中还能通过覆盖菜单实时调整码率，无需重启游戏：客户端会把新值通过 HTTP 请求下发给主机（requestRuntimeBitrateChange，见 session.cpp#L3226）。另外 bandwidth.cpp 中的BandwidthCalculator会持续采集系统级网络吞吐，辅助判断瓶颈是否在带宽本身——如果你看到"Slow connection to PC, Reduce your bitrate"提示，优先降码率或换有线网络。

常见问题速查

• 麦克风没声音？macOS 先确认系统设置里的麦克风权限；主机侧确认 Sunshine 已开启"Enable Microphone Streaming"；日志中每 5 秒的[MicStream] 5s summary可快速判断是否有数据在发送。
• ABR 不生效？ABR 依赖 Sunshine 的接口反馈，NVIDIA GeForce Experience（GameStream）模式不支持，需配合 Sunshine 使用。
• 画面偶尔发糊？属于 ABR 正常降码行为，网络恢复后会自动回升；若长期偏低，检查是否有其他设备抢占带宽（可用系统任务管理器/活动监视器对照验证）。

相关文件索引

• 麦克风推流：micstream.h ｜ micstream.cpp
• ABR 反馈与运行时码率调整：session.cpp
• 系统带宽监测：bandwidth.cpp
• 码率/FEC 设置界面：BasicSettingsPage.qml
• 偏好项定义：streamingpreferences.h

HQ 麦克风让联机语音不再"麦糊"，ABR 让画质随网络自动巡航——两项都默认友好、可随时开关，建议有线环境把上限拉满体验最佳画质。