264 lines
10 KiB
Markdown
264 lines
10 KiB
Markdown
# 音乐开放平台接入方案备忘录
|
||
|
||
> 最后更新：2026-05-08 | 用途：U-Desk 生态链接 — 音乐模块可行性评估
|
||
|
||
---
|
||
|
||
## 一、平台总览对比
|
||
|
||
| 维度 | QQ音乐 | 网易云音乐 | 酷狗音乐 | Spotify | Apple Music |
|
||
|------|--------|-----------|----------|---------|-------------|
|
||
| **官网** | [developer.y.qq.com](https://developer.y.qq.com/) | [developer.music.163.com](https://developer.music.163.com/) | [open.kugou.com](https://open.kugou.com/) | [developer.spotify.com](https://developer.spotify.com/documentation/web-api/) | [Apple MusicKit](https://developer.apple.com/documentation/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 桌面端支持概率极低：
|
||
1. **第一优先级应调整为 Spotify Web API**（Web Playback SDK 可在 Wails WebView2 运行）
|
||
2. QQ 音乐降为"长期跟进"（定期重试官网看是否新增 Windows 支持）
|
||
3. 网易云音乐保持"实验性/个人版"定位不变
|
||
|
||
---
|
||
|
||
## 三、网易云音乐（技术可行但灰色地带）
|
||
|
||
### 基本信息
|
||
- **官网**：https://developer.music.163.com/
|
||
- **实际可用API**：[NeteaseCloudMusicApi](https://binaryify.github.io/NeteaseCloudMusicApi/)（社区维护，GitHub Star 30k+）
|
||
|
||
### 核心能力（150+ 接口）
|
||
|
||
| 模块 | 主要接口 |
|
||
|------|---------|
|
||
| 登录鉴权 | 登录/刷新/手机验证码/注册/退出 |
|
||
| 用户信息 | 用户详情/歌单/关注/粉丝/动态/播放记录 |
|
||
| 搜索 | 搜单曲/专辑/歌手/歌单/MV/歌词/电台/用户 |
|
||
| 歌曲 | 详情/歌词/评论/相似/喜欢/打卡 |
|
||
| 歌单 | 精品歌单/详情/分类/推荐/每日推荐 |
|
||
| 专辑 | 内容/评论/新碟上架/最新 |
|
||
| 歌手 | 热门/单曲/MV/专辑/描述/相似/榜单 |
|
||
| MV/视频 | 最新/推荐/排行/播放/相似/收藏/评论 |
|
||
| 排行榜 | 所有榜单及内容摘要 |
|
||
| 电台/DJ | 推荐/分类/订阅/详情/节目 |
|
||
| 个性化 | 私人FM/每日推荐/推荐新音乐/独家放送 |
|
||
| 社交互动 | 评论/动态/转发/分享/关注 |
|
||
| 云盘 | 上传/详情/删除 |
|
||
|
||
### 优势
|
||
- API 能力极其丰富，几乎覆盖所有功能
|
||
- 社区活跃，多语言客户端（Python/Java/Go）
|
||
- 免费使用，无需预充值
|
||
- 曲库规模大，独立音乐人内容丰富
|
||
- 个性化推荐算法优秀
|
||
|
||
### 劣势（致命问题）
|
||
- **非官方逆向工程 API**，存在法律合规风险
|
||
- 无官方 SLA 保障，接口随时可能变更失效
|
||
- 需要用户账号 Cookie/Token 登录
|
||
- 存在频率限制，过频请求会被临时封禁
|
||
- **不适合正式商业产品发布**
|
||
|
||
### 适用场景
|
||
个人工具 / 内部使用 / 原型验证 — **不可作为正式功能上线**
|
||
|
||
---
|
||
|
||
## 四、酷狗音乐（不推荐）
|
||
|
||
### 基本信息
|
||
- **官网**：https://open.kugou.com/
|
||
- **曲库开放计划**：https://open.kugou.com/docs/open-player/
|
||
|
||
### 两条产品线
|
||
|
||
| 产品线 | 说明 |
|
||
|--------|------|
|
||
| 曲库开放组件（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 桌面端支持确认结果：
|
||
|
||
1. [ ] 发送咨询邮件至 qmopen@tencent.com
|
||
2. [ ] 注册 QQ 音乐开发者账号
|
||
3. [ ] 创建应用，获取 AppID/AppKey
|
||
4. [ ] 选择接入方式（OpenAPI 或 SDK）
|
||
5. [ ] 配置回调域名/URL Scheme
|
||
6. [ ] 集成登录授权流程
|
||
7. [ ] 对接核心 API（搜索/播放/歌词）
|
||
8. [ ] 提交应用审核
|
||
9. [ ] 接入播放流水上报
|
||
10. [ ] 上线发布
|
||
|
||
---
|
||
|
||
*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*
|