用途与实际影响
这项功能怎样使用
为什么需要它
家里上行带宽要同时装下视频、声音和传输开销。先留余量,再依据手机客户端统计调整,不能从一份旧带宽估计保证今天的帧率。
举个实际例子
“我先在手机端设 18–20 Mbps、60 FPS(每秒帧数)和 AV1,连接后观察丢包、网络延迟、解码耗时与实际帧率;不稳就退到 12–15 Mbps,稳定后再逐步上调。”
最后我会得到什么
已形成可解释的初始参数和回退方法,并确认主机具备 AV1 Main10 能力;当前没有真实会话数据证明零丢包、稳定 60 FPS 或 AV1 画质一定更好。
正常时
手机真实连上后,编码、画质、丢包和延迟符合本人的使用目标,才算这一档设置可用。
发现问题时
画面卡顿或排队延迟变大时,先降低码率并重新看统计,不因为推荐过某个数值就坚持它。
入口不可用或证据不足时
手机无法解码首选格式时换一种双方支持的编码,再做同一次真实试播。
从哪里开始
在 Moonlight/Artemis 的串流设置中从约 18–20 Mbps、60 FPS 和可用时 AV1 开始试播,再按真实解码与网络表现调整。
需要准备什么
- 希望优先保证清晰、流畅还是低延迟
- 试播时看到的卡顿、画质或 HDR 问题
从开始到拿到结果
- 1
选起点
按约 32 Mbps 上行预算选择保守码率,不把计算预算当测量。
- 2
让客户端协商
Sunshine 暴露多种编码,手机客户端决定实际格式;HDR 还取决于完整链路。
- 3
看画面再调
实际检查延迟、卡顿、画质与音频;本轮没有真实串流,不给出已达成的帧率或码率结论。
技术实现与依据
这里保留实现、关键条件、精确入口、历史记录和验证结果。
NVENC(NVIDIA 硬件编码器)配置与 AV1 Main10(10 位色深配置)能力已回读;18–20 Mbps 是客户端建议,弱网会话未测关键规则与设计选择
把 README 记录的约 32 Mbps 上行当作配置依据,而不是永不变化的带宽保证;18–20 Mbps 是带余量的起点。
受限链路优先使用 CBR(恒定码率)而不是 CQP(恒定量化参数),目的是减少复杂画面的码率峰值;客户端并未被本仓库强制锁定。
RTX 5090 D 负责主机端 AV1 硬件编码,骁龙 8 Elite 负责手机端 AV1 硬件解码。两端具备能力,因此建议先试 AV1;它不证明真实会话已协商成功,与 HEVC 的画质和解码延迟差异仍须同条件实测。
局域网可以尝试更高分辨率、刷新率和码率,但仍以客户端解码能力、显示刷新率与实时统计为准。
本模块用到的名词
- FEC(Forward Error Correction,前向纠错)
- 发送方主动在数据包中附加的冗余纠错码;当网络偶发微小丢包时,接收方无需重传即可直接恢复画面。
- NVENC 两遍编码(Twopass)
- 显卡编码器先快速分析整帧复杂度再精准分配码率的技术,能大幅提升受限带宽下的有效画质。
专业定义
它把“码率越高越清楚”换成一笔能复核的账:先给视频、FEC 和音频都留位置,再用手机统计决定继续加还是往下调。
解决什么
防止因码率设置不当导致家庭宽带上行被撑爆、画面严重卡死或编码资源浪费。
当前怎样实现
- Sunshine 主机端配置 sunshine.conf:启用 nvenc_preset = 5(高画质预设)、nvenc_twopass = full_res(全分辨率两遍编码)与 nvenc_spatial_aq = enabled(空间自适应量化)。
- 手机端 Moonlight / Artemis 建议起点:1080p/1440p、60 FPS、18–20 Mbps、CBR,并优先试 AV1;不是自动下发或强制配置。
- 通过 verify-path-lite.ps1 验证主机端当前编码器能力掩码,确保 hevc-main10=true 与 av1-main10=true 均正常支持。
执行流程
- 1
手机客户端向 Sunshine 发送包含目标码率(如 20 Mbps)、编码格式(AV1)与帧率的协商请求。
- 2
Sunshine 调用 NVIDIA NVENC API,以 P5 预设和全分辨率双遍算法开始压制视频流。
- 3
传输协议可能加入 FEC 与音频开销;24.5 Mbps 只是按文档比例计算的预算,不是本轮流量测量。
- 4
如果会话协商到 AV1,手机硬件解码器会参与渲染;HDR 还需要客户端、系统、显示与编码链共同满足。
边界
- 不在主机端强制锁死单一编码器;Sunshine 暴露 H.264、HEVC 与 AV1 能力,具体格式由手机客户端按解码能力协商。
- 不把本地主屏 4K 240Hz 直接当作远程目标;手机客户端从 60 FPS 起测,再按网络与解码能力调整。
失败与恢复
- 手机画面发灰发白
- 先核对客户端 HDR 与编码协商;保持物理主屏现状,只有在已授权的 VDD 独立路径中才调整其 HDR。
- 手机没有可用 AV1 硬件解码,或本次 AV1 协商失败
- 可在客户端尝试 HEVC Main10,重新连接后查看实际编码、解码和延迟统计;更换设置本身不等于串流已经恢复。
- 外网弱网环境下延迟波动加剧
- 临时在手机端将码率下调至 12–15 Mbps,降低丢包几率。
真实入口
README.md带宽计算公式、码率推荐表与编解码器选型深度论证
verify-path-lite.ps1主机硬件编码能力掩码只读验证
如何验证
- 2026-09-13T06:30:05Z自然巡检记录编码能力掩码0x1F0301,hevc-main10=true且av1-main10=true;未建立手机会话。
- Sunshine 配置文件固化高质量 NVENC P5/双遍参数。
与其他模块的关系
决定了远程可交互体验的实际质感;与下层网络通道及上层显示配置紧密相连。
