Moonlight TV 安装与使用指南

项目概述 📌

Moonlight TV 是一款轻量级的 NVIDIA GameStream 客户端，专为 LG webOS 电视和 Raspberry Pi 等嵌入式设备设计。通过该工具，你可以将电脑上的游戏流畅地流式传输到电视屏幕，享受大屏游戏体验。项目采用 C 语言开发，使用 CMake 构建系统，整合了 SDL2 框架用于图形渲染和输入处理。

核心优势 ✨

• 跨设备支持：同时兼容 LG webOS 智能电视和 Raspberry Pi 开发板
• 轻量高效：优化的流媒体传输算法，降低设备硬件资源占用
• 简化操作：提供预配置脚本，一键完成构建与部署流程
• 多语言支持：内置 16 种语言包，满足全球用户需求

环境准备 📋

硬件要求

• LG webOS 电视：2017 年及以后型号（支持 webOS 3.5+）
• Raspberry Pi：建议 Raspberry Pi 4 及以上型号（2GB RAM 起步）
• 网络环境：稳定的千兆有线网络连接（Wi-Fi 可能导致延迟）

软件要求

• 开发工具链：GCC 7.0+、Make 3.81+、Git 2.17+
• 依赖库：SDL2 开发包、CMake 3.13+、OpenSSL 1.1+

分步部署 🔨

1. 获取项目源码

git clone https://gitcode.com/gh_mirrors/mo/moonlight-tv.git  # 克隆代码仓库
cd moonlight-tv  # 进入项目根目录

2. 安装系统依赖

# Debian/Ubuntu 系统
sudo apt update && sudo apt install -y build-essential cmake libsdl2-dev  # 安装基础编译工具

# Fedora/RHEL 系统
sudo dnf install -y @development-tools cmake SDL2-devel  # 安装开发套件

3. 配置构建选项

mkdir -p ./build  # 创建构建目录
cd ./build  # 进入构建目录
cmake ..  # 使用默认配置生成 Makefile

4. 编译项目代码

make -j$(nproc)  # 多线程编译（根据CPU核心数自动调整）

5. 执行安装程序

sudo make install  # 将程序安装到系统目录

6. 设备专用部署

🔧 Raspberry Pi 部署

cd ./scripts/raspi  # 进入树莓派专用脚本目录
./easy_build.sh  # 执行一键构建脚本

🔧 webOS 电视部署

cd ./scripts/webos  # 进入webOS专用脚本目录
./easy_install.sh  # 执行电视安装脚本（需提前配置ADB连接）

功能验证 ✅

基本连接测试

1. 确保电脑已安装 GeForce Experience 并启用 GameStream 功能
2. 在目标设备上启动 Moonlight TV 应用
3. 应用会自动发现局域网内的游戏电脑，选择你的设备并完成配对
4. 配对成功后将显示可用游戏列表，选择任意游戏启动即可开始流式传输

性能优化建议

• 分辨率设置：Raspberry Pi 建议使用 1080p/60fps，老旧设备可降至 720p
• 码率调整：默认码率为 10Mbps，网络条件好可提升至 35Mbps（设置路径：设置 > 视频 > 比特率）
• 输入延迟：启用"游戏模式"可减少电视图像处理延迟

常见问题 ❓

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

A: 确保电脑和设备在同一局域网，关闭防火墙对 GeForce Experience 的限制，或手动添加电脑IP（设置 > 添加主机）

Q: 画面卡顿严重如何解决？

A: 优先使用有线网络连接，降低分辨率或码率，关闭电脑上的硬件加速编码（Nvidia控制面板 > 3D设置）

Q: 控制器无法识别怎么处理？

A: 检查控制器是否支持 SDL2 标准，或手动添加映射文件到 deploy/webos/assets/gamecontrollerdb_extra.txt

Q: webOS 电视安装失败提示"证书错误"？

A: 需在电视开发者模式中添加信任证书，或使用 scripts/webos/easy_install.sh --unsigned 安装未签名包

---

提示：完整文档和高级配置指南可查看项目中的 docs/INSTALL.steamlink.md 文件，更多问题可访问项目 GitHub 仓库提交 Issue。