rheos/roon-extension-rheos

RHEOS

概述

RHEOS是一款ROON扩展程序，允许从ROON控制Denon/Marantz HEOS设备。它通过模拟Squeezebox设备，使HEOS设备在ROON中可用，并支持设备发现、双向控制、分组管理及AVR区域控制等功能，无需依赖AirPlay即可实现高分辨率音频流传输。

核心功能

• 自动设备发现：启动时自动发现网络中的HEOS设备，并通过UPnP在ROON中显示为音频设备。
• 双向控制：支持从ROON或HEOS应用控制播放、暂停、上一曲、音量、静音及HEOS播放器分组。
• HEOS分组管理：通过HEOS原生分组确保多播放器同步，仅支持HEOS设备分组，最大同时分组数为16台（取决于网络性能）。
• 固定分组创建：可将常用播放器组合保存为固定分组，支持统一音量控制，分组分辨率由组内最低分辨率设备决定。
• AVR区域控制：控制Denon/Marantz功放区域电源、音量及音效模式选择。
• 高分辨率音频支持：不使用AirPlay，HS2播放器可流式传输高分辨率音频。
• 轻量依赖：基于纯JavaScript/Node.js开发，依赖模块少（heos-api、squeeze2UPnP、ip）。

使用场景

适用于拥有Denon/Marantz HEOS设备（如HEOS DRIVE HS1/HS2、HEOS 1/3/5/7、HEOS LINK/AMP及HEOS使能AVR）的用户，需通过ROON集中控制音频播放、设备分组及功放区域设置，追求高分辨率音频体验的场景。

初始设置

1. 在下载目录中通过命令行运行应用：

   bash
   node .
   

2. 在ROON设置中启用Squeezebox支持：进入 设置 > 启用Squeezebox支持。
3. 在ROON中启用RHEOS：进入 设置 > 扩展 > 启用RHEOS。

设备连接

设备发现

RHEOS启动时会自动发现网络中的HEOS设备，已测试设备包括Marantz HEOS使能AVR、HEOS DRIVE HS1/HS2、HEOS 1/3/5/7、HEOS LINK及HEOS AMP。

设备配置

• 设备命名：发现的设备初始无名称，需在ROON中通过 编辑房间 > 选择/编辑名称 命名并启用。
• 高分辨率设置：HS2或"Denon Home"设备可在 设置 > 扩展 > RHEOS > 设置 中为单个设备启用高分辨率流（192 kHz 24 Bit Flac），默认CD分辨率（48kHz 24 bit）；支持"直通模式"（直接传输原始音频文件，需确保设备支持文件分辨率）。
• 网络配置：HEOS设备需与Roon Server及RHEOS运行设备在同一局域网。可手动指定主HEOS设备IP（通过路由器DHCP表获取），或使用自动发现的IP（在设置中显示为“Roon Extension Host IP Address”）。
• UPnP设置：默认使用Roon Server地址作为UPnP服务器地址，若需修改可在设置中调整。UPnP高级参数（如buffer-size、output-size等）建议保持默认，详细说明参见https://github.com/philippe44/LMS-to-uPnP%E3%80%82

使用方法

常规控制

HEOS设备在ROON 设置 > 音频 中显示为Squeezebox设备，可像普通ROON端点一样控制播放、暂停、跳过曲目及音量。分组操作通过ROON标准分组功能实现，后台自动转换为HEOS分组，变更会同步至HEOS应用。

固定分组

固定分组允许将常用播放器组合保存为虚拟Squeezebox设备，支持统一音量控制及自动分组/解组。

1. 创建分组：在ROON或HEOS应用中选择需分组的设备，完成分组后进入 设置 > 扩展 > RHEOS > 设置 > 分组。
2. 保存分组：在分组列表中选择需保存的分组，通过下拉菜单选择分辨率（高分辨率/CD分辨率）或删除，保存后生成虚拟Squeezebox设备。
3. 启用分组：进入 设置 > 音频，启用新创建的虚拟设备，建议命名时以Unicode符号（如🔗、🏠）开头以便识别。
4. 使用分组：播放时自动组建分组（名称显示为“首个设备名+设备数量”），停止播放时自动解组；通过分组音量控制可统一调节所有设备音量或静音。

AVR区域控制

支持控制Denon/Marantz双区域AVR的电源状态、音量及音效模式：

1. 启用控制：进入 设置 > 扩展 > RHEOS > 设置 > 启用AVR区域控制，选择“开启”。
2. 配置区域：AVR多区域设备会生成“区域控制设备”，进入设备设置的“外部源控制”，从下拉菜单添加主区域、Zone 2控制及音效控制。
3. 启用区域设备：进入 设置 > 音频，启用新生成的区域Squeezebox设备（命名格式为“接收器名+区域名”），可自定义名称。

已知限制

• 无法从HEOS应用跳过ROON播放列表中的下一曲目。
• Windows防火墙可能阻止设备通信，需允许./ROON/UPnP/Bin/RHEOS2UPnP和./ROON/UPnP/Bin/Squeezelite/通过防火墙。
• 固定分组不支持双向控制，无法在HEOS应用中创建或控制。
• 播放时HEOS应用无法显示元数据（如专辑封面、曲目信息）。

致谢

感谢Juliuscc开发的heos-api及philippe44开发的Squeeze2UPnP，为本项目提供核心技术支持。