如何通过ResolutionAutomation实现Moonlight流媒体分辨率自动匹配

ResolutionAutomation是一款专为Moonlight流媒体用户设计的开源工具，能够智能调节主机分辨率以匹配客户端设备，解决不同设备连接时画面拉伸、模糊或黑边问题，尤其适合手机、平板等移动设备与主机显示器宽高比差异大的场景，让远程游戏和办公体验更加流畅自然。

核心价值：为什么需要分辨率自动化

当你使用Moonlight将电脑画面串流到手机或平板时，是否遇到过画面变形、模糊或显示不全的问题？这通常是因为主机分辨率与客户端设备不匹配造成的。ResolutionAutomation通过实时监测客户端分辨率并自动调整主机设置，消除了手动切换分辨率的麻烦，让流媒体体验始终保持最佳状态。

核心优势

• 自动适配：无需手动调整，工具自动匹配客户端分辨率
• 场景优化：针对不同设备类型智能优化显示效果
• 超采样支持：可提升画质细节，适合高性能设备
• 自动恢复：流媒体结束后自动还原原始显示设置

快速上手：3步完成初始配置

准备工作

在开始前，请确保你的系统满足以下条件：

• 运行Windows操作系统
• 已安装Sunshine 0.21.0或更高版本
• Windows 11用户需将默认终端设置为"Windows控制台主机"

安装步骤

1. 获取项目文件
   克隆仓库到本地固定位置：
   git clone https://gitcode.com/gh_mirrors/re/ResolutionAutomation

   ⚠️ 重要：请选择一个长期不变的存储位置，移动文件夹会导致功能失效

2. 运行安装脚本
   双击执行文件夹中的Install.bat，系统会自动请求管理员权限（Sunshine配置需要管理员权限）

3. 验证安装
   安装完成后会生成log.txt文件，打开查看是否有错误信息，无错误则表示安装成功

首次使用指南

1. 通过Moonlight连接主机
2. 启动任意应用程序
3. 工具会自动在后台运行，无需额外操作
4. 结束流媒体后，主机分辨率将自动恢复

深度配置：定制你的分辨率规则

基础设置（settings.json）

配置项	说明	默认值
debugMode	是否启用调试日志	false
gracePeriod	流媒体结束后的等待时间（秒）	120
startDelay	脚本启动延迟时间（秒）	5

配置示例：

{
  "debugMode": false,
  "gracePeriod": 180,
  "startDelay": 3
}

场景化配置

1. 首选分辨率设置

当流媒体结束后，系统会恢复到此分辨率。适合固定使用一种显示模式的用户。

"preferredResolution": {
  "width": 2560,
  "height": 1440,
  "refresh": 144,
  "enabled": true
}

💡 小贴士：对于游戏玩家，建议将首选分辨率设置为显示器原生分辨率和最高刷新率

2. 分辨率覆盖规则

通过自定义规则，让主机在特定情况下使用指定分辨率。格式为：触发分辨率=目标分辨率

应用场景与示例：

应用场景	配置示例	说明
移动设备优化	"1080x2340x60=1920x1080x60"	手机竖屏时转为1080P横屏
带宽节省	"2560x1440x60=1920x1080x60"	网络不佳时降低分辨率
超采样增强	"1920x1080x60=3840x2160x30"	在1080P客户端上显示4K超采样画面

配置示例：

"overrides": [
  "1080x2340x60=1920x1080x60",
  "2560x1440x60=1920x1080x60",
  "1920x1080x60=3840x2160x30"
]

高级功能

10位深度支持

对于支持HDR的设备，可通过降低刷新率来启用10位色彩深度：

"hdrSettings": {
  "enable10Bit": true,
  "refreshRateDivisor": 2
}

⚠️ 注意：此功能仅在HDR流媒体时生效，且可能会影响游戏性能

常见问题与解决方案

安装与运行问题

Q: 安装后脚本没有自动启动？

A: 检查以下几点：

1. 确认Sunshine版本是否符合要求（0.21.0+）
2. 查看log.txt文件是否有错误信息
3. 尝试重新运行Install.bat

Q: 移动文件夹后功能失效怎么办？

A: 只需在新位置重新运行Install.bat即可恢复功能

分辨率问题

Q: 分辨率没有正确切换？

A: 确保客户端分辨率已添加到主机的自定义分辨率列表中，可通过NVIDIA控制面板或CRU工具添加

Q: 冷启动后工具不工作？

A: 这是Windows API限制导致的，解决方案：

1. 通过Moonlight连接"桌面"应用
2. 结束当前会话
3. 重新连接即可恢复正常

性能问题

Q: 切换分辨率时出现卡顿？

A: 尝试增加startDelay值（建议5-10秒），给系统足够的准备时间

Q: 超采样功能导致游戏帧率下降？

A: 降低目标分辨率或关闭超采样功能，平衡画质与性能

使用技巧与最佳实践

多设备适配策略

• 手机用户：设置竖屏分辨率覆盖规则，避免画面拉伸
• 平板用户：根据使用场景（横屏/竖屏）设置不同规则
• 低配置设备：降低目标分辨率以获得更流畅的体验

日志分析

当遇到问题时，log.txt文件是重要的排查工具。启用debugMode可获取更详细的日志信息，帮助定位问题。

定期更新

定期通过git pull更新项目文件，以获取最新功能和bug修复。更新后建议重新运行Install.bat确保配置正确应用。

通过以上指南，你已经掌握了ResolutionAutomation的核心功能和配置方法。这款工具将为你的Moonlight流媒体体验带来显著提升，让不同设备间的画面传输更加智能、流畅。如有其他问题，可查看项目中的Readme.md获取更多帮助信息。