Moonlight-Switch：任天堂Switch上的PC游戏串流终极指南

Moonlight-Switch是一款专为任天堂Switch打造的开源游戏串流工具，让您能将PC上的3A大作无缝投射到掌机上游玩。通过高效的视频编码技术和直观的操作界面，彻底突破硬件限制，随时随地享受云端游戏的乐趣！

什么是Moonlight-Switch？

Moonlight-Switch是知名串流工具Moonlight在任天堂Switch平台的移植版本。它基于moonlight-common-c核心技术，通过本地网络将PC端游戏画面实时传输到Switch，配合低延迟控制方案，实现接近原生的游戏体验。

核心功能亮点

跨平台串流能力

支持Windows、Linux、macOS系统的游戏主机，兼容NVIDIA GeForce Experience和Sunshine串流服务，轻松投射Steam、Epic等平台游戏库。

多设备操控支持

• 原生适配Joy-Con手柄与Pro手柄
• 支持触摸屏虚拟按键与手势操作
• 兼容USB鼠标键盘（需OTG转接）
• 最多同时连接5个输入设备

自定义画质设置

通过app/src/streaming/MoonlightSession.hpp配置文件，可调整分辨率、比特率和帧率参数，平衡画质与流畅度。支持H.264/H.265硬件加速解码，优化Switch硬件性能。

多语言界面

内置英语、俄语、德语等10+种语言包，通过app/src/utils/Settings.hpp实现本地化切换。

安装与配置指南

准备工作

• 已破解的任天堂Switch（支持大气层或SX OS）
• 安装HB App Store
• 运行Windows 10/11的PC（建议GTX 1050以上显卡）
• 稳定的5GHz WiFi网络

快速安装步骤

1. 打开HB App Store搜索"Moonlight"
2. 选择"Moonlight-Switch"点击安装
3. 等待自动下载并完成安装
4. 返回主菜单即可看到新安装的应用图标

电脑端设置

1. 安装GeForce Experience并登录NVIDIA账户
2. 开启"游戏串流"功能（设置→ Shield→ 开启串流）
3. 添加游戏到GeForce Experience库
4. 确保PC与Switch连接同一网络

首次连接教程

1. 启动Switch端Moonlight-Switch
2. 应用会自动搜索局域网内的PC主机
3. 选择目标PC并输入配对码（PC端会显示4位数字）
4. 配对成功后即可看到游戏列表，点击即可开始串流


注意事项

• 性能优化：高分辨率串流可能需要适当超频CPU，相关配置文件位于app/src/switch/wrapper.c
• 网络要求：建议使用5GHz WiFi或有线网络，延迟控制在30ms以内体验最佳
• 兼容性问题：部分游戏可能需要调整按键映射

进阶功能探索

自定义按键映射

通过app/src/streaming/InputManager.cpp修改手柄按键映射，支持模拟摇杆灵敏度调节和按键宏设置。

唤醒电脑功能

配置网络唤醒（WOL）功能，通过app/src/streaming/WakeOnLanManager.cpp实现一键唤醒休眠中的PC。

画面增强设置

在app/src/streaming/video/deko3d目录下提供高级着色器选项，可启用锐化、抗锯齿等画质增强效果。

常见问题解决

• 搜索不到PC：检查防火墙设置，确保GeForce Experience端口开放
• 画面卡顿：降低分辨率至720P或调整比特率至10Mbps
• 手柄无响应：重新插拔Joy-Con或重启Switch
• 声音延迟：在音频设置中启用"低延迟模式"

玩家使用技巧

• 外出时可通过手机热点共享网络，但注意流量消耗
• 使用Pro手柄可获得更接近主机的操控体验
• 长时间游戏建议连接充电器，避免电量不足
• 通过app/src/utils/BoxArtManager.cpp自定义游戏封面图片

开发与贡献

Moonlight-Switch是完全开源的项目，核心代码位于app/src/streaming/MoonlightSession.cpp。开发者可通过以下方式参与贡献：

• 提交bug修复到官方仓库
• 开发新功能分支
• 完善语言翻译文件
• 编写硬件兼容性测试报告

结语

Moonlight-Switch让任天堂Switch突破硬件限制，成为您的随身游戏串流终端。无论是3A大作还是独立游戏，都能在掌机上流畅运行。立即通过HB App Store安装体验，开启您的云端游戏之旅！

需要获取最新版本或源码，可通过以下命令克隆仓库： git clone https://gitcode.com/gh_mirrors/mo/Moonlight-Switch