listen1 中文文档 下载 App

点击播放按钮后歌曲没有任何反应

问题描述

搜索或歌单里点击歌曲,播放按钮亮了一下但没有声音,控制条时间不走,或者直接报错。

排查步骤(按顺序试,每步失败再试下一个)

步骤一:检查网络

最常见的原因。Listen 1 需要同时访问七个音乐平台的服务器:

  1. 浏览器打开 listen1.github.io/listen1 测试基础网络
  2. 分别打开网易云 music.163.com、QQ 音乐 y.qq.com 看能否正常加载
  3. 如果某一个平台打不开,说明该平台被墙或运营商劫持,切换到能访问的平台标签播放

步骤二:手动切换播放源

当前源失效了,Listen 1 的自动切换可能没触发:

  1. 点击进度条右侧的播放源切换按钮(如果有的话)
  2. 或直接在其他平台标签页重新搜索同一首歌
  3. 找到能播放的版本,点击播放

步骤三:检查是否登录过期

登录的平台 token 过期后,搜索接口可能正常但播放接口会返回错误:

  1. 进入「我的音乐」→ 平台登录区域
  2. 查看网易云 / QQ / 咪咕是否显示「未登录」或需要重新授权
  3. 重新登录后再试

步骤四:重启 Listen 1

Electron 桌面版偶尔会出现 Web Audio 引擎卡死的问题:

  1. 完全关闭 Listen 1(任务管理器确认进程结束)
  2. 重新打开应用
  3. 重新点击歌曲播放

步骤五:升级到最新版本

旧版本可能不兼容平台最新的播放接口:

  1. 去 GitHub Release 页面查看当前最新版本号
  2. 对比你安装的版本(设置 → 关于里能看到)
  3. 下载最新版本覆盖解压(桌面版)或重新加载扩展(插件版)

步骤六:浏览器插件版专用

如果是 Chrome / Firefox 插件版:

  1. 进入 chrome://extensions/ 确认插件在启用状态
  2. 尝试在 Listen 1 插件窗口内按 F12 打开调试控制台,看有没有红色错误
  3. 清除插件数据后重新加载(chrome://extensions/ → 插件详情 → 「清除扩展程序数据」)

步骤七:换播放器验证

如果所有尝试都失败,基本可以确定是该歌曲在所有平台的播放源都失效了(版权下架),不是 Listen 1 的问题。