ResolutionAutomation：3步解决Moonlight串流分辨率不匹配难题
【免费下载链接】ResolutionAutomationAutomates changing the host resolution to match the client resolution of Moonlight, with capabilities of supersampling if required项目地址: https://gitcode.com/gh_mirrors/re/ResolutionAutomation
ResolutionAutomation是一款专为Moonlight游戏串流设计的智能分辨率匹配工具，能够自动调整主机分辨率与客户端设备保持一致，彻底告别画面拉伸、黑边和显示变形问题！🎮 无论你是Steam Deck玩家、平板用户还是多显示器游戏爱好者，这个开源工具都能让你的串流体验如丝般顺滑。
📊 为什么Moonlight串流需要分辨率自动匹配？
当你在不同设备之间使用Moonlight进行游戏串流时，经常会遇到一个令人头疼的问题：客户端设备（如手机、平板电脑）与主机电脑的屏幕比例不同，导致画面出现拉伸变形或恼人的黑边。ResolutionAutomation通过智能检测和实时调整，完美解决了这一技术难题。
🔧 核心工作原理揭秘
- 智能环境检测：自动读取Sunshine传递的客户端分辨率信息
- 实时分辨率调整：在串流开始时瞬间匹配主机与客户端分辨率
- 自动恢复机制：串流结束后无缝还原原始分辨率设置
🚀 快速安装指南：3分钟完成部署
系统环境要求
- Windows操作系统（Windows 10/11）
- Sunshine 0.21.0或更高版本
- 管理员权限（用于修改Sunshine配置）
安装步骤详解
获取项目代码：
git clone https://gitcode.com/gh_mirrors/re/ResolutionAutomation项目目录放置：将下载的文件夹放在你打算长期保存的位置（建议不要放在桌面或下载文件夹）
一键安装执行：双击运行Install.bat文件
权限授权确认：脚本会请求管理员权限以修改Sunshine配置文件
Windows 11特殊配置
对于Windows 11用户，需要将默认终端设置为Windows Console Host：
- 打开"设置" > "系统" > "开发者选项" > "终端"
- 将"让Windows决定"改为"Windows Console Host"
⚙️ 高级配置详解：定制你的完美串流体验
分辨率覆盖规则配置
在settings.json文件中，你可以灵活配置分辨率覆盖规则：
"overrides": [ "1280x720x60=3840x2160x60", "1920x1080x60=3840x2160x60" ]格式说明：客户端分辨率=主机分辨率
- 左侧：触发覆盖的客户端分辨率
- 右侧：主机将被设置的分辨率
自定义首选分辨率设置
如果你希望在不串流时使用特定的分辨率，可以启用首选分辨率功能：
"preferredResolution": { "width": 1920, "height": 1080, "refresh": 60, "enabled": true }🎯 实战应用场景：针对不同设备的优化方案
Steam Deck用户最佳实践
对于Steam Deck玩家，推荐使用超采样串流以获得更好的视觉体验：
"2560x1440x90=3840x2400x60"这种设置可以显著提升画面清晰度，让Steam Deck上的游戏体验更加出色。
移动设备带宽优化方案
如果你在移动网络环境下使用Moonlight，可以通过降低串流分辨率来节省带宽：
"1280x720x60=1920x1080x60"多显示器用户配置技巧
对于拥有多个显示器的用户，ResolutionAutomation可以确保正确的显示器被设置为目标分辨率，避免串流到错误的屏幕上。
🔍 高级功能深度解析
10位色深兼容性支持
对于使用虚拟插头的用户，可以启用10位色深强制兼容功能：
"force10BitDepthOnUnsupportedDevices": { "enabled": true, "refreshRate": 30 }最高刷新率偏好设置
如果你是G-SYNC显示器用户，可以启用最高刷新率偏好功能以获得更流畅的游戏体验：
"preferHighestRefreshRate": true📋 故障排除与常见问题解决
安装后脚本不工作？
- 检查文件夹位置：如果移动了项目文件夹，需要重新运行Install.bat
- 验证管理员权限：确保以管理员身份运行安装脚本
- 检查Sunshine版本：确认Sunshine版本为0.21.0或更高
冷启动问题解决方案
由于Windows API限制，脚本在冷重启后可能失效。解决方法：
- 通过Moonlight的"桌面"应用登录计算机
- 结束当前串流会话
- 重新开始串流
分辨率设置失败？
- 确认分辨率可用：使用NVIDIA自定义分辨率或CRU工具预先添加客户端分辨率
- 检查显卡驱动：确保显卡驱动程序为最新版本
- 验证显示器支持：确认显示器支持目标分辨率和刷新率
💡 专业使用技巧与优化建议
性能优化配置
- 预先添加自定义分辨率：在使用前通过显卡控制面板添加所有可能用到的分辨率
- HDR兼容性设置：在支持HDR的设备上正确配置相关参数
- 刷新率匹配：确保主机和客户端的刷新率设置合理匹配
调试模式启用
如果遇到问题，可以在settings.json中启用调试模式：
"debug": true启用后，脚本会生成详细的日志信息，便于诊断问题。
🛠️ 核心源码结构解析
主要脚本文件
- Installer.ps1：安装脚本主文件
- StreamMonitor.ps1：串流监控核心逻辑
- Helpers.ps1：辅助功能模块
- Events.ps1：事件处理系统
配置管理系统
- settings.json：主配置文件
- overrides.txt：分辨率覆盖规则文件
🔄 卸载与恢复流程
如果需要卸载ResolutionAutomation，只需双击运行Uninstall.bat文件。脚本会自动：
- 移除Sunshine中的相关配置
- 清理系统环境变量
- 恢复原始分辨率设置
🎮 与其他工具的完美集成
自动化工具套件
ResolutionAutomation可以与其他自动化工具完美配合使用：
"installationOrderPreferences": { "enabled": true, "scriptNames": [ "MonitorSwapper", "ResolutionMatcher", "AutoHDR", "RTSSLimiter", "PlayNiteWatcher" ] }与Vibeshine的兼容性
Vibeshine是Sunshine的一个定制分支，提供了更平滑的显示器切换体验。如果你使用Vibeshine，可以在其音频/视频选项卡中直接配置分辨率切换功能，无需额外使用ResolutionAutomation。
📈 最佳实践总结
新手用户推荐配置
- 保持默认设置开始使用
- 根据实际设备添加必要的分辨率覆盖
- 启用调试模式进行初步测试
高级用户优化方案
- 配置完整的超采样分辨率链
- 集成HDR自动切换功能
- 设置多显示器优先级规则
企业级部署建议
- 使用脚本化安装进行批量部署
- 配置集中式日志收集
- 建立监控和告警机制
🚀 开始你的完美串流之旅
ResolutionAutomation为Moonlight用户提供了前所未有的分辨率匹配便利性。无论你是在不同设备间切换游戏，还是需要优化特定场景的串流质量，这个工具都能成为你的得力助手。
通过智能的分辨率匹配、灵活的配置选项和稳定的运行表现，ResolutionAutomation让游戏串流变得更加简单、流畅和高效。现在就下载安装，告别分辨率不匹配的烦恼，享受真正无缝的串流体验！
技术提示：本文档基于ResolutionAutomation项目最新版本编写，具体功能实现请参考项目源码和配置文件。建议定期检查项目更新以获取最新功能和优化。
【免费下载链接】ResolutionAutomationAutomates changing the host resolution to match the client resolution of Moonlight, with capabilities of supersampling if required项目地址: https://gitcode.com/gh_mirrors/re/ResolutionAutomation
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
