查看“HEOS”的源代码

HEOS 是 Denon 推出的多房间音乐系统。

==简介==
===时间轴===

==HEOS CLI==

===使用Telnet交互===
*1.[[Telnet]]客户端
Windows Vista之前，Telnet内置，Vista之后版本，在控制面板》程序和功能》启动或关闭windows功能》启用Telnet客户端。 在cmd终端输入telnet即可打开telnet客户端。

*2.登录支持HEOS的设备
查看设备ip，如路由器中，如：
<syntaxhighlight lang="sh" >
telnet 192.168.1.10 1255
</syntaxhighlight>
登录telnet设备交互终端，打字可能不显示，按 Ctrl + ] 退出，再按回车进入telnet设备，即可显示。

*3.虚拟终端交互命令
<syntaxhighlight lang="python" >
# 查看播放器设备信息，可以查看到pid，设备名称，设备型号，版本，序列号等。
heos://player/get_players

heos://player/get_player_info?pid=1
heos://player/get_play_state?pid=1
heos://player/get_now_playing_media?pid=1
heos://player/get_volume?pid=1
heos://player/get_queue?pid=1&range=0,10
heos://player/play_next?pid=1
</syntaxhighlight>

=== python中使用 ===
使用python内置的telnetlib模块，但是该模块将在Python 3.13中移除。
<syntaxhighlight lang="python" >
import telnetlib
import time

# 登录
tn = telnetlib.Telnet('192.168.3.188', 1255)
# 发送命令
tn.write(b'heos://player/get_players\n')
# 读取响应
time.sleep(0.1)
response = tn.read_very_eager().decode('ascii')
print(response)
tn.close()
</syntaxhighlight>

telnetlib读取返回结果有多个方法，如：
* read_very_eager()：立刻读取，最好加个延时如0.1秒，防止设备还没返回结果。
* read_all()：
* read_until()：

==资源==
===官网===
*HEOS CLI协议规范：https://assets.denon.com/documentmaster/us/heos_cli_protocolspecification-version_04062020.pdf

===网站===
* https://www.marantz.com/on/demandware.static/-/Library-Sites-marantz_northamerica_shared/default/dw23d01e39/archive-downloads/heos_cli_protocolspecification-version.pdf
* https://github.com/andrewsayre/pyheos
* https://github.com/ping13/heospy