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

功能解析：什么是ResolutionAutomation

ResolutionAutomation是一款专为Moonlight流媒体用户设计的开源工具⚙️，能够智能调整主机分辨率以匹配客户端设备的显示参数。当您通过Moonlight进行游戏或桌面流媒体时，该工具会自动检测客户端设备的分辨率和刷新率，并动态调整主机设置，确保画面显示效果最佳。

核心价值在于解决不同设备间分辨率不匹配的问题，特别适用于：

• 移动设备与桌面显示器分辨率差异大的场景
• 需要超采样（Supersampling）提升画质的用户
• 多设备流媒体爱好者

场景适配：哪些用户需要这个工具

典型应用场景

使用场景	传统方案痛点	ResolutionAutomation优势
手机流媒体到PC	画面拉伸变形，细节模糊	自动匹配手机分辨率，保持画面比例
平板游戏串流	操作延迟增加，画质损失	动态调整刷新率，优化触控体验
4K电视显示	主机性能不足导致卡顿	智能超采样，平衡画质与性能
多设备切换	手动调整分辨率繁琐	设备识别，自动切换预设配置

[!TIP] 如果您经常在不同设备间切换流媒体，或主机与客户端显示器宽高比不同，这款工具将显著提升您的使用体验。

操作指南：从零开始使用ResolutionAutomation

系统准备要求

• 操作系统：Windows 10/11
• Sunshine版本：0.21.0或更高
• 权限要求：管理员权限（用于修改系统分辨率设置）

Windows 11特殊配置

Windows 11用户需要先调整终端设置：

1. 打开系统设置 > 开发者选项 > 终端
2. 将"默认终端应用程序"从"让Windows决定"改为"Windows控制台主机"
3. 重启终端使设置生效

安装流程

1. 获取项目文件

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

2. 固定存放位置

   [!IMPORTANT] 请将项目文件夹放在长期不变的位置，移动文件夹会导致自动化功能失效。推荐路径：C:\Program Files\ResolutionAutomation

3. 运行安装脚本

   • 双击执行Install.bat
   • 当系统请求管理员权限时点击"是"
   • 等待安装完成（通常需要10-30秒）

卸载方法

• 直接双击运行项目文件夹中的Uninstall.bat
• 等待脚本完成清理过程
• 卸载后可安全删除项目文件夹

进阶配置：打造个性化流媒体体验

基础参数配置

配置文件位于项目根目录的settings.json，可用记事本或任何代码编辑器打开：

{
  "debugMode": false,          // 启用后会生成详细日志
  "gracePeriod": 120,          // 流媒体结束后等待时间（秒）
  "startupDelay": 5,           // 脚本启动延迟时间（秒）
  "preferredResolution": {
    "width": 1920,
    "height": 1080,
    "refresh": 60,
    "enabled": false           // 是否启用首选分辨率
  }
}

分辨率覆盖规则

通过overrides.txt文件设置分辨率转换规则，格式为客户端分辨率=主机目标分辨率：

# 移动设备低分辨率转高分辨率超采样
1280x720x60=3840x2160x60

# 平板设备适配
2560x1600x60=1920x1200x60

# 低性能设备降分辨率
3840x2160x60=1920x1080x60

[!TIP] 超采样（如720p→4K）能提升画质但会增加主机负载，建议根据硬件性能调整。

实用配置技巧

1. 10位深度支持
   对于支持HDR的设备，可尝试通过减半刷新率启用10位深度：

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

2. 应用程序特定配置
   为不同应用创建独立配置文件，如settings_game.json，在启动特定游戏时使用：

   ResolutionAutomation.exe --config settings_game.json
   

3. 快捷切换配置
   创建批处理文件快速切换不同配置方案，例如4K_Streaming.bat：

   @echo off
   copy /y overrides_4k.txt overrides.txt
   echo 已切换至4K超采样模式
   

问题解决：常见故障排查指南

症状：脚本未自动启动

• 可能原因：Sunshine配置未正确关联脚本
• 解决方案：
  1. 打开Sunshine Web界面
  2. 进入"应用"设置
  3. 确保启动命令包含StreamMonitor.ps1路径

症状：分辨率未正确切换

• 可能原因：客户端分辨率未添加到主机显示设置
• 解决方案：
  1. 使用NVIDIA控制面板添加自定义分辨率
  2. 或使用CRU(自定义分辨率实用程序)添加所需分辨率
  3. 重启电脑后测试

症状：冷启动后功能失效

• 可能原因：Windows API限制导致服务未启动
• 解决方案：
  1. 先用Moonlight连接"桌面"应用
  2. 断开连接
  3. 重新连接目标应用

症状：权限错误

• 可能原因：安装未以管理员权限执行
• 解决方案：
  1. 右键点击Install.bat
  2. 选择"以管理员身份运行"
  3. 重新完成安装流程

使用技巧：提升流媒体体验的实用方法

技巧1：性能与画质平衡

根据网络状况动态调整分辨率覆盖规则：

• 网络带宽充足(>50Mbps)：启用超采样提升画质
• 网络不稳定：降低主机分辨率减少延迟

技巧2：创建场景配置文件

为不同使用场景创建专用配置文件：

• 游戏配置：高刷新率优先
• 电影配置：高分辨率优先
• 远程办公：平衡清晰度与响应速度

技巧3：日志分析优化

启用调试模式后，通过分析log.txt优化配置：

• 查找"resolution mismatch"记录识别问题分辨率
• 观察"switch time"数据评估切换性能
• 根据"client detection"日志优化设备识别

[!TIP] 定期查看output.txt文件，里面记录了每次分辨率切换的详细信息，有助于发现和解决问题。

通过以上指南，您应该能够充分利用ResolutionAutomation工具，为Moonlight流媒体打造最佳的显示效果。无论是游戏、办公还是媒体消费，自动分辨率匹配都能让您的流媒体体验更加流畅和专业。