Moonlight TV 终极使用指南：轻松实现大屏游戏串流

Moonlight TV 是一款专为大屏设备打造的轻量级 NVIDIA GameStream 客户端，让你能够在 LG webOS 电视和 Raspberry Pi 等设备上流畅串流电脑游戏。本指南将带你快速掌握安装和使用技巧，享受震撼的大屏游戏体验。

🌟 为什么选择 Moonlight TV？

Moonlight TV 作为开源游戏串流解决方案，具备以下独特优势：

• 跨平台兼容：完美支持 webOS 智能电视和 Raspberry Pi 开发板
• 操作简单直观：界面针对大屏幕和遥控器操作优化
• 高性能传输：优化的流媒体算法，确保低延迟游戏体验
• 多手柄支持：同时支持最多4个游戏手柄连接
• 多语言界面：内置16种语言包，满足全球用户需求

📋 准备工作

硬件要求

• 游戏电脑：配备 NVIDIA 显卡并安装 GeForce Experience
• 显示设备：LG webOS 电视（2017年后型号）或 Raspberry Pi 4（2GB内存以上）
• 网络环境：千兆有线网络连接（强烈推荐）

软件要求

• 基础开发工具：CMake 3.13+、GCC 7.0+
• 依赖库：SDL2、OpenSSL、FFmpeg 等多媒体库

🚀 快速安装指南

获取项目源码

git clone https://gitcode.com/gh_mirrors/mo/moonlight-tv.git
cd moonlight-tv

一键构建安装

Linux 系统安装

./scripts/linux/easy_build.sh

webOS 电视安装

./scripts/webos/easy_build.sh

Moonlight TV 启动界面 - 简洁现代的视觉设计

🎮 首次使用设置

1. 启用 GameStream 功能

在电脑端打开 GeForce Experience，进入"设置 > SHIELD"选项卡，启用 GameStream 功能。

2. 设备配对连接

在电视或树莓派上启动 Moonlight TV 应用：

• 应用会自动扫描局域网内的游戏电脑
• 选择你的电脑设备并完成配对验证
• 配对成功后即可看到游戏库列表

游戏默认封面 - 手柄图标暗示游戏控制功能

3. 启动游戏串流

从游戏列表中选择任意游戏，点击启动即可开始串流。首次使用建议选择配置要求较低的游戏进行测试。

⚙️ 优化设置技巧

网络优化

• 有线连接优先：无线网络可能造成延迟和卡顿
• 路由器设置：确保 UPnP 功能开启，避免网络限制

画面质量调整

• 分辨率设置：Raspberry Pi 建议 1080p/60fps，老旧设备可降至 720p
• 码率优化：默认10Mbps，网络条件好可提升至35Mbps

手柄配置

• 自动识别：主流手柄通常可直接使用
• 手动映射：特殊手柄可编辑配置文件：deploy/webos/assets/gamecontrollerdb_extra.txt

❓ 常见问题解答

Q: 无法发现游戏电脑怎么办？

A: 检查电脑和设备是否在同一局域网，关闭防火墙对 GeForce Experience 的限制，或尝试手动添加电脑IP地址。

Q: 画面卡顿或延迟严重？

A: 优先使用有线网络，降低分辨率或码率设置，关闭电脑上的硬件加速编码功能。

Q: webOS 电视安装失败？

A: 确保电视已开启开发者模式，或使用未签名包安装选项。

Q: 手柄无法正常使用？

A: 检查手柄是否支持 SDL2 标准，或参考项目文档中的手柄配置指南。

🔧 高级功能

自定义构建选项

项目支持多种自定义构建选项，可通过 CMake 参数进行配置：

• -DBUILD_TESTS=ON/OFF - 控制是否构建测试用例
• -DCMAKE_TOOLCHAIN_FILE - 指定交叉编译工具链

多语言支持

项目内置完整的国际化支持，如需添加新的语言翻译，可编辑对应语言目录下的 messages.po 文件。

---

提示：更多详细配置和故障排除信息，请参考项目中的文档文件。如果在使用过程中遇到问题，建议查看详细的安装说明文档获取更多帮助。