# 音乐开放平台接入方案备忘录

> 最后更新：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*
