## 功能特性 - 🎧 **共享音频流**：所有用户通过 `/stream/live.mp3` 同步收听，一个流无限听众 - 📋 **协作队列**：任何人可添加曲目、实时拖拽排序 - ▶️ **多源播放**：支持 YouTube、SoundCloud、Mixcloud、直连 URL 和本地文件 - 🎵 **Spotify 导入**：导入 Spotify 播放列表，自动匹配 YouTube/SoundCloud 可播放源 - 📚 **播放列表管理**：创建、导入、合并、去重、后台自动同步 - 💿 **本地文件**：浏览并播放服务器端音频文件（通过 `AIRWAVE_LOCAL_MEDIA_ROOTS` 配置） - 🎮 **播放器体验**：播放/暂停/跳过/重复/快进、全屏 Now Playing、锁屏控制 | 限制项 | 说明 | 影响范围 | 排查建议 | | Play Local 首次点击需等 5-8 秒才出声 | 浏览器 `<audio>` 元素连接到 `/stream/live.mp3` 无限 HTTP 流时，需要内置缓冲足够的 MP3 帧才能开始解码播放。**此为浏览器标准行为，不在服务端或反向代理控制范围内**。manifest 已配置 `X-Accel-Buffering: no` 禁用代理层缓冲，进一步优化空间已无 | Play Local 播放 | 属正常行为。部署参数中 `mp3_bitrate` 已默认 `128k`（比特率越低缓冲越快）。快进/暂停后需等数秒音频才跟上；Stop Local 后可能有 1-2 秒残留声音 | ### 在线播放测试（需要结合小猪佩奇一起使用） | 1 | 在顶部搜索栏粘贴 YouTube 链接，点击绿色 **Search** 按钮 | `https://www.youtube.com/watch?v=dQw4w9WgXcQ` | 识别到信息，显示曲目标题和来源 | | 2 | 点击搜索结果中的曲目 | — | 曲目出现在右侧 **Queue** 面板中 | | 3 | 等待播放开始 | — | 底部播放器显示曲目名称、播放进度条和时间 | > 💡 **底部三个按钮说明**： > - **Stream**：链接到服务器共享音频流的直链（`/stream/live.mp3`），点击可在新标签页中直接收听，也可复制链接给外部播放器使用 > - **Play Local**：让当前浏览器接入共享音频流并开始播放，你会在本设备上听到实时音频 > - **Stop Local**：停止当前浏览器的音频播放（不影响服务器端的共享流和其他听众） ### 本地音乐播放 （已挂载到懒猫网盘下music文件夹，如无，请对应创建） | 1 | 通过懒猫网盘上传音乐 | 任意 MP3 文件上传到 `music`文件夹 | 文件上传成功 | | 2 | 在主界面右上角点击📁进入 Media Browser | — | 显示 Media Browser 页面，导航显示 `Roots` | | 3 | 依次点击目录进入 ` music` | — | 看到文件夹和 MP3 文件的网格视图（可勾选 **Queue、Play now、Add to playlist **） | | 4 | 点击 MP3 文件添加到队列 | — | 曲目出现在右侧 Queue，底部播放器开始播放并显示曲目名称 | ### 设置与 Cookie 配置 > 💡 **Cookie 的作用**：Airwave 通过 yt-dlp 解析音频时，会自动携带对应平台的 Cookie。配置 Cookie 后可以： > - **YouTube Cookie**：绕过年龄验证、访问私有/未上市视频、浏览你的个人播放列表（Browse playlists 中 YouTube 分类）、避免 bot 验证码 > - **SoundCloud Cookie**：访问 Go+ 专属曲目、私有歌单、你收藏的内容 > - **MixCloud Cookie**：访问 Select 订阅内容、私有 mix、个人收藏 > 📥 **Cookie 获取方式**： > 1. 在浏览器中登录对应平台（YouTube/SoundCloud/MixCloud） > 2. 安装浏览器扩展 [Get cookies.txt LOCALLY](https://chromewebstore.google.com/detail/get-cookiestxt-locally/cclelndahbckbenkjhflpdbgdldlbecc)（Chrome/Edge）或同类扩展 > 3. 在对应平台页面点击扩展图标，导出为 **Netscape 格式** > 4. 将导出的文本内容粘贴到 Airwave Settings → Cookies → 对应平台的输入框中，点击 **Save**