ResolutionAutomation：Moonlight流媒体的分辨率自动化适配工具

ResolutionAutomation 是一款专为 Moonlight 流媒体用户设计的开源工具，通过分辨率自动化技术实现跨设备显示优化，让不同屏幕尺寸的设备都能获得最佳流媒体体验。无论是手机、平板还是电视，都能自动匹配主机分辨率，告别手动调整的繁琐。

一、核心价值：无缝体验的分辨率自动化方案

1.1 什么是分辨率自动化？

分辨率自动化是指工具能够智能识别客户端设备（如手机、平板）的屏幕参数，自动调整主机（电脑）的显示分辨率，实现跨设备的无缝流媒体体验。这项技术特别解决了不同设备宽高比差异导致的画面拉伸或黑边问题。

1.2 核心优势

• 自动适配：无需手动调整，主机分辨率实时匹配客户端
• 超采样支持：通过高分辨率渲染后缩放，提升画质细节
• 跨设备兼容：手机、平板、电视等多种终端全覆盖
• 零延迟切换：流媒体开始/结束时自动切换分辨率，无感知过渡

二、快速上手：3步完成环境配置与一键部署

2.1 环境准备

系统要求：

• Windows 操作系统
• Sunshine 0.21.0 或更高版本（Moonlight配套的串流服务）

Windows 11 特别配置： ⚠️ 由于系统终端bug，需将默认终端设置为"Windows控制台主机"：

1. 打开"设置 > 系统 > 开发者选项"
2. 找到"终端"设置，从"让Windows决定"改为"Windows控制台主机"
3. 重启终端使设置生效

2.2 3步完成安装部署

1. 固定文件夹：将下载的项目文件夹保存到长期不变的位置（移动文件夹会导致功能失效）
2. 一键安装：双击运行 Install.bat，自动请求管理员权限并完成配置
3. 验证安装：检查安装目录下生成的 log.txt 文件，确认无错误信息即完成

2.3 一键卸载

无需复杂操作，双击运行 Uninstall.bat 即可完全移除所有配置，恢复系统初始状态。

三、深度解析：分辨率自动化工作流程图解

ResolutionAutomation 的工作流程分为5个核心步骤：

┌─────────────┐     ┌─────────────┐     ┌─────────────┐
│  启动流媒   │     │ 读取客户端   │     │ 调整主机     │
│  体应用     ├────>│ 分辨率信息   ├────>│ 分辨率       │
└─────────────┘     └─────────────┘     └──────┬──────┘
                                                │
┌─────────────┐     ┌─────────────┐     ┌──────▼──────┐
│ 恢复原始     │     │ 检测流媒     │     │ 维持匹配     │
│ 分辨率       │<────┤ 体结束       │<────┤ 分辨率状态   │
└─────────────┘     └─────────────┘     └─────────────┘

💡 工作原理：当通过 Sunshine 启动流媒体时，工具自动读取客户端分辨率，将主机调整为匹配参数，待流媒体结束后恢复原始设置，整个过程无需人工干预。

四、进阶技巧：场景化配置方案与自定义秘诀

4.1 基础配置（settings.json）

通过修改配置文件实现个性化设置：

调试模式：

{
  "debugMode": true,
  "gracePeriod": 120,
  "startupDelay": 5
}

• debugMode：启用后生成详细日志，便于故障排查
• gracePeriod：流媒体结束后的等待时间（秒）
• startupDelay：脚本启动延迟时间（秒）

4.2 自定义分辨率映射秘诀

使用覆盖功能实现特殊场景的分辨率转换，格式为 源分辨率=目标分辨率：

场景1：移动设备低带宽优化

"overrides": [
  "1080x2340x60=1280x720x30"
]

将手机的2340x1080分辨率映射为720p，降低带宽占用

场景2：超采样画质提升

"overrides": [
  "1920x1080x60=3840x2160x60"
]

客户端1080p分辨率触发主机4K渲染，通过超采样提升画质细节

4.3 10位深度支持设置

对于支持HDR的设备，可通过调整刷新率启用10位深度：

{
  "hdrSupport": {
    "enabled": true,
    "halveRefreshRate": true
  }
}

⚠️ 仅在客户端支持HDR流媒体时生效，通过减半刷新率换取10位色深支持

五、跨设备适配案例库

5.1 手机端配置模板

场景：使用iPhone 13（2532x1170）流媒体

"overrides": [
  "2532x1170x60=1920x1080x60"
],
"preferredResolution": {
  "width": 1920,
  "height": 1080,
  "refresh": 144,
  "enabled": true
}

5.2 平板端配置模板

场景：使用iPad Pro（2732x2048）流媒体

"overrides": [
  "2732x2048x60=2560x1440x60"
],
"startupDelay": 8

5.3 电视端配置模板

场景：4K电视（3840x2160）高刷新率需求

"overrides": [
  "3840x2160x60=3840x2160x120"
],
"gracePeriod": 180

六、常见问题与解决方案

6.1 冷启动后功能失效

问题：计算机硬重启后，分辨率自动化功能不工作
解决：

1. 使用Moonlight连接"桌面"应用
2. 正常结束流媒体会话
3. 重新启动目标应用即可恢复

6.2 分辨率不匹配

问题：主机未按预期调整分辨率
排查步骤：

1. 检查客户端分辨率是否已添加到主机的自定义分辨率列表
2. 查看 log.txt 确认是否有错误信息
3. 验证 overrides.txt 中的映射规则是否正确

6.3 权限相关问题

问题：安装或运行时提示权限不足
解决：

• 确保右键点击 Install.bat 并选择"以管理员身份运行"
• 检查用户账户是否具有管理员权限

通过以上配置和技巧，ResolutionAutomation 能够为您提供无缝的跨设备流媒体体验，让每一次连接都自动匹配最佳分辨率设置。无论是游戏娱乐还是办公需求，都能享受清晰、流畅的视觉体验。

若需获取最新版本或参与项目贡献，请访问项目仓库：git clone https://gitcode.com/gh_mirrors/re/ResolutionAutomation