ResolutionAutomation：跨设备分辨率智能匹配工具使用指南

直击流媒体痛点：三个真实用户故事

📱 移动设备用户
"躺在床上用平板串流PC游戏时，总感觉画面被拉伸变形，文字模糊不清。手动调整分辨率后，下次连接又得重新设置，太影响体验了。"

🎮 主机玩家
"客厅电视和书房显示器的分辨率完全不同，每次切换设备都要重新配置显卡参数。有次忘记恢复设置，导致办公文档显示异常。"

🎥 画质追求者
"明明主机性能足够支持4K超采样（Super Sampling），但Moonlight默认配置总是限制输出分辨率，无法发挥硬件全部潜力。"

ResolutionAutomation正是为解决这些问题而生——作为Moonlight流媒体的"智能转接器"，它能自动匹配客户端与主机的分辨率参数，让跨设备流媒体体验如行云流水般顺畅。

构建适配环境：兼容性矩阵与准备工作

环境兼容性矩阵

系统要求	最低配置	推荐配置
操作系统	Windows 10 64位	Windows 11 22H2以上
Sunshine版本	0.21.0	0.23.0以上
.NET运行时	.NET 5.0	.NET 7.0
显卡支持	支持自定义分辨率	NVIDIA/AMD最新驱动

环境准备步骤

1️⃣ 终端环境配置
⚠️ Windows 11用户注意：由于终端隐藏控制台bug，需提前修改默认终端设置：
「设置 > 系统 > 开发者选项 > 终端」中将默认终端改为"Windows 控制台主机"，修改后重启系统生效。

2️⃣ 获取项目文件

git clone https://gitcode.com/gh_mirrors/re/ResolutionAutomation

💡 优化建议：选择非系统盘的固定目录存放项目，避免后续移动导致配置失效。

3️⃣ 权限准备
确保当前用户拥有管理员权限，因为Sunshine配置文件需要 elevated 权限才能修改。

场景化部署：三步完成自动化配置

1️⃣ 标准安装流程

双击运行项目根目录中的 Install.bat，安装程序将自动完成：

• 系统权限请求（UAC弹窗）
• Sunshine配置集成
• 服务自启动注册

💡 安装成功的标志：出现"安装完成"提示窗口，且系统事件日志中记录"ResolutionAutomation服务已启动"。

2️⃣ 验证部署状态

打开Sunshine管理界面（默认http://localhost:47990），在「应用」选项卡中确认：

• 所有应用程序已添加"ResolutionAutomation"前缀
• 环境变量列表包含"MOONLIGHT_RESOLUTION"项

3️⃣ 基础使用流程

1. 通过Moonlight连接主机
2. 启动任意应用程序
3. 工具自动完成分辨率匹配
4. 结束流媒体后自动恢复原始设置

⚠️ 首次使用注意：冷启动（系统刚启动后第一次连接）可能需要手动触发一次分辨率切换，后续连接将完全自动化。

配置智能规则：从基础设置到场景化方案

基础配置（settings.json）

参数名	作用	典型值
debugMode	启用详细日志输出	false
gracePeriod	流媒体结束后恢复延迟(秒)	120
startupDelay	启动后等待时间(秒)	5
preferredResolution	默认恢复分辨率配置	见下方示例

基础配置示例：

{
  "debugMode": false,
  "gracePeriod": 120,
  "startupDelay": 5,
  "preferredResolution": {
    "width": 1920,
    "height": 1080,
    "refresh": 60,
    "enabled": true
  }
}

场景化配置方案

📱 移动设备优化方案

在overrides.txt中添加：

# 手机端低带宽优化
1080x2340x60=1280x720x30
# 平板端画质优先
1600x2560x60=2560x1600x60

🎮 游戏场景配置

创建game_overrides.txt并在settings.json中引用：

{
  "overrideFiles": ["default_overrides.txt", "game_overrides.txt"]
}

🎥 超采样配置

实现4K转1080P超采样：

1920x1080x60=3840x2160x60

💡 注意：超采样会显著增加GPU负载，确保显卡性能充足。

异常处理策略：四步诊断法

症状1：分辨率无变化

• 可能原因：Sunshine环境变量未正确传递
• 验证方法：检查log.txt中是否有"MOONLIGHT_RESOLUTION not found"记录
• 解决方案：重新运行Install.bat，确保Sunshine服务已重启

症状2：恢复分辨率失败

• 可能原因：宽限期设置过短
• 验证方法：查看log.txt中的"grace period expired"时间戳
• 解决方案：在settings.json中增加gracePeriod至180秒

症状3：冷启动失效

• 可能原因：Windows API权限限制
• 验证方法：重启后首次连接必现该问题
• 解决方案：先连接"桌面"应用，断开后再启动目标程序

症状4：刷新率不匹配

• 可能原因：显示器不支持客户端刷新率
• 验证方法：运行"dxdiag"查看显示设备支持的模式
• 解决方案：在overrides.txt中指定兼容刷新率：1920x1080x144=1920x1080x60

核心功能速览

ResolutionAutomation通过监听Sunshine会话事件，实现三大核心功能：实时分辨率匹配（自动同步客户端与主机显示参数）、智能恢复机制（流媒体结束后还原系统设置）、灵活规则引擎（支持场景化分辨率策略）。整个过程在后台静默运行，无需用户干预，真正实现"开箱即用"的无缝集成体验。

高级功能探索

10位深度支持

在settings.json中添加：

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

⚠️ 注意：该功能仅在HDR流媒体时生效，且会将刷新率减半以确保兼容性。

多显示器配置

通过displayOverride参数指定特定显示器：

"displayOverride": {
  "targetDisplay": 2,
  "fallbackToPrimary": true
}

---

通过本文指南，您已掌握ResolutionAutomation的核心配置与使用方法。这个开源工具虽小巧却强大，完美解决了跨设备流媒体的显示适配难题。无论是移动办公还是家庭娱乐场景，都能让您的Moonlight体验达到新高度。