尧图网站建设 
Vivi-Music Listen Together同步听歌私有服务器搭建完整攻略与沉浸式界面详解【免费下载链接】vivi-musicVivi-Music is an expressive Material 3–based YouTube Music client for Android.项目地址: https://gitcode.com/gh_mirrors/vi/vivi-musicVivi-Music 是一款基于 Material 3 的 Android 端 YouTube Music 客户端其Listen Together 同步听歌功能让你和朋友在同一房间里实时收听同一首歌进度、曲目、音量全程同步还能创建房间、分享房间码、互提歌曲。本文详解这套功能的沉浸式界面并给出私有服务器搭建的完整思路与接入步骤。什么是 Listen Together 同步听歌简单来说你创建一个房间把 8 位数的房间码发给朋友大家连入后所有设备播放同一首歌、同一个进度。它不是各自播放而是真正的实时同步播放——主人Host播放什么客人Guest就听到什么连音量都会跟随主人调整。核心机制一览角色能力房主 Host创建房间、批准/拒绝加入、踢人、转移房主、接收点歌客人 Guest输入房间码加入、同步收听、向房主推荐歌曲服务器中转状态与消息支持公共节点或自建私有节点整套功能入口位于 ListenTogetherScreen.kt配置界面在 ListenTogetherSettings.kt。沉浸式界面详解房间里的每个细节房间界面的设计非常Material 3值得关注的亮点身份系统为每人大小的头像库可选人物插画风格配合用户名展示在房间成员列表加入请求队列朋友申请加入时会弹出提示房主可逐一审批也可开启自动批准Auto-approve让朋友直接进入点歌机制客人看到想听的歌可以推荐给房主房主批准后进入播放队列——对应协议里的SuggestTrackPayload消息音量同步开启 Sync host volume 后客人的音量跟随房主适合一起调大音量的聚会场景智能重同步Smart resync网络抖动或切后台后客户端会智能校准进度而不是从头重播连接日志设置页内置View logs面板带 INFO/WARNING/ERROR 分级标签出问题时一键复制全部日志拉黑功能Blocked Users 列表可直接管理被拉黑的用户。界面文案与提示语集中在 vivi_strings.xml例如房间创建提示Room created、加入被拒原因等都来自这里。私有服务器搭建完整攻略第一步理解通信协议关键Listen Together 客户端通过WebSocketwss://连接同步服务器消息体采用 Protobuf 编码统一包裹在Envelope结构里含type、payload、compressed三个字段。完整协议契约就写在仓库里协议定义listentogether.proto客户端实现ListenTogetherClient.kt你只需读懂这几个核心消息就能实现自己的服务器消息用途CreateRoomPayload/JoinRoomPayload创建房间 / 凭房间码加入RoomState房间快照成员、当前曲目、进度、音量、队列SyncStatePayload播放状态同步播放/暂停/seek 后广播JoinRequestPayload/ApproveJoinPayload加入审批流程ReconnectPayloadsession_token断线后用会话令牌恢复身份TransferHostPayload/KickUserPayload房主管理第二步搭建你的 WebSocket 节点自建服务器的最小要求清单部署一个支持 wss:// 的 WebSocket 服务任何语言均可Node.js、Python 等能解析/生成 Protobuf 的Envelope消息维护房间状态按room_code存储RoomState有新事件换歌、暂停、进度、音量、成员变化就广播给房间内所有连接审批逻辑收到JoinRoomPayload时先向房主推送JoinRequestPayload等待ApproveJoinPayload或RejectJoinPayload回复若房主开启自动批准则直接放行会话保持为每个成员签发session_token断线重连时凭令牌恢复房间身份避免被踢出门HTTPS/WSS 证书移动端只接受安全的wss://地址建议用 Lets Encrypt 之类的证书。公共节点的配置可参考 ListenTogetherServers.kt其中ListenTogetherServer数据类name / url / location / operator 四字段就是你在应用里看到的服务器卡片。第三步把 Vivi-Music 指向私有服务器服务器跑起来后接入只需 4 步打开Settings → Integrations → Listen Together点击Server URL条目会弹出服务器选择对话框内置节点列表 自定义输入框在Custom server输入框填入你的地址格式必须是wss://your-domain.com点击Use custom server返回后创建或加入房间顶部状态显示Connected即接入成功。 排查技巧若状态卡在 Connecting 或频繁 Reconnecting打开View logs看连接日志错误级别条目会直接指出握手失败原因常见是证书无效或端口未放行 443。实用技巧与常见问题后台会被断开官方提示创建房间时若没在放音乐就切到别的 App或连上服务器后 15 分钟空闲不加入房间可能被服务端断开文案见 vivi_strings.xml。建议先播放再建房。房间码规则8 位字母数字自动转大写分享时用消息或通知转发即可想随便进房主勾选自动批准即可适合熟人房间对外公开房间则建议手动审批 拉黑管理想接管房间房主退出或主动TransferHost后其他成员可成为新房主。写在最后Vivi-Music 的 Listen Together 把和朋友一起听歌这件浪漫的事做到了可自建、可掌控的程度界面沉浸、协议开放、服务器自由。先体验内置公共节点熟悉房间码与审批流程后再按上文三步搭建自己的私有同步服务器就能拥有完全属于你们小圈子的线上音乐厅。【免费下载链接】vivi-musicVivi-Music is an expressive Material 3–based YouTube Music client for Android.项目地址: https://gitcode.com/gh_mirrors/vi/vivi-music创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Vivi-Music Listen Together同步听歌：私有服务器搭建完整攻略与沉浸式界面详解
Vivi-Music Listen Together同步听歌私有服务器搭建完整攻略与沉浸式界面详解【免费下载链接】vivi-musicVivi-Music is an expressive Material 3–based YouTube Music client for Android.项目地址: https://gitcode.com/gh_mirrors/vi/vivi-musicVivi-Music 是一款基于 Material 3 的 Android 端 YouTube Music 客户端其Listen Together 同步听歌功能让你和朋友在同一房间里实时收听同一首歌进度、曲目、音量全程同步还能创建房间、分享房间码、互提歌曲。本文详解这套功能的沉浸式界面并给出私有服务器搭建的完整思路与接入步骤。什么是 Listen Together 同步听歌简单来说你创建一个房间把 8 位数的房间码发给朋友大家连入后所有设备播放同一首歌、同一个进度。它不是各自播放而是真正的实时同步播放——主人Host播放什么客人Guest就听到什么连音量都会跟随主人调整。核心机制一览角色能力房主 Host创建房间、批准/拒绝加入、踢人、转移房主、接收点歌客人 Guest输入房间码加入、同步收听、向房主推荐歌曲服务器中转状态与消息支持公共节点或自建私有节点整套功能入口位于 ListenTogetherScreen.kt配置界面在 ListenTogetherSettings.kt。沉浸式界面详解房间里的每个细节房间界面的设计非常Material 3值得关注的亮点身份系统为每人大小的头像库可选人物插画风格配合用户名展示在房间成员列表加入请求队列朋友申请加入时会弹出提示房主可逐一审批也可开启自动批准Auto-approve让朋友直接进入点歌机制客人看到想听的歌可以推荐给房主房主批准后进入播放队列——对应协议里的SuggestTrackPayload消息音量同步开启 Sync host volume 后客人的音量跟随房主适合一起调大音量的聚会场景智能重同步Smart resync网络抖动或切后台后客户端会智能校准进度而不是从头重播连接日志设置页内置View logs面板带 INFO/WARNING/ERROR 分级标签出问题时一键复制全部日志拉黑功能Blocked Users 列表可直接管理被拉黑的用户。界面文案与提示语集中在 vivi_strings.xml例如房间创建提示Room created、加入被拒原因等都来自这里。私有服务器搭建完整攻略第一步理解通信协议关键Listen Together 客户端通过WebSocketwss://连接同步服务器消息体采用 Protobuf 编码统一包裹在Envelope结构里含type、payload、compressed三个字段。完整协议契约就写在仓库里协议定义listentogether.proto客户端实现ListenTogetherClient.kt你只需读懂这几个核心消息就能实现自己的服务器消息用途CreateRoomPayload/JoinRoomPayload创建房间 / 凭房间码加入RoomState房间快照成员、当前曲目、进度、音量、队列SyncStatePayload播放状态同步播放/暂停/seek 后广播JoinRequestPayload/ApproveJoinPayload加入审批流程ReconnectPayloadsession_token断线后用会话令牌恢复身份TransferHostPayload/KickUserPayload房主管理第二步搭建你的 WebSocket 节点自建服务器的最小要求清单部署一个支持 wss:// 的 WebSocket 服务任何语言均可Node.js、Python 等能解析/生成 Protobuf 的Envelope消息维护房间状态按room_code存储RoomState有新事件换歌、暂停、进度、音量、成员变化就广播给房间内所有连接审批逻辑收到JoinRoomPayload时先向房主推送JoinRequestPayload等待ApproveJoinPayload或RejectJoinPayload回复若房主开启自动批准则直接放行会话保持为每个成员签发session_token断线重连时凭令牌恢复房间身份避免被踢出门HTTPS/WSS 证书移动端只接受安全的wss://地址建议用 Lets Encrypt 之类的证书。公共节点的配置可参考 ListenTogetherServers.kt其中ListenTogetherServer数据类name / url / location / operator 四字段就是你在应用里看到的服务器卡片。第三步把 Vivi-Music 指向私有服务器服务器跑起来后接入只需 4 步打开Settings → Integrations → Listen Together点击Server URL条目会弹出服务器选择对话框内置节点列表 自定义输入框在Custom server输入框填入你的地址格式必须是wss://your-domain.com点击Use custom server返回后创建或加入房间顶部状态显示Connected即接入成功。 排查技巧若状态卡在 Connecting 或频繁 Reconnecting打开View logs看连接日志错误级别条目会直接指出握手失败原因常见是证书无效或端口未放行 443。实用技巧与常见问题后台会被断开官方提示创建房间时若没在放音乐就切到别的 App或连上服务器后 15 分钟空闲不加入房间可能被服务端断开文案见 vivi_strings.xml。建议先播放再建房。房间码规则8 位字母数字自动转大写分享时用消息或通知转发即可想随便进房主勾选自动批准即可适合熟人房间对外公开房间则建议手动审批 拉黑管理想接管房间房主退出或主动TransferHost后其他成员可成为新房主。写在最后Vivi-Music 的 Listen Together 把和朋友一起听歌这件浪漫的事做到了可自建、可掌控的程度界面沉浸、协议开放、服务器自由。先体验内置公共节点熟悉房间码与审批流程后再按上文三步搭建自己的私有同步服务器就能拥有完全属于你们小圈子的线上音乐厅。【免费下载链接】vivi-musicVivi-Music is an expressive Material 3–based YouTube Music client for Android.项目地址: https://gitcode.com/gh_mirrors/vi/vivi-music创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考