Moonlight TV：大屏游戏串流神器完全指南

什么是Moonlight TV？

Moonlight TV是一款专为大屏设备打造的开源游戏串流客户端，基于NVIDIA GameStream技术开发。简单来说，它就像游戏内容的"视频快递服务"——把你电脑上的游戏画面通过网络"快递"到电视或嵌入式设备上，让你在舒适的客厅里享受高画质游戏体验。该项目支持LG webOS智能电视和Raspberry Pi（树莓派）等设备，完全由社区驱动开发。

核心功能解析

它能为你做什么？

• 高性能串流：针对webOS设备优化的低延迟传输技术
• 大屏交互设计：专为遥控器和手柄操作优化的用户界面
• 多控制器支持：最多可同时连接4个游戏手柄
• 跨平台适配：已实现对macOS、Arch、Debian、Raspbian和Windows系统的支持

技术规格速览

项目	规格参数
核心技术	NVIDIA GameStream协议
控制器支持	最多4台同时连接
画面输出	适配4K大屏分辨率
输入方式	遥控器/游戏手柄/键盘鼠标
网络要求	建议5GHz Wi-Fi或有线连接

如何准备运行环境？

硬件要求

• LG webOS电视：2017年及以后型号（webOS 3.5+）
• Raspberry Pi：树莓派3B+及以上型号（推荐4B）
• 游戏电脑：配备支持GameStream的NVIDIA显卡（GTX 600系列及以上）
• 网络设备：支持5GHz Wi-Fi的路由器（建议802.11ac标准）

软件依赖

• CMake 3.10+（项目构建工具）
• SDL2开发库（图形和输入处理）
• 编译器支持C11标准（如GCC 7+或Clang 5+）

小贴士：对于树莓派用户，建议使用官方64位Raspberry Pi OS，性能比32位系统提升约20%。

三步完成基础安装

第一步：获取源代码

打开终端（CLI命令行界面），输入以下命令克隆项目：

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

执行成功后，你会看到项目文件被下载到名为"moonlight-tv"的文件夹中。

第二步：安装依赖包

根据你的设备类型选择对应的命令：

LG webOS开发环境

# 需要先安装webOS SDK
npm install -g @webosose/ares-cli

Raspberry Pi系统

sudo apt update && sudo apt install -y \
  build-essential cmake libsdl2-dev \
  libavcodec-dev libavformat-dev libswscale-dev

小贴士：依赖安装过程可能需要5-15分钟，具体取决于网络速度。

第三步：编译与安装

执行项目提供的便捷构建脚本：

# 树莓派用户
scripts/raspi/easy_build.sh

# webOS开发者
scripts/webos/easy_build.sh

看到"Build completed successfully"提示时，表示编译已完成。

使用指南：从配置到畅玩

初次运行设置

1. 启动Moonlight TV应用，首次运行会进入设备配对向导
2. 在电脑上启动GeForce Experience，确保已登录NVIDIA账户
3. 应用会自动搜索局域网内的游戏电脑，选择你的设备
4. 输入电视上显示的4位PIN码到电脑端的配对窗口

小贴士：如果搜索不到设备，可手动输入电脑IP地址（在"添加设备"菜单中）。

游戏库管理

• 添加游戏：在主界面选择"添加游戏"，系统会自动同步电脑上的游戏列表
• 收藏游戏：长按游戏图标调出菜单，选择"添加到收藏"
• 游戏封面：首次运行游戏时会自动下载高清封面，需要保持网络连接

串流质量调整

在设置界面可以根据你的网络状况调整：

• 分辨率：推荐1080p（树莓派）或4K（webOS）
• 帧率：60fps为最佳体验（需稳定网络支持）
• 比特率：10-50Mbps可调，带宽充足时建议设为"自动"

适用场景分析

家庭娱乐中心方案

设备组合：LG webOS电视 + 游戏手柄
优势：原生4K输出，支持HDR，适合多人派对游戏
推荐游戏类型：动作冒险、体育竞技、多人对战

低成本客厅方案

设备组合：Raspberry Pi 4 + 普通HDMI电视
优势：硬件成本低（约300元），功耗仅5W
注意事项：建议选择1080p分辨率以保证流畅度

卧室游戏方案

设备组合：树莓派 + 电脑显示器
特色玩法：可通过SSH远程控制，躺在床上玩PC游戏

常见问题解决

连接失败怎么办？

1. 检查防火墙设置，确保允许GeForce Experience通过
2. 确认电脑和设备在同一局域网内
3. 重启路由器后重试连接

画面卡顿或延迟？

• 尝试切换到5GHz Wi-Fi频段
• 降低视频质量设置（先从比特率开始调整）
• 关闭电脑上的后台下载和视频串流软件

手柄无法识别？

1. 确保手柄在设备启动前已连接
2. 对于webOS设备，可尝试通过"设置>配件"重新配对
3. 树莓派用户可运行sudo apt install joystick修复驱动

进阶配置：释放全部潜力

自定义串流参数

高级用户可通过修改配置文件调整高级参数：

# 编辑配置文件
nano ~/.config/moonlight-tv/settings.ini

# 添加自定义参数（示例）
[stream]
bitrate=30000
maxfps=60
vsync=true

手柄按键映射

对于非标准手柄，可通过以下步骤自定义映射：

1. 连接手柄并启动应用
2. 进入"设置>控制器>自定义映射"
3. 按照屏幕提示依次按下对应按键

自动启动设置

Raspberry Pi系统

# 创建系统服务
sudo nano /etc/systemd/system/moonlight-tv.service

# 添加以下内容
[Unit]
Description=Moonlight TV Auto Start

[Service]
User=pi
ExecStart=/usr/bin/moonlight-tv

[Install]
WantedBy=multi-user.target

# 启用自动启动
sudo systemctl enable moonlight-tv

关于项目

Moonlight TV是开源社区驱动的项目，基于moonlight-embedded开发，特别优化了大屏设备的使用体验。项目源代码托管在GitCode，欢迎开发者贡献代码或报告问题。

注：本文档基于Moonlight TV最新稳定版编写，不同版本可能存在操作差异。建议定期查看项目更新以获取新功能和性能改进。