NeriPlayer 中文文档 下载 App

一起听房间创建、加入与深链加入完整流程

角色定义

角色权限
房主创建房间、管理成员、控制播放(选曲/暂停/循环/随机)、复制邀请链接和密钥
听众加入房间、被动接收播放状态、可选发起成员控制请求

创建房间

房主在「现在播放 → 一起听」中创建新房间。创建时:

加入房间

听众有两种加入方式:

方式说明
邀请链接房主复制的完整链接,包含房间密钥(首次加入必须提供)
深链加入NeriPlayer 深链协议自动识别(如 neriplayer://listen-together/join)

首次加入必须提供邀请密钥——密钥不会出现在公开房间状态里。成员重连时使用成员密钥,不需要重新提供邀请密钥。

点击加入时应用会从剪贴板读取有效邀请,剪贴板没有有效邀请则不会入房、不会静默失败。

邀请密钥的保护

会话候选共享

开启会话候选共享后,房主当前歌曲的候选播放地址会由 Cloudflare Worker 临时缓存。听众在成员会话内可直接取得这些候选,无需等待房主再次响应。