一起听歌房间教程

D:\ECHO 当前源码中的 一起听歌 页面连接独立服务器。房主明确开启共享后，原生音频宿主可将当前本地 PCM 音频编码并转发给听众；听众不必在自己的曲库里拥有同一文件。它与旧文档中「双方各自找本地同一首歌」的方案不同。实际可用性取决于客户端、服务器协议和输出设备；不能把源码存在当成所有已发布安装包都已验收。

请只共享你有权向房间成员播放的内容。首次进入会显示使用条款，先阅读再决定是否同意。当前内置功能可用性与 Steam 创意工坊订阅无关；不要为了“解锁”安装不明工坊项目。

连接与建房

1. 打开 一起听歌。输入服务器的 wss:// 地址或客户端支持的连接码；公开服务器与自建服务器的可靠性各自取决于运营方。
2. 输入显示名称。Steam 账号可用时页面可能带入你的 Steam 昵称；也可按页面提供的方式填写测试昵称。
3. 连接成功后进入大厅。先看服务器在线状态、房间列表和人数上限。
4. 创建房间时可填写名称、人数、密码和是否隐藏。隐藏房间不会出现在公开列表，加入者需要房间 ID 或邀请。
5. 把房间 ID 或邀请发给受邀者。密码房间仍需密码；不要把密码贴到公开聊天。

加入者可以从公开列表选房，或在大厅输入房间 ID 与密码。页面显示满员、密码错误、协议不兼容或服务器不可达时，按具体错误处理，不要反复点击加入。

房主开始共享

1. 房主先在自己电脑播放一首本地文件，确认原生音频宿主真的在播。
2. 回房间点 开始共享。建好房间本身不会自动传音频。
3. 观察房间里的共享/接收状态，而不是仅看成员在线。切歌、暂停或停止后检查听众端是否跟随。
4. 离开前点 停止共享；房主结束房间会让成员退出。

当前共享源有边界：原生直接播放的本地 PCM 文件可作为候选；DSD/DoP、PCM 转 SDM、受保护源、网络地址或不受支持的输出模式可能被拒绝。拒绝时先换一首普通本地 MP3/FLAC 和受支持的输出模式，不要为了共享而把整套音频设置盲目改掉。

听众怎么听

听众加入后等待缓冲，并在房间内调节接收音量。支持多档音质的服务器与客户端可选择 Opus 128、256 或 320 kbps；旧服务器可能只有标准档。档位变化可能短暂重新缓冲。此处传输的是有损实时音频，不是把原始文件复制到听众电脑，也不保证无损或零延迟。

加入接收时可能暂时停止个人播放，但个人队列保留。退出房间后不会一定自动恢复原曲；回到播放器手动继续。听众主动播放自己的音乐时，接收会停止以避免与个人播放争用设备。

房间里的附加功能

• 聊天：只发给当前服务器和同房成员；当前客户端保留有限条数，退出或断线会清掉会话内容。不要发送密码或私人文件路径。
• 当前歌曲信息与歌词：只有服务器声明相应能力、且房主已有可共享的匹配结果时才显示。它不是替听众另起歌词搜索。
• 邀请好友：Steam 运行时可用时可能通过 ECHO 内的好友入口邀请；普通连接也可用房间 ID。邀请不代表自动绕过密码。
• 转让房主：只有服务器支持时显示。交接后旧音频会停止，新房主要选择自己的歌并重新开始共享。

出问题先看哪边

现象	先查
连不上服务器	地址是否为正确 wss://、网络/TLS、服务端版本与人数限制
进房但没声音	房主是否点了开始共享、原生播放是否真的有 PCM、听众输出设备与房间音量
播一会儿断开	网络拥塞、服务器心跳、客户端的重连/重试提示
歌名有了却没声音	歌名只是元数据；查看房主发送和听众接收的实时状态
不能切音质或聊天	服务器可能没有声明新能力；需要双方与服务端协议匹配

想听自己的固定歌曲，继续用本地曲库；Steam 账号、统计与隐私设置看Steam 版。