10 KiB
10 KiB
音乐开放平台接入方案备忘录
最后更新：2026-05-08 | 用途：U-Desk 生态链接 — 音乐模块可行性评估
一、平台总览对比
| 维度 | QQ音乐 | 网易云音乐 | 酷狗音乐 | Spotify | Apple Music |
|---|---|---|---|---|---|
| 官网 | developer.y.qq.com | developer.music.163.com | open.kugou.com | developer.spotify.com | Apple MusicKit |
| 官方性质 | 官方 | 非官方(社区逆向) | 官方 | 官方 | 官方 |
| 曲库规模 | 海量正版（业内估计亿级，待文档中心登录确认） | 数亿首 | 4000万+ | 1亿+ | 1亿+ |
| 费用 | 未公开(需商务) | 免费(非商用) | 按千次播放计费 | 免费额度/按量 | 免费(Apple Developer) |
| Windows桌面支持 | ❌ 确认不支持（2026-05-08 核实） | HTTP调用可用 | ❌ 仅Android/iOS | Web Playback SDK | MusicKit JS |
| 中文歌曲覆盖 | 极全 | 极全(含小众) | 全 | 中等 | 中等 |
| 中国区可用性 | 原生 | 原生 | 原生 | 需翻墙 | 受限 |
| 推荐评级 | ⭐⭐⭐ 待确认 | ⭐⭐ 灰色地带 | ⭐ 不适配 | ⭐⭐⭐ 技术可行 | ⭐⭐ 有限 |
二、QQ音乐开发者平台（首选候选）
基本信息
- 官网：https://developer.y.qq.com/
- 文档中心：https://developer.y.qq.com/docs/openapi
- 联系邮箱：qmopen@tencent.com
- 版权归属：腾讯公司
核心能力（三大服务模块）
1. 登录授权 (Login Auth)
- 基于腾讯社交账号体系（微信/QQ/QQ音乐APP）
- QPlay Auth 授权方式
- 授权后可获取音乐流、播放控制、在线音乐服务、个人权益
2. OpenAPI
- 在线听歌、排行榜、热门歌曲
- OpenId 用户标识
- 歌词、MV/视频（"音视听资源"）
- 文档子分类：登录鉴权、SDK、OpenAPI、APP互联、QPlay
3. QPlay 协议
- QPlay Auth（授权认证）
- QPlay Cloud（云端服务）
- QPlay Lan（局域网协议）
- QPlay IPC（进程间通信）
支持终端类型（6类）
| 终端 | 支持 |
|---|---|
| 移动应用 (iOS/Android) | ✅ |
| 网站/小程序 | ✅ |
| 智能硬件 | ✅ |
| 车载应用 | ✅ |
| 公播盒子 | ✅ |
| Windows桌面EXE | ❓ 未明确列出 |
行业解决方案
社交行业、直播行业、TV/大屏、智能车载、公播行业 — 均有定制方案
费用模式
- 未公开透明，需商务对接获取报价
- 通常为按调用量计费或预付授权金模式
关键风险（2026-05-08 深入核实后更新）
Windows桌面端确认不支持。官网明确列出 6 类终端（移动应用/网站小程序/智能硬件/车载应用/公播盒子/大屏解决方案），无一可映射到 Windows 桌面端 EXE。QPlay 协议描述的"软件应用"在终端列表中被具体化为"移动应用"和"网站/小程序"，无 Windows 入口。
评估结论：可能性低（接近零）
- QQ 音乐开发者平台面向腾讯生态内典型场景（移动App/小程序/IoT/车载）
- Windows 桌面端不在目标覆盖范围
- 申请接入时很可能被拒绝或无法通过审核
- 但仍建议发邮件
qmopen@tencent.com正式询问（预期负面，但留档备查）
备选方案优先级调整
由于 QQ 音乐 Windows 桌面端支持概率极低：
- 第一优先级应调整为 Spotify Web API（Web Playback SDK 可在 Wails WebView2 运行）
- QQ 音乐降为"长期跟进"（定期重试官网看是否新增 Windows 支持）
- 网易云音乐保持"实验性/个人版"定位不变
三、网易云音乐（技术可行但灰色地带）
基本信息
- 官网：https://developer.music.163.com/
- 实际可用API：NeteaseCloudMusicApi（社区维护，GitHub Star 30k+）
核心能力（150+ 接口）
| 模块 | 主要接口 |
|---|---|
| 登录鉴权 | 登录/刷新/手机验证码/注册/退出 |
| 用户信息 | 用户详情/歌单/关注/粉丝/动态/播放记录 |
| 搜索 | 搜单曲/专辑/歌手/歌单/MV/歌词/电台/用户 |
| 歌曲 | 详情/歌词/评论/相似/喜欢/打卡 |
| 歌单 | 精品歌单/详情/分类/推荐/每日推荐 |
| 专辑 | 内容/评论/新碟上架/最新 |
| 歌手 | 热门/单曲/MV/专辑/描述/相似/榜单 |
| MV/视频 | 最新/推荐/排行/播放/相似/收藏/评论 |
| 排行榜 | 所有榜单及内容摘要 |
| 电台/DJ | 推荐/分类/订阅/详情/节目 |
| 个性化 | 私人FM/每日推荐/推荐新音乐/独家放送 |
| 社交互动 | 评论/动态/转发/分享/关注 |
| 云盘 | 上传/详情/删除 |
优势
- API 能力极其丰富，几乎覆盖所有功能
- 社区活跃，多语言客户端（Python/Java/Go）
- 免费使用，无需预充值
- 曲库规模大，独立音乐人内容丰富
- 个性化推荐算法优秀
劣势（致命问题）
- 非官方逆向工程 API，存在法律合规风险
- 无官方 SLA 保障，接口随时可能变更失效
- 需要用户账号 Cookie/Token 登录
- 存在频率限制，过频请求会被临时封禁
- 不适合正式商业产品发布
适用场景
个人工具 / 内部使用 / 原型验证 — 不可作为正式功能上线
四、酷狗音乐（不推荐）
基本信息
两条产品线
| 产品线 | 说明 |
|---|---|
| 曲库开放组件（SDK） | 千万级正版曲库，仅在线流媒体播放 |
| 酷狗小程序 | 4000万曲库，仅在酷狗APP内运行 |
费用模式
- 按千次有效播放计费
- 预充值模式，随充随用
- 小程序免费（但只能在酷狗APP内）
致命缺陷
- SDK 仅支持 Android + iOS，无 Windows 版本
- 无 H5/Web 版本
- 无自定义 UI（纯后台播放组件）
- 必须标注"酷狗提供技术支持"
- 需要企业资质申请
结论：完全不适用于 U-Desk
五、Spotify Web API（国际备选）
基本信息
- 文档：https://developer.spotify.com/documentation/web-api/
- 基础地址：https://api.spotify.com
- 认证方式：OAuth 2.0（Spotify Accounts Service）
核心能力
- 搜索艺术家/专辑/曲目/播放列表
- 获取曲目元数据（名称、时长、封面、音频特性）
- 用户相关数据（播放列表、已保存音乐）
- 分页查询、条件请求缓存（ETag）
费用
- 免费层级：有速率限制
- 应用审核后可获得更高配额
U-Desk 适配分析
- Web Playback SDK 可在浏览器环境运行 → Wails WebView2 兼容
- RESTful JSON API → Go 后端可直接调用
- 但中国区需要翻墙，且中文曲库覆盖一般
推荐作为：英文/国际化音乐的补充方案（非主力）
六、Apple MusicKit
基本信息
- 文档：https://developer.apple.com/documentation/musickit
- MusicKit JS：可在网页中嵌入 Apple Music 播放器
能力
- 搜索/浏览 Apple Music 曲库
- 播放控制（需用户 Apple Music 订阅）
- 元数据获取（封面、歌词等）
限制
- 需要 Apple Developer 账号（$99/年）
- 中国区 Apple Music 曲库受限
- 用户需要有有效的 Apple Music 订阅才能播放完整曲目
结论：不纳入本次实施范围（成本高 $99/年 + 中国区曲库受限）
七、合规硬性规则
| 规则 | 说明 |
|---|---|
| 禁止爬虫 | 不得通过爬虫抓取音频文件 |
| 禁止解密 | 不得解密 DRM 保护的内容 |
| 禁止本地缓存 | 不得将音乐文件缓存在本地 |
| 用户授权 | 必须使用用户自己的账号登录，借用其会员权益播放 |
| 如实上报 | 必须按接口要求上报播放流水（用于平台与版权方结算） |
| 版权标注 | 必须标注版权归对应平台及版权方所有 |
八、最终推荐方案（2026-05-08 更新）
第一优先级：Spotify Web API（调整为首选）
- 理由：免费 + 文档完善 + Web Playback SDK 可在 Wails WebView2 运行（QQ音乐 Windows 支持概率极低）
- 用途：主力音乐接入（国际+通过代理可访问中文内容）
- 限制：需翻墙、中文曲库有限
第二优先级：QQ音乐开放平台（降为"长期跟进"）
- 理由：正版授权 + 曲库全 + 腾讯生态 — 但 Windows 桌面端确认不支持
- 状态：定期（月度）重试官网看是否新增 Windows 终端类型
- 前置条件：发邮件
qmopen@tencent.com获得书面回复确认后才可启动开发 - 风险评估：高（大概率被拒或无回复）
第三优先级：网易云音乐（实验性不变）
- 理由：功能最丰富、开发最快
- 用途：个人版/内测版本验证产品形态
- 红线：正式版必须替换为官方合规方案
明确舍弃
酷狗音乐— 不支持桌面端Apple MusicKit— 成本高、中国区差QQ 音乐（作为 MVP 首选）— Windows 桌面端不支持，从 P0 降为长期跟进
九、快速上手清单（待确认后补充）
以下步骤依赖 QQ 音乐平台的 Windows 桌面端支持确认结果：
- 发送咨询邮件至 qmopen@tencent.com
- 注册 QQ 音乐开发者账号
- 创建应用，获取 AppID/AppKey
- 选择接入方式（OpenAPI 或 SDK）
- 配置回调域名/URL Scheme
- 集成登录授权流程
- 对接核心 API（搜索/播放/歌词）
- 提交应用审核
- 接入播放流水上报
- 上线发布
Sources:
- QQ音乐开发者平台: https://developer.y.qq.com/
- NeteaseCloudMusicApi: https://binaryify.github.io/NeteaseCloudMusicApi/
- 酷狗开放平台: https://open.kugou.com/
- Spotify Web API: https://developer.spotify.com/documentation/web-api/
- Apple MusicKit: https://developer.apple.com/documentation/musickit