Moonlight V+ for HarmonyOS

🌙 Moonlight V+ for HarmonyOS

专为鸿蒙打造的 PC 游戏串流客户端

基于 Moonlight V+ 的鸿蒙原生移植版本

功能特性 • 下载安装 • 使用说明 • 相关项目 • 开发指南

---

✨ 功能特性

🏆 比原版 Moonlight 强在哪？

原版 Moonlight 只能 HDR10？我们直接 HLG 拉满。 华为设备原生 HDR Vivid 支持 + HLG (ARIB STD-B67) 传输，画面色彩准确到让你怀疑自己以前串流的是黑白电视。搭配 Foundation Sunshine 使用，你的 PC 游戏画面终于配得上你那块好屏幕了。

特性	原版 Moonlight	🌙 Moonlight V+
HDR10	✅	✅ 亮度映射同步
HLG (HDR Vivid)	❌	✅ 独家
虚拟显示器	❌	✅ 无缝连接，自由排列
服务端指令	❌	✅ 串流中直接执行
智能码率(ABR)	❌	✅ 结合LLM与网络环境决策码率
空间音频	❌	✅ HarmonyOS 5.0+
体感助手 (Gyro Aim)	❌	✅ 陀螺仪→右摇杆辅助瞄准
Game Controller Kit	❌	✅ 鸿蒙原生手柄 API
音频振动反馈	❌	✅ 低频/节拍驱动触感反馈
性能覆盖层	基础	✅ 可拖可锁/自定义项目
麦克风重定向	❌	✅ 语音开黑

视频串流

• 🎮 支持 H.264/HEVC 硬件解码
• 📺 支持 4K@120fps 高清串流
• 🌈 支持 HDR10/HLG 高动态范围
• 🔄 支持 VRR 可变刷新率

音频

• 🔊 支持立体声/5.1/7.1 环绕声
• 🎧 支持空间音频 (HarmonyOS 5.0+)
• 🎙️ 支持麦克风重定向 (开发者模式)

输入控制

• 🎮 蓝牙/USB 手柄支持 (Xbox/PlayStation/Switch)
• 📱 虚拟屏幕控制器
• 🖱️ 触控/鼠标模拟
• ⌨️ 完整键盘支持

连接

• 🔍 自动发现局域网主机
• 🌐 支持远程串流 (需要端口转发或 WAN IP)
• 🔒 AES-128 加密连接

📥 下载安装

系统要求

• HarmonyOS NEXT 5.0 或更高版本
• 支持的设备：华为手机/平板/MatePad

安装方式

从鸿蒙应用商店安装 在华为/鸿蒙设备上打开「应用市场」 搜索 Moonlight V+ 进入应用详情页后点击安装 也可以先在浏览器打开 应用市场详情页。 若未能自动唤起应用市场，请复制链接到华为浏览器打开，或回到应用市场内搜索应用名。 请优先通过鸿蒙应用商店下载，不建议从非官方网盘或镜像站安装。 从源码编译 git clone https://github.com/AlkaidLab/moonlight-harmony.git cd moonlight-harmony # 使用 DevEco Studio 打开并编译

📖 使用说明

主机设置

1. 在 PC 上安装 Foundation Sunshine 或 NVIDIA GeForce Experience
2. 启用游戏串流功能
3. 确保 PC 和手机在同一局域网

配对连接

1. 打开 Moonlight V+ for HarmonyOS 应用
2. 应用会自动发现局域网内的主机
3. 点击主机进行配对（首次需要在 PC 端确认）
4. 配对成功后即可选择游戏开始串流

推荐设置

网络环境	分辨率	帧率	码率
5GHz WiFi 局域网	1080p	60fps	20 Mbps
5GHz WiFi 局域网	4K	60fps	50 Mbps
有线/Wi-Fi 6	1080p	120fps	40 Mbps

🔗 相关项目

项目	说明
Moonlight V+ Android	Android 增强版客户端
Foundation Sunshine	游戏串流服务端
Moonlight	官方 Moonlight 项目
moonlight-common-c	核心协议库

🛠️ 开发指南

开发环境

• DevEco Studio: 6.1 或更高版本；已验证 HarmonyOS 26.0.0 Beta1 SDK 可进入编译流程
• HarmonyOS SDK: 兼容 API 12+；当前 targetSdkVersion 保持 6.1.1(24)
• Node.js: 20.x 或更高版本
• JDK/JBR: 本地打包 HAP 需要可用的 Java Runtime；可直接使用 DevEco Studio 自带 JBR

说明：暂不直接把 targetSdkVersion 升到 API 26。API 26 会启用新的 ArkUI/权限/系统行为门控，当前优先保持运行行为稳定，同时让 CI 和本地 SDK 工具链先识别 HarmonyOS 26.0.0。

项目结构

moonlight-harmony/
├── entry/                          # 主入口模块
│   └── src/main/
│       ├── ets/                    # ArkTS 代码
│       │   ├── pages/              # UI 页面
│       │   ├── components/         # UI 组件
│       │   ├── service/            # 业务服务
│       │   └── model/              # 数据模型
│       └── resources/              # 模块资源
├── nativelib/                      # Native 模块
│   └── src/main/cpp/               # C/C++ 代码
│       ├── moonlight_bridge.*      # NAPI 桥接层
│       ├── video_decoder.*         # 视频解码 (AVCodec)
│       ├── audio_renderer.*        # 音频播放 (OHAudio)
│       └── moonlight-common-c/     # 核心协议库
└── AppScope/                       # 应用配置

核心技术

功能	技术方案
UI 框架	ArkUI (ArkTS)
视频解码	HarmonyOS AVCodec API
音频播放	OHAudio (低延迟模式)
网络协议	moonlight-common-c
Native 接口	NAPI (C++)

构建项目

# 克隆仓库
git clone https://github.com/AlkaidLab/moonlight-harmony.git

# 使用 DevEco Studio 打开项目
# File → Open → 选择项目目录

# 编译 HAP
./hvigorw assembleHap

🐛 问题反馈

如果您遇到问题或有功能建议，请：

1. 查看 Issues 是否已有相关问题
2. 如果没有，请 创建新 Issue

反馈时请提供：

• 设备型号和系统版本
• 问题复现步骤
• 错误日志（如有）

📄 许可证

本项目基于 GPL v3 许可证开源。

第三方资源声明

本应用的背景壁纸功能使用了第三方 API 服务：

来源	说明	版权
Pipw API	二次元壁纸（默认）	图片版权归原作者所有
Lorem Picsum	摄影壁纸（可选）	Unsplash 授权

重要声明：

• 本应用仅提供技术链接，不存储、不拥有这些图片的版权
• 如有版权问题，请联系原图片来源方
• 用户可在设置中随时关闭壁纸功能或切换为其他来源

🙏 致谢

• Moonlight Game Streaming - 官方 Moonlight 项目
• moonlight-common-c - 核心协议库
• LizardByte/Sunshine - 开源串流服务端

---

Powered by AlkaidLab ✨

如果这个项目对您有帮助，欢迎给一个 ⭐️，也可以通过 GitHub Sponsors 赞助我们