Moonlight-NX 安装与配置完全指南

Moonlight-NX 安装与配置完全指南

moonlight-nx Moonlight port for Horizon OS 项目地址: https://gitcode.com/gh_mirrors/mo/moonlight-nx

项目基础介绍

Moonlight-NX 是一个专为 Nintendo Switch 设计的 Moonlight 游戏流传输项目的移植版本。它允许用户通过流媒体方式在 Switch 上玩 PC 游戏，利用了 NVIDIA 的游戏流技术。这个开源项目以 C++ 和少量 C 为主要编程语言，遵循 GPL-3.0 许可证。

关键技术和框架

• NVIDIA GameStream 技术: Moonlight 的核心，实现游戏从PC到Switch的低延迟视频流传输。
• libnx: 用于开发Nintendo Switch应用程序的库。
• switch-tools: 开发Switch软件的工具集。
• FFmpeg、Glfw、Jansson 等: 提供多媒体处理、图形界面支持及JSON解析等功能。

安装与配置指南

准备工作

1. 确保环境：你需要一台可以编译Switch程序的开发主机（Linux或macOS推荐）。

2. 必备工具：安装 devkitA64, switch-tools 及其他必要的依赖，例如 libnx, switch-ffmpeg, 等等。

   sudo (dkp-)pacman --noconfirm -S devkitA64 switch-tools [其他所需库]
   sudo (dkp-)pacman --noconfirm -Suy
   

3. GitHub账号：拥有GitHub账号以便下载自动构建或访问私有仓库。

安装步骤

使用Docker（推荐小白用户）

1. 创建工作目录：

   mkdir moonlight-nx-build && cd $_
   

2. 下载Dockerfile：

   wget https://raw.githubusercontent.com/rock88/moonlight-nx/master/Dockerfile
   

3. 构建并运行Docker容器：

   docker build -t moonlight-nx-build .
   docker run -it moonlight-nx-build
   

4. 克隆项目并构建（在Docker内）：

   git clone --recursive https://github.com/rock88/moonlight-nx.git
   cd moonlight-nx
   make
   

5. 导出构建结果：

   docker cp $(docker ps -aq):moonlight-nx/moonlight.nro ~/Downloads/
   

手动构建（适合高级用户）

1. 设置开发环境：执行上述准备工作中的第2步。

2. 克隆项目：

   git clone --recursive https://github.com/rock88/moonlight-nx.git
   

3. 构建项目：

   cd moonlight-nx
   make -j # 使用多线程加速编译过程
   

4. 找到构建产物：完成后，.nro文件将位于项目根目录下。

配置与部署

1. 将 .nro 文件转移到 Switch： 将构建得到的 moonlight.nro 文件复制到 Switch 的 microSD卡下的 /switch/moonlight/ 目录。

2. 启动游戏： 使用 Homebrew Launcher（hbmenu）并通过Title Redirection启动，以获得完整RAM访问权限。

3. 控制配置： 通过Switch的触摸屏，您可以调整鼠标输入模式和键盘快捷键。游戏手柄默认配置为Xbox 360样式，但支持自定义映射。

至此，您已经成功安装并配置了Moonlight-NX，可以在您的Nintendo Switch上享受远程游戏的乐趣了。记得探索更多设置以优化您的游戏体验！

moonlight-nx Moonlight port for Horizon OS 项目地址: https://gitcode.com/gh_mirrors/mo/moonlight-nx