ResolutionAutomation项目：实现Moonlight串流时的主机分辨率自动匹配

ResolutionAutomation项目：实现Moonlight串流时的主机分辨率自动匹配

【免费下载链接】ResolutionAutomation Automates 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游戏串流场景开发的自动化脚本工具，它能够智能地调整主机端显示分辨率以完美匹配客户端设备。该项目主要解决了当主机和客户端设备具有不同屏幕比例或用户希望在串流时保持分辨率一致时的显示适配问题。

核心功能解析

动态分辨率适配机制

该工具的核心功能是在Moonlight串流会话开始时，自动将主机分辨率调整为与客户端完全匹配的设置。这一过程通过以下技术路径实现：

1. 环境变量读取：脚本通过Sunshine服务传递的环境变量获取客户端设备的分辨率信息
2. 分辨率设置：利用Windows API将主机显示设置调整为与客户端完全匹配的分辨率参数
3. 状态监测：持续监控串流会话状态，在会话结束时自动恢复原始分辨率

高级配置选项

项目提供了灵活的配置系统，特别是针对特殊使用场景：

1. 分辨率覆盖规则：通过settings.json文件中的overrides配置项，用户可以定义特定客户端分辨率到主机分辨率的映射规则。例如将移动设备的720p请求映射为主机的4K输出
2. 刷新率优先模式：新增的preferHighestRate设置专为GSYNC用户优化，可优先匹配最高可用刷新率
3. 多显示器支持：脚本能够正确处理多显示器环境下的分辨率切换

技术实现细节

系统架构

该解决方案采用事件驱动架构，主要包含以下组件：

1. Sunshine集成模块：与Sunshine 0.21.0+深度集成，通过服务启动触发脚本执行
2. 分辨率管理引擎：负责解析客户端参数并执行主机端显示设置变更
3. 状态持久化层：记录原始显示设置以确保能够正确恢复

平台适配考量

项目针对不同使用环境进行了专门优化：

1. Windows终端兼容性：特别处理了Windows 11终端模拟器的兼容性问题
2. 冷启动恢复机制：提供了针对系统冷启动后的恢复流程指导
3. 管理员权限管理：正确处理Sunshine配置修改所需的安全权限

最佳实践指南

部署建议

1. 路径稳定性：安装后不应移动脚本目录，否则需要重新安装
2. 分辨率预配置：确保目标分辨率已通过NVIDIA自定义分辨率或CRU工具预先配置
3. 终端设置：Windows 11用户需将默认终端设置为Windows Console Host以获得最佳兼容性

性能优化技巧

1. 移动设备优化：通过overrides配置实现客户端低分辨率到主机高分辨率的映射，平衡画质与带宽
2. GSYNC配置：启用preferHighestRate设置以获得最佳可变刷新率体验
3. 启动加速：最新版本已优化脚本启动和结束时的性能表现

典型应用场景

1. 跨比例串流：在16:9主机和16:10客户端等不同比例设备间实现完美画面适配
2. 画质优先串流：保持主机与客户端分辨率一致，避免额外的缩放处理
3. 多设备管理：为不同客户端设备配置个性化的分辨率映射规则

ResolutionAutomation项目通过智能化的分辨率管理，显著提升了Moonlight串流体验的完整性和一致性，特别适合追求完美游戏串流体验的高级用户。

【免费下载链接】ResolutionAutomation Automates changing the host resolution to match the client resolution of Moonlight, with capabilities of supersampling if required 项目地址: https://gitcode.com/gh_mirrors/re/ResolutionAutomation