新增: SFTP直连+网站预览+OSS区域嗅探+热键+BGM播放
This commit is contained in:
263
docs/04-功能迭代/生态链接/01-音乐平台.md
Normal file
263
docs/04-功能迭代/生态链接/01-音乐平台.md
Normal file
@@ -0,0 +1,263 @@
|
||||
# 音乐开放平台接入方案备忘录
|
||||
|
||||
> 最后更新: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*
|
||||
335
docs/04-功能迭代/生态链接/02-视频平台.md
Normal file
335
docs/04-功能迭代/生态链接/02-视频平台.md
Normal file
@@ -0,0 +1,335 @@
|
||||
# 视频平台开放API接入方案备忘录
|
||||
|
||||
> 最后更新:2026-05-08 | 用途:U-Desk 生态链接 — 视频模块可行性评估
|
||||
|
||||
---
|
||||
|
||||
## 一、平台总览对比
|
||||
|
||||
| 维度 | 哔哩哔哩 | **抖音开放平台** | 腾讯视频 | 爱奇艺 | 优酷 | YouTube IFrame |
|
||||
|------|---------|------------|---------|--------|------|----------------|
|
||||
| **官网** | [developer.bilibili.com](https://developer.bilibili.com/) | [open.douyin.com](https://open.douyin.com/) | [open.tencent.com](https://open.tencent.com/) | 开放程度有限 | 开放程度有限 | [developers.google.com/youtube](https://developers.google.com/youtube) |
|
||||
| **官方开放平台** | ✅ 有 | ✅ **有(完善)** | ✅ 有 | ⚠️ 有限 | ⚠️ 有限 | ✅ IFrame API |
|
||||
| **核心能力** | 搜索/播放/弹幕/投屏 | **分享/授权/小程序/支付/数据** | 播放SDK | 嵌入播放 | 嵌入播放 | 嵌入播放/数据API |
|
||||
| **费用** | 需申请确认 | **免费** | 商务合作 | 不明 | 不明 | 免费 |
|
||||
| **Windows桌面适配** | 待确认(官网500) | **SDK / H5** | SDK/H5 | H5嵌入 | H5嵌入 | WebView2完美 |
|
||||
| **中文内容** | 极全 | **极全(日活8亿+)** | 极全 | 全 | 全 | 中等 |
|
||||
| **推荐评级** | ⭐⭐⭐ 待确认 | **⭐⭐⭐ 国内首选** | ⭐⭐ | ⭐⭐ | ⭐⭐ | ⭐⭐⭐ 技术可行 |
|
||||
|
||||
---
|
||||
|
||||
## 二、抖音开放平台(国内首选 ⭐⭐⭐)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://open.douyin.com/
|
||||
- **归属**:字节跳动 / 抖音
|
||||
- **资质**:增值电信业务经营许可证 川B2-20220549
|
||||
- **客服电话**:400-140-2108
|
||||
- **状态**:**活跃维护中(2026年3月仍有更新日志)**
|
||||
|
||||
### 开放形态(5种载体)
|
||||
| 载体 | 说明 | U-Desk 适配 |
|
||||
|------|------|-------------|
|
||||
| **抖音开放能力 SDK** | 分享/授权/投稿/名片/数据能力 | ✅ **核心接入方式** |
|
||||
| **抖音小程序** | 在抖音内运行的小程序 | 可选(需抖音内分发) |
|
||||
| **抖音小游戏** | 游戏类小程序 | 不适用 |
|
||||
| **直播小玩法** | 直播互动工具 | 不适用 |
|
||||
| **网站应用** | H5 网页应用 | 备选 |
|
||||
|
||||
### 核心能力(SDK 详细)
|
||||
|
||||
#### 分享能力
|
||||
| 能力 | 说明 |
|
||||
|------|------|
|
||||
| **分享到私信** | 从第三方 App 指定链接分享至抖音 IM(含私聊/群聊),生成消息卡片 |
|
||||
| **分享到朋友日常** | 转发非本人创作内容至"朋友"Tab 社交分发 |
|
||||
| **投稿到抖音** | 从第三方 App 直接发布视频到抖音 |
|
||||
|
||||
#### 授权与身份
|
||||
| 能力 | 说明 |
|
||||
|------|------|
|
||||
| **抖音授权** | OAuth 式用户授权登录 |
|
||||
| **抖音名片** | 展示用户在抖音的身份信息 |
|
||||
|
||||
#### 数据能力
|
||||
| 能力 | 说明 |
|
||||
|------|------|
|
||||
| **数据 API** | 获取分享数据、播放量等统计 |
|
||||
| **搜索服务直达** | 从抖音搜索直达第三方服务 |
|
||||
|
||||
### 行业解决方案
|
||||
| 方向 | 核心能力 |
|
||||
|------|---------|
|
||||
| **通用行业** | 搜索直达 / 短视频达人推广 / 短视频挂载 / 直播挂载 |
|
||||
| **生活服务** | 餐饮团购 / 酒店景区 / 到综服务(线上购买+线下履约) |
|
||||
| **交易能力** | 线上支付 / 结算分账 |
|
||||
|
||||
### 接入流程
|
||||
```
|
||||
01 注册/入驻 → 02 选择业务生态 → 03 开发调试 → 04 经营业务
|
||||
```
|
||||
|
||||
### 费用模式
|
||||
- **免费接入**(基础 SDK 能力)
|
||||
- 交易场景涉及支付结算时按规则分成
|
||||
- 无月费/年费
|
||||
|
||||
### U-Desk 集成方案
|
||||
```
|
||||
U-Desk + 抖音 SDK
|
||||
├── 视频分享 → 选中视频文件 → 一键分享到抖音
|
||||
├── 投稿发布 → 编辑好的视频 → 直接发布到抖音
|
||||
├── 用户授权 → OAuth 登录(可选,用于同步抖音身份)
|
||||
└── 数据回流 → 抖音播放/互动数据回传 U-Desk 统计
|
||||
```
|
||||
|
||||
### 为什么是"国内首选"
|
||||
1. **日活 8 亿+** — 国内最大短视频平台,远超 B站
|
||||
2. **完善的开放平台** — 官网活跃、文档齐全、SDK 成熟
|
||||
3. **免费接入** — 无门槛,个人开发者友好
|
||||
4. **Windows 桌面支持** — SDK 支持 H5/网站应用形态
|
||||
5. **生态完整** — 分享/投稿/授权/支付/数据全链路
|
||||
6. **与文件管理器天然契合** — 视频文件管理 → 分享/投稿一键触达
|
||||
|
||||
### 与 YouTube IFrame 的分工
|
||||
| 场景 | 选抖音 | 选 YouTube |
|
||||
|------|--------|-----------|
|
||||
| 分享视频到社交平台 | ✅ 抖音(国内8亿用户) | ❌ |
|
||||
| 发布/投稿视频 | ✅ 抖音(直接发布) | ❌ |
|
||||
| 在 U-Desk 内播放视频 | ❌ | ✅ YouTube(IFrame 嵌入) |
|
||||
| 国际内容消费 | ❌ | ✅ YouTube |
|
||||
| 搜索国际视频元数据 | ❌ | ✅ YouTube Data API |
|
||||
|
||||
---
|
||||
|
||||
## 三、哔哩哔哩开放平台(⚠️ 已确认不可用)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://developer.bilibili.com/
|
||||
- **状态**:**❌ 持续不可达**(2026-05-08 多次验证:connection refused)
|
||||
- **法律状态**:**⚠️ 非官方 API 文档已被律师函强制关停**(见下方证据)
|
||||
|
||||
### ⚠️ 法律风险升级(2026-05-08 核实)
|
||||
> **B站最大 GitHub API 文档仓库 `SocialSisterYi/bilibili-API-collect` 已于 2026-01-28 收到 B 委托律师事务所发律师函警告邮件,维护者随即停止维护并删除相关文档及源代码。**
|
||||
|
||||
这意味着:
|
||||
- 文档中此前列出的"已知能力"(搜索API/视频播放/弹幕/用户信息/投屏/数据统计等)**全部来自已被法律关停的非官方逆向工程**
|
||||
- **无法作为合法接入依据**
|
||||
- 使用此类 API 的商用产品面临法律风险
|
||||
|
||||
### 可行方案(仅限轻量场景)
|
||||
| 方案 | 可行性 | 风险 |
|
||||
|------|--------|------|
|
||||
| iframe 嵌入 B站视频播放页 | ✅ 技术可行 | 低(官方分享嵌入通常允许) |
|
||||
| 非官方 API(自部署 NeteaseCloudMusicApi) | ✅ 技术可行 | **高(法律风险,已发生律师函先例)** |
|
||||
| 官方 OpenAPI | ❌ | 平台不可达 + 无公开文档 |
|
||||
|
||||
### 最终评估
|
||||
- **作为 API 数据源**:❌ **不可用**(平台不可达 + 非官方文档已关停)
|
||||
- **作为 iframe 嵌入**:⭐ 可行但功能有限(仅播放,无搜索/推荐/个性化)
|
||||
- **推荐评级从 "待确认" 降为 D(不可用)**
|
||||
- **搜索API**:搜视频/番剧/影视/直播/用户
|
||||
- **视频播放**:支持嵌入播放器(iframe)
|
||||
- **弹幕系统**:发送/获取弹幕
|
||||
- **用户信息**:关注/粉丝/动态
|
||||
- **投屏协议**:DLNA/Cast
|
||||
- **数据统计**:播放量/点赞/投币/收藏
|
||||
|
||||
### 接入方式(推测)
|
||||
| 方式 | 说明 |
|
||||
|------|------|
|
||||
| iframe 嵌入 | 最简单,直接嵌入视频播放页 |
|
||||
| OpenAPI | RESTful 接口,需申请 AppKey |
|
||||
| SDK | 可能有桌面端 SDK(待确认) |
|
||||
|
||||
### U-Desk 适配路径
|
||||
1. **轻量方案**:WebView2 iframe 嵌入 B站视频 → 最快实现
|
||||
2. **深度方案**:对接 OpenAPI → 搜索+自定义播放器UI
|
||||
|
||||
### 费用
|
||||
- 个人开发者通常有免费额度
|
||||
- 商用需联系商务
|
||||
|
||||
### 下一步
|
||||
- 等 B站开发者平台恢复后查看完整文档
|
||||
- 备选:直接使用 iframe 嵌入方案(无需API)
|
||||
|
||||
---
|
||||
|
||||
## 四、腾讯视频开放平台(⚠️ 需区分两条路径)
|
||||
|
||||
### 基本信息
|
||||
- **C端产品**:https://v.qq.com/ (腾讯视频消费者端)
|
||||
- **B端云服务**:https://cloud.tencent.com/product/vod (腾讯云点播 VOD)
|
||||
- **开放平台**:https://open.tencent.com/ (存在,主要覆盖应用宝/微信/QQ)
|
||||
|
||||
### ⚠️ 关键区分(2026-05-08 核实)
|
||||
|
||||
| 路径 | 说明 | U-Desk 适配 |
|
||||
|------|------|-------------|
|
||||
| **A. 腾讯云点播 VOD** | B端云服务:上传/管理/播放**自己的视频内容** | 如果 U-Desk 要做"用户上传视频→云端转码→分发播放",可用此 API |
|
||||
| **B. 腾讯视频内容接入** | 在 U-Desk 中嵌入播放腾讯视频的**自有内容** | ❌ **无官方 API**。v.qq.com 无开发者页面(返回404) |
|
||||
|
||||
### 腾讯云 VOD 能力(路径 A,如需要)
|
||||
- 完整的媒资上传/转码/处理/分发 API
|
||||
- 控制台 + SDK(但主要是移动端/服务器端)
|
||||
- 计费:按存储量 + 转码时长 + CDN 流量
|
||||
|
||||
### 结论
|
||||
- 文档此前写的"可能通过腾讯云点播 VOD"是**方向正确但场景需澄清**
|
||||
- **如果目标是"在 U-Desk 里看腾讯视频"**:只能 H5 嵌入(无官方 API)
|
||||
- **如果目标是"U-Desk 做视频托管平台"**:腾讯云 VOD 有完善 API 可用
|
||||
- 对 U-Desk 当前定位(文件管理器 + 生态入口),**腾讯视频价值有限**,优先级低于抖音和 YouTube
|
||||
|
||||
---
|
||||
|
||||
## 五、爱奇艺 / 优酷
|
||||
|
||||
### 共同特点
|
||||
- 开放程度有限,主要以 **H5 嵌入** 或 **合作接入** 为主
|
||||
- 无完善的公开开发者 API 文档
|
||||
- 更倾向于大客户商务合作模式
|
||||
|
||||
### 可行方案
|
||||
- **iframe 嵌入**:直接在 WebView2 中加载视频页面
|
||||
- 作为"快捷链接"功能而非深度集成
|
||||
- 合规风险较低(官方提供的分享嵌入代码)
|
||||
|
||||
---
|
||||
|
||||
## 六、YouTube IFrame API(国际内容补充)
|
||||
|
||||
### 基本信息
|
||||
- **文档**:https://developers.google.com/youtube/iframe_api_reference
|
||||
- **Player API**:完整的播放控制 JavaScript API
|
||||
- **Data API v3**:搜索/获取视频元数据(需要 API Key)
|
||||
|
||||
### 核心能力
|
||||
```javascript
|
||||
// IFrame API 示例 — 完美兼容 Wails WebView2
|
||||
var player;
|
||||
function onYouTubeIframeAPIReady() {
|
||||
player = new YT.Player('player', {
|
||||
height: '360',
|
||||
width: '640',
|
||||
videoId: 'M7lc1UVf-VE',
|
||||
events: {
|
||||
'onReady': onPlayerReady,
|
||||
'onStateChange': onPlayerStateChange
|
||||
}
|
||||
});
|
||||
}
|
||||
```
|
||||
|
||||
- 播放/暂停/停止/音量/seek
|
||||
- 播放状态事件监听
|
||||
- 播放列表/队列管理
|
||||
- 全屏控制
|
||||
|
||||
### 费用
|
||||
- **IFrame Player API**:完全免费,无需 API Key
|
||||
- **Data API v3**:免费额度 10,000 units/day
|
||||
|
||||
### U-Desk 适配
|
||||
- **完美适配**:纯前端 JS API,WebView2 原生运行
|
||||
- Go 后端可选调用 Data API 补充搜索能力
|
||||
- 中国区需翻墙
|
||||
|
||||
### 推荐用途
|
||||
- 国际视频内容补充
|
||||
- 技术验证的首选平台(零成本、文档完善)
|
||||
|
||||
---
|
||||
|
||||
## 七、Vimeo Player API
|
||||
|
||||
### 基本信息
|
||||
- **文档**:https://developer.vimeo.com/api/reference
|
||||
- **嵌入式播放器**:高度可定制
|
||||
|
||||
### 能力
|
||||
- 嵌入式播放器(类似 YouTube)
|
||||
- Player JS API(播放控制)
|
||||
- Upload API(上传视频)
|
||||
- Data API(视频信息获取)
|
||||
|
||||
### 费用
|
||||
- 免费层级可用(有播放限制)
|
||||
- Pro 版本 ($7/月) 解锁高级功能
|
||||
|
||||
### 特点
|
||||
- 无广告、画质高
|
||||
- 设计感强,适合高端场景
|
||||
- 中文内容较少
|
||||
|
||||
---
|
||||
|
||||
## 八、合规要点
|
||||
|
||||
| 规则 | 说明 |
|
||||
|------|------|
|
||||
| 嵌入播放 | 使用平台官方提供的嵌入代码/播放器,不自行解析视频流 |
|
||||
| 广告保留 | 不得去除原平台的广告或会员提示 |
|
||||
| 内容审核 | 平台对内容负责,但需注意嵌入内容的合规性 |
|
||||
| 版权标注 | 视频版权归创作者及平台所有 |
|
||||
| 流量上报 | 如有要求,按规范上报播放数据 |
|
||||
|
||||
> **关键原则**:视频模块优先采用 **H5/iframe 嵌入** 方案,而非自建播放器解析流地址。这样既合规又简单。
|
||||
|
||||
---
|
||||
|
||||
## 九、最终推荐方案
|
||||
|
||||
### MVP 阶段(快速上线)
|
||||
|
||||
| 优先级 | 方案 | 工作量 | 说明 |
|
||||
|--------|------|--------|------|
|
||||
| P0 | **抖音开放 SDK** | 1-2天 | 国内首选:分享/投稿/授权 |
|
||||
| P0 | **YouTube IFrame API** | 0.5天 | 国际视频 + 嵌入播放 |
|
||||
| P1 | **B站 iframe 嵌入** | 0.5天 | 国内二次元/长视频社区 |
|
||||
|
||||
### 迭代阶段(深度集成)
|
||||
|
||||
| 优先级 | 方案 | 工作量 | 说明 |
|
||||
|--------|------|--------|------|
|
||||
| P1 | B站 OpenAPI 对接 | 3-5天 | 搜索/推荐/个性化(需等官网恢复) |
|
||||
| P1 | 抖音数据能力对接 | 2-3天 | 播放量/互动数据回传统计 |
|
||||
| P2 | 腾讯视频 H5 嵌入 | 0.5天 | 补充国内长视频 |
|
||||
| P2 | Vimeo API | 2-3天 | 高端无广告体验 |
|
||||
|
||||
### 明确舍弃
|
||||
- ~~爱奇艺/优酷深度API~~ — 开放程度不足
|
||||
- ~~自建视频流解析~~ — 合规风险极高
|
||||
|
||||
---
|
||||
|
||||
## 十、U-Desk 视频模块架构建议
|
||||
|
||||
```
|
||||
U-Desk 生态链接 - 视频模块
|
||||
├── VideoPlayer (Vue Component)
|
||||
│ ├── YouTubePlayer.vue → YT.Iframe API
|
||||
│ ├── BilibiliEmbed.vue → iframe embed
|
||||
│ ├── TencentVideo.vue → H5 embed
|
||||
│ └── GenericPlayer.vue → 统一播放器外壳
|
||||
│
|
||||
├── VideoService (Go)
|
||||
│ ├── SearchYouTube() → YouTube Data API (可选)
|
||||
│ ├── SearchBilibili() → B站 OpenAPI (后续)
|
||||
│ └── SearchLocal() → 本地视频文件索引
|
||||
│
|
||||
└── VideoPanel.vue → 主面板 (搜索 + 列表 + 播放)
|
||||
```
|
||||
|
||||
### 与文件管理器的融合点
|
||||
- 在文件浏览时识别视频文件 → 提供在线搜索相似内容
|
||||
- 右键菜单:"在线搜索相关视频"
|
||||
- 底部栏迷你播放器(浏览文件时同时看视频)
|
||||
- 收藏夹同步(收藏的视频与文件收藏统一管理)
|
||||
|
||||
---
|
||||
|
||||
*Sources:*
|
||||
- *B站开放平台: https://developer.bilibili.com/*
|
||||
- *YouTube IFrame API: https://developers.google.com/youtube/iframe_api_reference*
|
||||
- *Vimeo Developer: https://developer.vimeo.com/api/reference*
|
||||
335
docs/04-功能迭代/生态链接/03-广播电台.md
Normal file
335
docs/04-功能迭代/生态链接/03-广播电台.md
Normal file
@@ -0,0 +1,335 @@
|
||||
# 广播电台 / 电视 / 播客 开放平台接入方案备忘录
|
||||
|
||||
> 最后更新:2026-05-08 | 用途:U-Desk 生态链接 — 音频流媒体模块可行性评估
|
||||
|
||||
---
|
||||
|
||||
## 一、平台总览对比
|
||||
|
||||
| 平台 | 类型 | 费用 | 中文内容 | 桌面端适配 | 合规性 | 接入难度 | 评级 |
|
||||
|------|------|------|----------|------------|--------|----------|------|
|
||||
| **Radio Browser API** | 国际电台 | 免费 | 中 | 极高(RESTful) | 高 | 极低 | **A** |
|
||||
| **Apple iTunes Search API** | 播客索引 | 免费 | 高 | 极高(HTTP) | 高 | 低 | **A-** |
|
||||
| **喜马拉雅开放平台** | 国内音频 | 商务合作 | 极高 | 中低(Web嵌入) | 高 | 高 | B- |
|
||||
| **蜻蜓FM开放平台** | 国内音频 | 商务合作 | 极高 | 低 | 高 | 高 | C+ |
|
||||
| **CCTV 嵌入** | 电视 | 不定 | 极高 | 中 | 中风险 | 中 | C- |
|
||||
| **TuneIn API** | 国际电台 | 不开放 | 低 | 无 | - | - | D |
|
||||
| **荔枝FM / 云听** | 国内音频 | 无API | 高 | 无 | - | - | D |
|
||||
| **IPTV/电视直播** | 电视 | 无合法方案 | 极高 | 无 | - | - | D |
|
||||
|
||||
---
|
||||
|
||||
## 二、Radio Browser API(强烈推荐 ⭐⭐⭐)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://www.radio-browser.info
|
||||
- **API 地址**:https://api.radio-browser.info
|
||||
- **协议**:开源项目(GitLab),可自由用于免费和商业软件
|
||||
- **版本**:v0.7.44(2026-05-08 验证:API 在线,`/json/stats` 端点可能已迁移,但核心 station 接口正常)
|
||||
- **当前规模**:27,000+ 可用电台 / 80+ 国家 / 59+ 语言
|
||||
- **验证状态**:✅ **已验证在线** — `de1.api.radio-browser.info/json/stations/topclick` 返回实时数据(2026-05-08 15:26 UTC)
|
||||
|
||||
### 核心能力
|
||||
|
||||
#### 列表类接口
|
||||
| 接口 | 说明 |
|
||||
|------|------|
|
||||
| `/json/countries` | 按国家列出电台 |
|
||||
| `/json/codecs` | 编码格式列表 (MP3/AAC+/OGG) |
|
||||
| `/json/states` | 按州/省列出 |
|
||||
| `/json/languages` | 语言列表 (含 ISO 639 代码) |
|
||||
| `/json/tags` | 标签/流派列表 (jazz/pop/rock/news) |
|
||||
| `/json/stations` | 全部电台列表 |
|
||||
|
||||
#### 搜索类接口
|
||||
| 接口 | 说明 |
|
||||
|------|------|
|
||||
| `/json/stations/search` | **高级搜索**:name/country/language/tag/codec/bitrate/geo 多维度组合查询 |
|
||||
| `/json/stations/byname/{term}` | 按名称搜索 |
|
||||
| `/json/stations/bycountry/{code}` | 按国家搜索 (`CN`=中国) |
|
||||
| `/json/stations/bylanguage/{lang}` | 按语言搜索 (`chinese`) |
|
||||
| `/json/stations/bytag/{tag}` | 按标签搜索 |
|
||||
|
||||
#### 排行类接口
|
||||
| 接口 | 说明 |
|
||||
|------|------|
|
||||
| `/json/stations/topclick` | 最热门电台 |
|
||||
| `/json/stations/topvote` | 最高评分电台 |
|
||||
| `/json/stations/lastclick` | 最近被点击的 |
|
||||
|
||||
#### 交互类接口
|
||||
| 接口 | 说明 |
|
||||
|------|------|
|
||||
| `/json/url/{uuid}` | 点击计数 + 获取播放 URL |
|
||||
| `/json/vote/{uuid}` | 为电台投票 |
|
||||
| `/json/add` | 添加新电台到数据库 |
|
||||
|
||||
#### 运维类接口
|
||||
| 接口 | 说明 |
|
||||
|------|------|
|
||||
| `/json/stats` | 服务器统计 |
|
||||
| `/json/servers` | 镜像服务器列表(可自建) |
|
||||
| `/json/config` | 服务器配置 |
|
||||
|
||||
### 数据结构关键字段
|
||||
```json
|
||||
{
|
||||
"stationuuid": "唯一ID",
|
||||
"name": "电台名称",
|
||||
"url": "原始流地址",
|
||||
"url_resolved": "已解析的直接播放URL ← 核心字段",
|
||||
"homepage": "电台主页",
|
||||
"favicon": "图标",
|
||||
"tags": ["标签"],
|
||||
"countrycode": "CN",
|
||||
"language": "chinese",
|
||||
"codec": "MP3",
|
||||
"bitrate": 128,
|
||||
"lastcheckok": true,
|
||||
"clickcount": 24小时点击量
|
||||
}
|
||||
```
|
||||
|
||||
### 输出格式
|
||||
JSON / XML / CSV / M3U / PLS / XSPF / TTL(7种!)
|
||||
|
||||
### U-Desk 集成方式
|
||||
```
|
||||
Go 后端 → HTTP GET radio-browser API → JSON → Vue 展示电台列表
|
||||
↓ 点击播放
|
||||
url_resolved 字段 = 直接可播放的 MP3/AAC 流
|
||||
```
|
||||
|
||||
- **Go 有现成库**:`goradios`
|
||||
- **零成本、零审核、零依赖**
|
||||
- 工作量估算:2-3天(含 UI)
|
||||
|
||||
### 特别优势
|
||||
- 支持按 `countrycode=CN` 筛选中文电台
|
||||
- 用户可添加自定义电台(`/json/add`)
|
||||
- 可自建镜像服务器(完全自主可控)
|
||||
- 支持 M3U/PLS 导出(兼容各类播放器)
|
||||
|
||||
---
|
||||
|
||||
## 三、Apple iTunes Search API — 播客发现(推荐 ⭐⭐⭐)
|
||||
|
||||
### 基本信息
|
||||
- **文档**:https://affiliate.itunes.apple.com/resources/documentation/itunes-store-web-service-search-api/ (⚠️ 国内访问可能超时,需翻墙;API 端点本身通常可达)
|
||||
- **API 端点**:`https://itunes.apple.com/search` 和 `https://itunes.apple.com/lookup`
|
||||
- **费用**:免费(速率限制约 20次/分钟)
|
||||
|
||||
### 核心能力
|
||||
|
||||
#### 搜索参数
|
||||
| 参数 | 说明 | 示例 |
|
||||
|------|------|------|
|
||||
| `term` | 搜索关键词 | `news`, `故事`, `科技` |
|
||||
| `media` | 媒体类型 | `podcast` |
|
||||
| `entity` | 实体类型 | `podcast`, `podcastAuthor` |
|
||||
| `country` | 国家代码 | `cn` |
|
||||
| `limit` | 返回数量 | 25 |
|
||||
|
||||
#### 使用示例
|
||||
```
|
||||
# 搜索中文新闻播客
|
||||
GET https://itunes.apple.com/search?term=news&country=cn&media=podcast&limit=25
|
||||
|
||||
# 搜索特定作者
|
||||
GET https://itunes.apple.com/search?term=故事&entity=podcastAuthor&country=cn
|
||||
```
|
||||
|
||||
#### 返回数据关键字段
|
||||
```json
|
||||
{
|
||||
"collectionName": "播客名称",
|
||||
"artistName": "作者",
|
||||
"feedUrl": "RSS订阅地址 ← 核心:获取音频的入口",
|
||||
"artworkUrl60": "小封面",
|
||||
"artworkUrl100": "大封面",
|
||||
"releaseDate": "发布日期",
|
||||
"primaryGenreName": "分类"
|
||||
}
|
||||
```
|
||||
|
||||
### 播放流程
|
||||
```
|
||||
iTunes Search API → 获取 feedUrl (RSS)
|
||||
↓
|
||||
解析 RSS XML → 提取 episode 列表
|
||||
↓
|
||||
enclosure URL → 音频播放
|
||||
```
|
||||
|
||||
### U-Desk 集成方式
|
||||
1. Go 后端调用 Search API → 获取播客列表和 RSS 地址
|
||||
2. 解析 RSS XML 提取 episode 音频 URL
|
||||
3. 前端播放器播放音频流
|
||||
4. 实现 20次/分钟速率限制的客户端缓存
|
||||
|
||||
### 中文播客覆盖
|
||||
- iTunes Podcast 目录包含大量中文播客(大陆/台湾/香港创作者)
|
||||
- 覆盖新闻/故事/科技/商业/教育等各领域
|
||||
|
||||
### 工作量估算:3-4天(含 RSS 解析逻辑)
|
||||
|
||||
---
|
||||
|
||||
## 四、喜马拉雅开放平台(备选 ⭐⭐)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://open.ximalaya.com/
|
||||
- **定位**:国内最大音频分享平台(纽交所上市)
|
||||
- **商务热线**:(021)50179077-8806 / -8803
|
||||
|
||||
### 核心能力
|
||||
- 音频内容分发 SDK/API
|
||||
- 支持移动应用、智能硬件、车载、网页/小程序接入
|
||||
- 内容类型:有声书、课程、播客、相声评书、新闻资讯、亲子儿童、景点导览
|
||||
- AI 制作专区
|
||||
|
||||
### 接入方式
|
||||
| 方式 | 说明 |
|
||||
|------|------|
|
||||
| 移动应用 SDK | Android/iOS/Flutter |
|
||||
| 智能硬件 SDK | IoT 设备 |
|
||||
| **网页/小程序 JS SDK** | ← U-Desk 的可行路径 |
|
||||
|
||||
### 费用模式
|
||||
- **商务合作模式**,需"立即入驻"申请后商谈
|
||||
- 通常为分成或流量付费模式
|
||||
- 有运营中心(内容中心/数据中心/活动中心)
|
||||
|
||||
### U-Desk 适配路径
|
||||
通过 Wails WebView 加载喜马拉雅 H5/JS SDK 播放器
|
||||
- 技术层面工作量:1-2天
|
||||
- 商务层面周期不确定(需审批)
|
||||
|
||||
### 注意事项
|
||||
- 开发者文档页面部分返回 404,生态维护程度一般
|
||||
- 但"网页/小程序"接入通道确实存在
|
||||
|
||||
---
|
||||
|
||||
## 五、蜻蜓FM开放平台(低优先级)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://open.qingting.fm
|
||||
- 能力:SDK/API/H5嵌入式播放器
|
||||
- 内容:直播流、点播、有声书、相声评书、全国电台
|
||||
|
||||
### 问题
|
||||
- 主要面向 B 端大客户(车企、智能硬件厂商)
|
||||
- 对独立桌面应用开发者门槛较高
|
||||
- 文档需入驻后才可查看完整内容
|
||||
- Windows 桌面端无原生支持
|
||||
|
||||
### 结论:优先级低于喜马拉雅
|
||||
|
||||
---
|
||||
|
||||
## 六、电视/IPTV(当前不可行)
|
||||
|
||||
### CCTV 央视网
|
||||
- **无公开开发者 API**
|
||||
- 可能存在 iframe 嵌入方案(灰色地带)
|
||||
- 版权严格管控,合规风险高
|
||||
- 评级:C-(仅作为外部链接实验)
|
||||
|
||||
### 各省市 IPTV
|
||||
- 三大运营商分别运营,无统一 API
|
||||
- 专有传输协议(IGMP/RTP/RTSP),需专用机顶盒
|
||||
- **完全不存在合法的桌面端接入途径**
|
||||
- 评级:D
|
||||
|
||||
### EPG 数据源(国际参考)
|
||||
- [epg-guide.com](https://epg-guide.com):免费 EPG 数据,XMLTV 格式
|
||||
- 仅覆盖欧洲(意大利为主),不支持中文电视台
|
||||
- 技术成熟但无中文内容,参考价值有限
|
||||
|
||||
### 结论:**电视模块暂不纳入 MVP**
|
||||
|
||||
---
|
||||
|
||||
## 七、荔枝FM / 云听
|
||||
|
||||
| 平台 | 状态 | 原因 |
|
||||
|------|------|------|
|
||||
| 荔枝FM (lizhi.fm) | ❌ 无公开 API | 官网无 developer/open 入口 |
|
||||
| 云听 (yunting.fm) | ❌ 服务不稳定 | 访问时 500 错误,且无 API |
|
||||
|
||||
---
|
||||
|
||||
## 八、最终推荐组合方案
|
||||
|
||||
### 第一优先级(MVP 即可上线)
|
||||
|
||||
| 平台 | 用途 | 工作量 | 成本 |
|
||||
|------|------|--------|------|
|
||||
| **Radio Browser API** | 全球网络电台收听 | 2-3天 | 免费 |
|
||||
| **iTunes Search API** | 播客发现与播放 | 3-4天 | 免费 |
|
||||
|
||||
### 第二优先级(后续迭代)
|
||||
|
||||
| 平台 | 用途 | 工作量 | 前置条件 |
|
||||
|------|------|--------|----------|
|
||||
| **喜马拉雅 Web 嵌入** | 国内有声书/课程 | 1-2天技术 + 商务周期 | 商务合作审批 |
|
||||
| **央视网链接** | 电视直播快捷入口 | 0.5天 | 关注版权政策 |
|
||||
|
||||
### 不推荐
|
||||
- ~~TuneIn~~ — 不开放第三方 API
|
||||
- ~~IPTV/电视直播~~ — 无合法接入途径
|
||||
- ~~荔枝FM/云听~~ — 无可用 API
|
||||
|
||||
---
|
||||
|
||||
## 九、U-Desk 广播/播客模块架构建议
|
||||
|
||||
```
|
||||
U-Desk 生态链接 - 音频流媒体模块
|
||||
├── RadioService (Go)
|
||||
│ ├── StationSearch() → Radio Browser /stations/search
|
||||
│ ├── TopStations() → /stations/topclick
|
||||
│ ├── StationsByCountry() → /stations/bycountry/CN
|
||||
│ ├── StationsByTag() → /stations/bytag/{tag}
|
||||
│ └── PlayStation() → /json/url/{uuid} → url_resolved 直播流
|
||||
│
|
||||
├── PodcastService (Go)
|
||||
│ ├── SearchPodcasts() → iTunes Search API (media=podcast)
|
||||
│ ├── GetPodcastDetail() → iTunes Lookup API
|
||||
│ ├── ParseFeed() → RSS XML → episode 列表
|
||||
│ └── PlayEpisode() → enclosure URL → 音频播放
|
||||
│
|
||||
├── AudioPlayer (Vue Component)
|
||||
│ ├── RadioPanel.vue → 电台浏览/搜索/播放/收藏
|
||||
│ ├── PodcastPanel.vue → 播客发现/订阅/播放/下载
|
||||
│ └── MiniPlayer.vue -> 底部栏迷你播放器
|
||||
│
|
||||
└── QuickLinks (Vue)
|
||||
└── LinkCard.vue → 央视网/喜马拉雅等外部链接卡片
|
||||
```
|
||||
|
||||
### 与文件管理器的融合点
|
||||
- 浏览文件时底部迷你播放器持续播放电台/播客
|
||||
- 收藏夹统一管理(收藏的电台/播客/文件混合展示)
|
||||
- 右键菜单:"搜索相关播客内容"
|
||||
|
||||
---
|
||||
|
||||
## 十、合规要点总结
|
||||
|
||||
| 平台 | 合规要求 |
|
||||
|------|---------|
|
||||
| Radio Browser | 开源协议友好,商用无限制,仅需合理 User-Agent |
|
||||
| iTunes API | 遵守 Apple 使用条款(速率限制 + 展示要求) |
|
||||
| 喜马拉雅 | 必须走正式商务流程,签订合作协议 |
|
||||
| 央视网 | 以外部链接方式最安全,避免深度集成 |
|
||||
|
||||
---
|
||||
|
||||
*Sources:*
|
||||
- *Radio Browser: https://www.radio-browser.info / https://api.radio-browser.info*
|
||||
- *iTunes Search API: https://affiliate.itunes.apple.com/resources/documentation/itunes-store-web-service-search-api/*
|
||||
- *喜马拉雅开放平台: https://open.ximalaya.com/*
|
||||
- *蜻蜓FM开放平台: https://open.qingting.fm*
|
||||
- *EPG Guide: https://epg-guide.com*
|
||||
295
docs/04-功能迭代/生态链接/04-课程专栏.md
Normal file
295
docs/04-功能迭代/生态链接/04-课程专栏.md
Normal file
@@ -0,0 +1,295 @@
|
||||
# 课程专栏 / 知识付费 开放平台接入方案备忘录
|
||||
|
||||
> 最后更新:2026-05-08 | 用途:U-Desk 生态链接 — 知识学习模块可行性评估
|
||||
|
||||
---
|
||||
|
||||
## 一、平台总览对比
|
||||
|
||||
| 平台 | 类型 | 官方API | 费用 | 桌面端适配 | 中文内容 | 推荐评级 |
|
||||
|------|------|---------|------|------------|----------|---------|
|
||||
| **喜马拉雅** | 有声书/课程 | ✅ SDK+API | 商务合作 | Web嵌入 | 极全 | **A-** |
|
||||
| **得到 (Dedao)** | 知识付费 | ❌ 已确认无API | - | 仅WebView嵌入 | 全 | **C+** |
|
||||
| **知乎 / 盐选** | 问答/专栏 | ⚠️ 有限 | 部分免费 | Web抓取 | 全 | **B** |
|
||||
| **豆瓣** | 读书/影视数据 | ⚠️ 非官方(社区维护) | 免费 | HTTP调用 | 高 | **B+** |
|
||||
| **微信读书** | 电子书阅读 | ❌ 无公开API | - | - | 极全 | C |
|
||||
| **Apple Books / iTunes** | 电子书/播客 | ✅ Search API | 免费 | HTTP调用 | 中 | **B+** |
|
||||
| **Udemy** | 在线课程 | ✅ REST API | 免费(aff) | HTTP调用 | 低(英文) | B |
|
||||
| **Coursera** | 在线课程 | ✅ API | 免费 | HTTP调用 | 低(英文) | B |
|
||||
| **中国大学MOOC** | 高等教育 | ⚠️ 有限 | 免费 | Web | 高 | B- |
|
||||
| **即刻时间** | 知识碎片 | ❌ 无公开API | - | - | 中 | D |
|
||||
| **知识星球** | 社群/知识 | ❌ 无公开API | - | - | 中 | D |
|
||||
|
||||
---
|
||||
|
||||
## 二、喜马拉雅(首选 ⭐⭐⭐)
|
||||
|
||||
### 基本信息
|
||||
- **开放平台**:https://open.ximalaya.com/
|
||||
- **定位**:国内最大音频分享平台(纽交所上市:XIMA)
|
||||
- **商务热线**:(021)50179077 转 8806 或 8803
|
||||
|
||||
### 核心能力(与 U-Desk 课程场景高度匹配)
|
||||
| 内容类型 | 说明 |
|
||||
|---------|------|
|
||||
| **有声书** | 出版物音频化,海量书籍资源 |
|
||||
| **课程/专栏** | 知识付费核心品类 |
|
||||
| **播客** | UGC/PUGC 音频内容 |
|
||||
| **新闻资讯** | 实时资讯音频版 |
|
||||
| **亲子儿童** | 儿童故事/教育内容 |
|
||||
| **相声评书** | 传统曲艺内容 |
|
||||
| **景点导览** | 旅游场景音频导览 |
|
||||
|
||||
### 接入方式
|
||||
| 方式 | 平台支持 | U-Desk 可行性 |
|
||||
|------|---------|---------------|
|
||||
| 移动应用 SDK | Android/iOS/Flutter | ❌ 不适用 |
|
||||
| 智能硬件 SDK | IoT 设备 | ❌ 不适用 |
|
||||
| **网页/小程序 JS SDK** | H5/Web 环境 | ✅ **Wails WebView2 可用** |
|
||||
|
||||
### 费用模式
|
||||
- **商务合作**,需申请入驻后商谈
|
||||
- 通常为分成模式或流量采购
|
||||
- 有完整的运营中心(内容中心/数据中心/活动中心)
|
||||
|
||||
### U-Desk 集成路径
|
||||
```
|
||||
喜马拉雅 JS SDK → Wails WebView2 加载 → 课程浏览/搜索/播放
|
||||
```
|
||||
- 技术工作量:1-2天
|
||||
- 商务周期不确定,需提前启动
|
||||
|
||||
### 与广播电台模块的协同
|
||||
- 喜马拉雅同时覆盖"课程"和"广播"两个模块
|
||||
- 可作为统一音频内容入口
|
||||
|
||||
---
|
||||
|
||||
## 三、得到 Dedao(已确认无开放API ❌)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://www.dedao.cn/
|
||||
- **定位**:高端知识服务平台(罗辑思维团队)
|
||||
- **内容品质**:国内顶尖,每门课程均经过严格品控
|
||||
|
||||
### 平台规模(2026年实测数据)
|
||||
| 维度 | 数据 |
|
||||
|------|------|
|
||||
| 平台用户 | **6400 万+** |
|
||||
| 精品课程 | **390 门**(覆盖 20+ 领域) |
|
||||
| 电子书 | **10 万+ 本**(含 1300+ 经典套系、800+ 期刊杂志) |
|
||||
| 得到听书 | **3400+ 本**,每天上新 1 本 |
|
||||
| 线下学习中心 | **10 个**(北京/上海/杭州/广州/深圳/成都/西安/昆明/武汉/郑州) |
|
||||
| 2024 用户学习时长 | **18 亿小时+** |
|
||||
| 2024 用户笔记 | **60 亿字+** |
|
||||
| 企业客户 | 上千家企业 |
|
||||
|
||||
### 核心产品矩阵
|
||||
| 产品 | 说明 |
|
||||
|------|------|
|
||||
| **精品课** | 系统化课程(如薛兆丰经济学课、吴军科技史纲60讲) |
|
||||
| **每天听本书** | 专业解读,3400+ 本书 |
|
||||
| **得到听书** | 名家讲书 / 精品听书 / 章鱼书场 等 |
|
||||
| **电子书** | 10万本,支持全文搜索 + 多设备同步 |
|
||||
| **免费专区** | 得到头条 / 文明之旅 / 长谈 / 得到精选等 |
|
||||
| **得到新商学** | 创业者社区,12场线下大课/年 |
|
||||
| **直播** | 定期直播(改稿/对谈/颁奖等) |
|
||||
|
||||
### 热门讲师(部分)
|
||||
薛兆丰(经济学)、香帅(金融学)、吴军(计算机科学)、万维钢(科学)、刘擎(哲学)、刘润(商业)、吴伯凡(商业思想)、尹烨(健康)、蔡钰(批判性思维)、马江博(政经)...
|
||||
|
||||
### 开放平台/API 状态:**❌ 无任何公开 API**
|
||||
- 官网无 developer/open/api 入口
|
||||
- 无 SDK / 无文档 / 无开发者计划
|
||||
- **结论:得到是封闭生态,不对外开放数据或能力**
|
||||
|
||||
### 可行的接入路径(有限)
|
||||
| 方案 | 可行性 | 说明 |
|
||||
|------|--------|------|
|
||||
| WebView2 嵌入 Web 版 | ⭐⭐ 技术可行 | 可加载得到网页版,但无法获取结构化数据 |
|
||||
| RSS / 内容抓取 | ⭐ 合规风险 | 违反服务条款,不可商用 |
|
||||
| 商务合作 | ⭐⭐ 待洽谈 | 面向企业客户的定制化解决方案(B端培训集成) |
|
||||
|
||||
### 最终评估
|
||||
- **作为 API 数据源**:❌ 不可行(无开放接口)
|
||||
- **作为 WebView 嵌入**:⭐⭐ 可行但价值有限(不如直接用 App)
|
||||
- **作为竞品参考**:⭐⭐⭐ 极有价值(产品设计/内容分类/用户体验值得学习)
|
||||
- **推荐评级从 B+ 降为 C+**(无 API = 无法深度集成)
|
||||
|
||||
> **替代建议**:如果需要高品质中文课程内容,优先选择 **喜马拉雅**(有 JS SDK 可接入)或 **iTunes Search API**(免费播客/有声书元数据)。得到的优质内容建议引导用户通过 App 使用。
|
||||
|
||||
---
|
||||
|
||||
## 四、豆瓣(⚠️ 已确认无可用 API,降级为嵌入方案)
|
||||
|
||||
### 基本信息
|
||||
- **原豆瓣 API v2 社区仓库**:https://github.com/douban/douban-api-v2 → **❌ 404(仓库已删除/改名)**
|
||||
- **豆瓣官方客户端库**:https://github.com/douban/douban-client → **❌ 已归档(Archived),最后更新 2014-06-22**
|
||||
- **官方状态**:**豆瓣已完全停止公开 API 服务**。官方 OAuth 客户端库于 2014 年归档,社区维护的 v2 兼容接口仓库也已下线
|
||||
|
||||
### 核心能力(历史参考 — 当前均不可用)
|
||||
| 接口 | 说明 | 状态 |
|
||||
|------|------|------|
|
||||
| 图书搜索/详情 | ISBN/书名/作者搜索,含评分/简介/封面 | ❌ 接口已失效 |
|
||||
| 电影搜索/详情 | 影片信息/评分/演员/导演 | ❌ 接口已失效 |
|
||||
| 读书笔记 | 用户的读书标记和短评 | ❌ 接口已失效 |
|
||||
| 书单/豆列 | 用户创建的书籍列表 | ❌ 接口已失效 |
|
||||
|
||||
### U-Desk 可行方案(降级后)
|
||||
- **WebView2 嵌入**:加载豆瓣网页版(book.douban.com / movie.douban.com),用户手动浏览
|
||||
- **右键快捷方式**:选中 PDF/电子书文件 → 右键"在豆瓣搜索" → 打开豆瓣网页搜索该 ISBN/书名
|
||||
- **元数据层**:❌ 不可行(无可用 API 获取结构化数据)
|
||||
|
||||
### 费用:N/A(无可用的 API 服务)
|
||||
|
||||
### 评级调整:从 B+ 降至 **C+**
|
||||
> **理由**:作为结构化数据源已完全不可用。仅能作为 WebView 嵌入/外部链接的跳板,价值大幅降低。
|
||||
|
||||
---
|
||||
|
||||
## 五、知乎 / 知乎盐选
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://www.zhihu.com/
|
||||
- **盐选会员**:https://www.zhihu.com/xuan
|
||||
|
||||
### 能力评估
|
||||
- **无完善的公开开发者 API**
|
||||
- 存在一些非官方的爬虫式接口(不推荐商用)
|
||||
- 网页版可在 WebView2 中加载
|
||||
|
||||
### 可行方案
|
||||
- **轻量集成**:WebView2 嵌入知乎专栏页面
|
||||
- 作为"快捷链接"而非深度集成
|
||||
- 合规风险较低(官方提供的分享链接)
|
||||
|
||||
### 内容价值
|
||||
- 国内最优质的问答/专栏内容库
|
||||
- 盐选付费内容涵盖大量系统化课程
|
||||
- 与"课程专栏"模块定位契合
|
||||
|
||||
---
|
||||
|
||||
## 六、微信读书(✅ 已确认完全封闭)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://weread.qq.com/
|
||||
- **定位**:腾讯旗下电子书阅读平台
|
||||
- **内容规模**:极全(出版书籍 + 网文 + 漫画)
|
||||
- **状态**:**✅ 已确认完全封闭,无任何公开开发者入口**
|
||||
|
||||
### 封闭证据(2026-05-08 核实)
|
||||
| 路径 | 响应 | 含义 |
|
||||
|------|------|------|
|
||||
| `weread.qq.com/api` | 404 | 无公开 API 入口 |
|
||||
| `weread.qq.com/developer` | 404 | 无开发者平台 |
|
||||
| `weread.qq.com/open` | 404 | 无开放入口 |
|
||||
| **`i.weread.qq.com/`** | **401 Unauthorized** | ⚠️ **证实内部 API 存在但需认证,不对外开放** |
|
||||
|
||||
### 结论
|
||||
- 公开 API:**无**
|
||||
- 开放平台:**无**
|
||||
- 内部接口:存在(`i.weread.qq.com` 返回 401 = 需登录态认证)→ **确认不对外**
|
||||
- 唯一可行方案:WebView2 嵌入 Web 版或外部快捷链接
|
||||
- **评级维持 C(合理)** — 与得到一致,都是腾讯系封闭内容生态
|
||||
|
||||
---
|
||||
|
||||
## 七、国际平台补充
|
||||
|
||||
### Apple iTunes Search API(已在上篇详述)
|
||||
- 搜索 Audiobooks / Podcasts / 教育类内容
|
||||
- 免费使用,20次/分钟限制
|
||||
- 返回 RSS Feed URL 用于内容获取
|
||||
|
||||
### Udemy
|
||||
- **Developer API**:https://www.udemy.com/developers/affiliate/
|
||||
- **类型**:Affiliate API(联盟营销)
|
||||
- 能力:课程搜索/详情/分类
|
||||
- 费用:免费(通过推广获得佣金)
|
||||
- 限制:主要英文内容,中文课程有限
|
||||
|
||||
### Coursera
|
||||
- **API**:https://build.coursera.org/
|
||||
- 能力:课程目录/详情/学习者进度
|
||||
- 主要面向机构合作
|
||||
- 个人开发者可获取基础课程数据
|
||||
|
||||
### 中国大学 MOOC(icourse163)
|
||||
- **官网**:https://www.icourse163.org/
|
||||
- 国内最大的高等教育在线课程平台
|
||||
- 无公开 API,可通过 Web 抓取部分数据
|
||||
- 内容质量高(来自北大/清华等名校)
|
||||
|
||||
---
|
||||
|
||||
## 八、明确不可行的平台
|
||||
|
||||
| 平台 | 原因 |
|
||||
|------|------|
|
||||
| 即刻时间 | 无公开 API,产品形态偏碎片化 |
|
||||
| 知识星球 | 无公开 API,定位为私密社群 |
|
||||
| 荔枝微课 | 未找到稳定的开放接口 |
|
||||
| 千聊 | 主要面向知识创作者工具端 |
|
||||
|
||||
---
|
||||
|
||||
## 九、最终推荐方案
|
||||
|
||||
### MVP 阶段
|
||||
|
||||
| 优先级 | 平台 | 用途 | 工作量 |
|
||||
|--------|------|------|--------|
|
||||
| P0 | **喜马拉雅 JS SDK** | 有声书 + 课程 + 播客一体化 | 1-2天技术 + 商务周期 |
|
||||
| P1 | **iTunes Search API** | 国际有声书/播客补充 | 1天 |
|
||||
| P2 | **豆瓣 WebView 嵌入** (⚠️已无API) | 右键跳转豆瓣网页搜索 | 0.5天(极轻量) |
|
||||
|
||||
### 迭代阶段
|
||||
|
||||
| 优先级 | 平台 | 用途 | 前置条件 |
|
||||
|--------|------|------|----------|
|
||||
| P1 | **知乎嵌入** | 专栏/问答快捷入口 | 无 |
|
||||
| P2 | **Udemy Affiliate** | 英文课程补充 | 申请联盟账号 |
|
||||
|
||||
### 明确舍弃
|
||||
- ~~得到~~ — **已确认无任何开放 API**,封闭生态(6400万用户/390门课/10万本电子书均无法通过 API 获取)
|
||||
|
||||
---
|
||||
|
||||
## 十、U-Desk 课程/知识模块架构建议
|
||||
|
||||
```
|
||||
U-Desk 生态链接 - 知识学习模块
|
||||
├── KnowledgeService (Go)
|
||||
│ ├── SearchBooks() → 豆瓣 API (ISBN/书名)
|
||||
│ ├── GetBookDetail() → 豆瓣 API (评分/简介/封面)
|
||||
│ ├── SearchAudiobooks() → iTunes API (media=audiobook)
|
||||
│ └── SearchCourses() → 喜马拉雅 SDK / 得到(后续)
|
||||
│
|
||||
├── KnowledgePanel (Vue)
|
||||
│ ├── Bookshelf.vue → 正在听的书籍/课程
|
||||
│ ├── CourseBrowser.vue → 浏览/搜索课程
|
||||
│ ├── DailyBook.vue → "每天一本书"推荐卡片
|
||||
│ └── FileBookLink.vue → 文件 ↔ 关联书籍信息
|
||||
│
|
||||
└── XimalayaPlayer (Vue/WebView)
|
||||
└── XimalayaEmbed.vue → 喜马拉雅内容嵌入式播放
|
||||
```
|
||||
|
||||
### 与文件管理器的融合点(核心差异化)
|
||||
1. **PDF/电子书增强**:浏览电子书文件时,侧栏显示豆瓣评分和简介
|
||||
2. **"边管边听"**:底部迷你播放器持续播放有声书/课程
|
||||
3. **智能推荐**:根据当前文件夹内容类型(如代码/设计稿),推荐相关课程
|
||||
4. **收藏联动**:收藏的书籍/课程与文件收藏夹统一视图
|
||||
5. **专注模式**:一键隐藏文件管理器面板,仅保留课程播放界面
|
||||
|
||||
---
|
||||
|
||||
*Sources:*
|
||||
- *喜马拉雅开放平台: https://open.ximalaya.com/*
|
||||
- *得到: https://www.dedao.cn/*
|
||||
- *豆瓣 API: https://github.com/douban/douban-api-v2*
|
||||
- *知乎: https://www.zhihu.com/*
|
||||
- *Udemy Affiliate: https://www.udemy.com/developers/affiliate/*
|
||||
- *Coursera API: https://build.coursera.org/*
|
||||
- *中国大学MOOC: https://www.icourse163.org/*
|
||||
494
docs/04-功能迭代/生态链接/05-生活服务.md
Normal file
494
docs/04-功能迭代/生态链接/05-生活服务.md
Normal file
@@ -0,0 +1,494 @@
|
||||
# 生活服务 开放平台接入方案备忘录
|
||||
|
||||
> 最后更新:2026-05-08 | 用途:U-Desk 生态链接 — 生活服务入口模块可行性评估
|
||||
|
||||
---
|
||||
|
||||
## 一、平台总览对比
|
||||
|
||||
### 天气服务
|
||||
| 平台 | 官网 | 费用 | 数据质量 | 推荐评级 |
|
||||
|------|------|------|---------|---------|
|
||||
| **和风天气 (QWeather)** | [dev.qweather.com](https://dev.qweather.com/) | 按量付费(有免费层) | 极高 | **A** |
|
||||
| 高德天气 API | [lbs.amap.com](https://lbs.amap.com/) | 免费(含配额) | 高 | **A** |
|
||||
| 中国气象局公开数据 | 无统一API | 免费 | 官方权威 | B+ |
|
||||
| OpenWeatherMap | [openweathermap.org](https://openweathermap.org/) | 免费/付费 | 国际 | B |
|
||||
|
||||
### 快递物流
|
||||
| 平台 | 官网 | 费用 | 覆盖范围 | 推荐评级 |
|
||||
|------|------|------|---------|---------|
|
||||
| **快递100** | [kuaidi100.com/openapi](https://www.kuaidi100.com/openapi/) | 按量付费(有免费) | 2200+ 家快递公司 | **A** |
|
||||
| 快递鸟 | 不详 | 商务合作 | 主要快递 | B |
|
||||
| 各快递官方API | 分散 | 需单独申请 | 单家 | C |
|
||||
|
||||
### 地图导航
|
||||
| 平台 | 官网 | 费用 | 能力 | 推荐评级 |
|
||||
|------|------|------|------|---------|
|
||||
| **高德开放平台** | [lbs.amap.com](https://lbs.amap.com/) | 免费额度 + 按量 | 全能LBS平台 | **A** |
|
||||
| **百度地图开放平台** | [lbsyun.baidu.com](https://lbsyun.baidu.com/) | 免费额度 + 按量 | 全能LBS + AI增强 | **A** |
|
||||
| **腾讯位置服务** | [lbs.qq.com](https://lbs.qq.com/) | 免费额度 + 按量 | 全能LBS + 街景 | **A-** |
|
||||
|
||||
### 翻译服务
|
||||
| 平台 | 费用 | 免费额度 | 推荐评级 |
|
||||
|------|------|---------|---------|
|
||||
| **百度翻译 API** | 按量 | **⚠️ 服务器500 审计中** | **待验证** |
|
||||
| 有道翻译 API | 按量 | 有免费层级 | A- |
|
||||
| 腾讯翻译君 API | 按量 | 有免费层级 | B+ |
|
||||
| Google Translate API | 按量(较贵) | 50万字符/月免费 | B |
|
||||
|
||||
### 日历/效率
|
||||
| 平台 | 能力 | 推荐评级 |
|
||||
|------|------|---------|
|
||||
| **钉钉开放平台** | 4000+ API,日历/待办/文档 | **A** |
|
||||
| **飞书开放平台** | 日历/文档/多维表格 | **A** |
|
||||
| 微软 Graph API (Outlook) | Calendar/To Do/Mail | A- |
|
||||
|
||||
### 新闻资讯
|
||||
| 平台 | 方式 | 推荐评级 |
|
||||
|------|------|---------|
|
||||
| **RSS 聚合(自建)** | 开源方案,完全自主可控 | **A** |
|
||||
| 今日头条开放平台 | 内容分发(面向创作者) | B |
|
||||
| 各新闻客户端API | 通常不开放第三方 | C |
|
||||
|
||||
---
|
||||
|
||||
## 二、和风天气 QWeather(推荐 ⭐⭐⭐)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://dev.qweather.com/
|
||||
- **定位**:专业气象数据服务商
|
||||
|
||||
### 核心能力
|
||||
- **实时天气**:温度/湿度/气压/风速/能见度
|
||||
- **天气预报**:未来3-7天逐小时/逐日预报
|
||||
- **灾害预警**:气象灾害预警信息
|
||||
- **空气质量**:AQI / PM2.5 / PM10 / 主要污染物
|
||||
- **历史天气**:历史气象数据查询
|
||||
- **地理天气**:目标区域当前及未来天气
|
||||
- **全球部署**:全球范围数据覆盖
|
||||
|
||||
### 技术特点
|
||||
- 标准 RESTful API + 多语言 SDK
|
||||
- 全球部署(无需面对各国本地化问题)
|
||||
- **按量计费**:用多少付多少,无需预付,无隐藏费用
|
||||
- 注册后创建项目和 KEY 即可使用
|
||||
|
||||
### 免费额度
|
||||
- 基础订阅包含一定的免费调用次数
|
||||
- 个人开发者/小应用通常够用
|
||||
|
||||
### U-Desk 使用场景
|
||||
- 任务栏/状态栏显示实时天气
|
||||
- 文件管理器侧栏天气小组件
|
||||
- 出行前快速查看目的地天气
|
||||
|
||||
---
|
||||
|
||||
## 三、高德地图开放平台(推荐 ⭐⭐⭐)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://lbs.amap.com/
|
||||
- **归属**:阿里巴巴集团
|
||||
- **定位**:国内最完善的 LBS(基于位置的服务)开放平台
|
||||
|
||||
### 核心能力矩阵
|
||||
|
||||
#### 搜索定位类
|
||||
| 产品 | 说明 | 形态 |
|
||||
|------|------|------|
|
||||
| **搜索** | 位置/周边/行政区/POI ID 查询 | API / JS / Android / iOS |
|
||||
| **定位** | 基于 LBS 的定位服务 | API / Android / iOS |
|
||||
| **地理/逆地理编码** | 经纬度 ↔ 地址转换 | API / JS / Android / iOS |
|
||||
| **地理围栏** | 虚拟空间围栏服务 | API / Android / iOS |
|
||||
| **天气查询** | 目标区域当前/未来天气 | API |
|
||||
| **智能硬件定位** | 基站/WiFi 定位 | SDK |
|
||||
|
||||
#### 路线导航类
|
||||
| 产品 | 说明 | 形态 |
|
||||
|------|------|------|
|
||||
| **导航** | 专业导航能力 | Android / iOS |
|
||||
| **路线规划** | 步行/驾车等路径规划 | API / JS / Android / iOS |
|
||||
| **猎鹰服务** | 专业轨迹管理 | API / Android / iOS |
|
||||
| **货车路径规划** | 专业货运路径规划 | API |
|
||||
| **公交信息查询** | 公交线路/站点查询 | API |
|
||||
| **交通路况查询** | 实时交通态势 | API |
|
||||
|
||||
#### 地图产品类
|
||||
| 产品 | 说明 | 形态 |
|
||||
|------|------|------|
|
||||
| **动态地图** | 2D 地图展示与配置 | API / JS / Android / iOS |
|
||||
| **3D 地图** | 3D 渲染地图视图 | JS / Android / iOS |
|
||||
| **静态地图** | 将地图嵌入网页 | 图片 |
|
||||
| **地铁图** | 地铁线路图 | JS / Android / iOS |
|
||||
| **3D 地形图** | 卫星地形图 | JS |
|
||||
|
||||
#### 高级工具
|
||||
| 产品 | 说明 |
|
||||
|------|------|
|
||||
| **世界地图** | 全球 LBS 服务 |
|
||||
| **LOCA 数据可视化** | 百万级数据可视化渲染 |
|
||||
| **GeoHUB 地图数据中心** | 数据管理/编辑/发布/分析 |
|
||||
| **MCP Server** | 12项核心功能 SSE 快速集成 ← 新! |
|
||||
| **CLI 工具** | 命令行调用高德能力 ← 新! |
|
||||
|
||||
### 规模数据
|
||||
- 日均处理近 **1000亿次** 定位及路线规划请求
|
||||
- 覆盖超过 **7000万** POI 数据点
|
||||
- 覆盖超过 **3500万** 地址库数据
|
||||
- 地级市实时路况准确率 **95%**
|
||||
- 服务可用性 **99.9%**
|
||||
- 平均响应时长 **≤300ms**
|
||||
|
||||
### 费用模式
|
||||
- **Web 服务 API**:免费额度(基础调用),超出按量计费
|
||||
- **JS API**:大部分免费(商业授权需认证)
|
||||
- 定价页面:https://lbs.amap.com/ 定价
|
||||
|
||||
### U-Desk 使用场景
|
||||
1. **文件位置展示**:文件带有 GPS 信息时在地图上标记
|
||||
2. **地址解析**:将文本地址转为经纬度坐标
|
||||
3. **路线规划**:查看两个地点间的路线
|
||||
4. **周边搜索**:查找文件所在位置周边的 POI
|
||||
5. **天气集成**:高德自带天气查询 API(可替代独立天气服务)
|
||||
|
||||
---
|
||||
|
||||
## 四、快递100 API(推荐 ⭐⭐⭐)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://www.kuaidi100.com/openapi/
|
||||
- **定位**:企业级快递物流信息集成解决方案
|
||||
- **规模**:15年经验、250万+企业客户、日均查询突破 **4亿** 次、吞吐量近 **40万/秒**
|
||||
|
||||
### 核心能力
|
||||
|
||||
#### 查询类
|
||||
| API | 说明 |
|
||||
|-----|------|
|
||||
| **实时快递查询 API** | 主动查询物流状态,即时返回最新信息 |
|
||||
| **快递查询地图轨迹 API** | 返回包裹地图轨迹 + 预估时效 |
|
||||
| **智能单号识别 API** | 自动判断单号归属的快递公司 |
|
||||
|
||||
#### 订阅推送类
|
||||
| API | 说明 |
|
||||
|-----|------|
|
||||
| **地图轨迹推送服务 API** | 定时监控并推送地图轨迹 + 预估送达时间 |
|
||||
|
||||
#### 电子面单类
|
||||
| API | 说明 |
|
||||
|-----|------|
|
||||
| **电子面单 API** | 支持 50+ 快递公司面单获取、云打印、本地打印 |
|
||||
| **自定义打印 API** | 自定义内容(商品清单/发票/发货单) |
|
||||
| **电商平台打单** | 同步多平台订单,统一发货打单 |
|
||||
|
||||
#### 物流服务类
|
||||
| API | 说明 |
|
||||
|-----|------|
|
||||
| **商家寄件 API** | 下单至快递公司,上门取件,线上结算 |
|
||||
| **同城配送 API** | 多家同城配送公司支持 |
|
||||
| **物流全链路监控** | 15+ 电商平台发货规则同步,履约时效监控 |
|
||||
|
||||
#### 跨境服务类
|
||||
| API | 说明 |
|
||||
|-----|------|
|
||||
| **国际物流查询 API** | 2200+ 全球运输商,支持简/繁/英 |
|
||||
| **国际地址解析 API** | 国际地址标准化输出 |
|
||||
| **国际电子面单 API** | 国际面单获取与绑定 |
|
||||
| **跨境发货助手** | 一站式跨境发货 |
|
||||
|
||||
#### 增值服务
|
||||
| API | 说明 |
|
||||
|-----|------|
|
||||
| 智能地址解析 | 提取姓名/电话/地址并结构化 |
|
||||
| 快递时效查询 | 预测到达时间 |
|
||||
| 拦截改址 | 运输中快件拦截处理 |
|
||||
| 短信提醒发送 | 物流节点通知 |
|
||||
| 快递面单 OCR | 面单识别提取信息 |
|
||||
| Excel 批量查询 | 非技术用户批量查询 |
|
||||
| 快递预估价格 | 不同快递成本估算 |
|
||||
| 快递可用性查询 | 线路是否支持寄送 |
|
||||
|
||||
### 覆盖范围
|
||||
- **2200+** 全球运输商物流轨迹查询
|
||||
- **50+** 快递公司面单打印
|
||||
- **10+** 快递公司寄件下单
|
||||
- 支持国内外主流快递
|
||||
|
||||
### U-Desk 使用场景
|
||||
1. **快递追踪面板**:输入单号一键查询物流状态
|
||||
2. **文件关联**:收到快递单号截图/PDF 时自动识别单号
|
||||
3. **批量查询**:Excel 表格批量导入单号查询
|
||||
4. **桌面小组件**:常驻快递列表,状态更新提醒
|
||||
|
||||
---
|
||||
|
||||
## 五、钉钉开放平台(效率工具 ⭐⭐⭐)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://open.dingtalk.com/
|
||||
- **归属**:阿里巴巴 / 钉钉科技有限公司
|
||||
- **定位**:企业数字化一站式开发平台
|
||||
|
||||
### 核心数据
|
||||
- **4000+** 开放接口
|
||||
- 应用类型:网页应用 / 小程序 / 机器人 / 酷应用 / AI助理 / AI工作流
|
||||
|
||||
### 核心能力
|
||||
| 能力域 | 说明 |
|
||||
|--------|------|
|
||||
| **通讯录** | 用户/部门/角色信息读取 |
|
||||
| **消息** | 发送工作通知/群消息/卡片消息 |
|
||||
| **日历** | 日程/会议/空闲忙查询 |
|
||||
| **待办事项** | 创建/查询/更新待办 |
|
||||
| **审批** | 发起/审批流程实例 |
|
||||
| **考勤** | 打卡记录/排班/请假 |
|
||||
| **文档** | 在线文档读写 |
|
||||
| **机器人** | 群机器人 @ 触发回复 |
|
||||
| **AI 工作流** | AI 驱动的自动化流程 |
|
||||
| **酷应用** | 深度嵌入钉钉的富交互应用 |
|
||||
|
||||
### 开发方式
|
||||
- **全代码开发**:完整 API 控制
|
||||
- **低代码开发**:宜搭平台快速搭建
|
||||
- **AI 开发**:AI 辅助开发
|
||||
- **硬件开发**:智能硬件接入
|
||||
|
||||
### U-Desk 使用场景
|
||||
1. **日历联动**:U-Desk 显示钉钉日程/待办
|
||||
2. **文件快捷分享**:选中文件一键发送到钉钉会话
|
||||
3. **审批关联**:文件作为审批附件
|
||||
4. **消息通知**:U-Desk 事件推送到钉钉
|
||||
|
||||
> 注意:钉钉主要面向企业场景。个人版 U-Desk 可选接入。
|
||||
|
||||
---
|
||||
|
||||
## 六、百度地图开放平台(与高德同级 ⭐⭐⭐)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://lbsyun.baidu.com/
|
||||
- **归属**:百度
|
||||
- **定位**:百万开发者首选的地图服务商
|
||||
|
||||
### 核心能力矩阵
|
||||
|
||||
#### 热门产品
|
||||
| 产品 | 说明 |
|
||||
|------|------|
|
||||
| **地点检索 3.0** | 多维检索 + AI 向导 |
|
||||
| **北斗定位** | 优先北斗卫星定位 |
|
||||
| **鹰眼轨迹** | 专业轨迹管理服务 |
|
||||
| **货车导航** | 专业的货运路径规划 |
|
||||
| **地址服务** | 智能地址解析与标准化 |
|
||||
| **地图可视化** | 数据可视化渲染引擎 |
|
||||
| **专网地图** | 私有化部署地图服务 |
|
||||
|
||||
#### 开发形态(三档接入)
|
||||
| 接入方式 | 适用场景 |
|
||||
|----------|---------|
|
||||
| **简单接口服务**(3步接入) | 注册 → 获取密钥(AK) → 集成 API/SDK — 个人开发者/小应用 |
|
||||
| **复杂定制服务** | 需要更多能力或定制化的中大型应用 |
|
||||
| **行业解决方案** | 物流/文旅/交通/汽车/金融等千行百业 |
|
||||
|
||||
#### SDK / API 覆盖
|
||||
| 平台 | 产品 |
|
||||
|------|------|
|
||||
| Web | JS API GL / Three.js 数据可视化 / 微信小程序 / 地铁图 |
|
||||
| Android | 地图 SDK / 定位 SDK / 鹰眼轨迹 SDK / 导航 SDK / 全景 SDK / 司乘同显 SDK |
|
||||
| iOS | 同 Android 全套 |
|
||||
| **HarmonyOS** | NEXT 版地图/定位/鹰眼/步骑行导航/驾车导航/司乘同显 ← **华为生态全覆盖** |
|
||||
|
||||
#### 特色能力(区别于高德)
|
||||
| 能力 | 说明 |
|
||||
|------|------|
|
||||
| **AI 向导** | 检索结果 AI 增强,智能推荐 |
|
||||
| **境内英文地图** | 行业首家,支持全流程英文出行 |
|
||||
| **全球位置服务** | 2B2C 一体,助力政企出海 |
|
||||
| **超视距巡航** | 3D 地图高级浏览 |
|
||||
| **红绿灯倒计时** | 路线规划含实时信号灯信息 |
|
||||
| **定位防作弊** | 虚假位置检测 |
|
||||
| **离线定位** | 无网络环境下的定位能力 |
|
||||
|
||||
### 接入流程(个人开发者)
|
||||
1. 注册/登录百度账号
|
||||
2. 创建应用,获取密钥 (AK)
|
||||
3. 集成服务 API / SDK
|
||||
|
||||
### 费用模式
|
||||
- **Web 服务 API**:免费额度(基础调用),超出按量计费
|
||||
- **JS API**:大部分免费
|
||||
- 定价页面可查看详细阶梯
|
||||
|
||||
### U-Desk 使用场景(与高德互补)
|
||||
- 百度地图在 **AI 检索增强** 和 **HarmonyOS 支持** 方面有特色
|
||||
- 如果 U-Desk 未来考虑鸿蒙端,百度有现成 HarmonyOS NEXT SDK
|
||||
- 建议与高德 **二选一或同时接入**(切换成本低,都是标准 RESTful API)
|
||||
|
||||
---
|
||||
|
||||
## 七、腾讯位置服务(备选 ⭐⭐⭐)
|
||||
|
||||
### 基本信息
|
||||
- **官网**:https://lbs.qq.com/
|
||||
- **归属**:腾讯
|
||||
- **定位**:立足生态,连接未来
|
||||
|
||||
### 核心能力
|
||||
- **JavaScript API**:Web 端地图开发
|
||||
- **移动端 Native SDK**:Android / iOS
|
||||
- **WebService 接口**:服务端调用
|
||||
- **街景 API**:腾讯特色的街景视图(高德/百度无此能力)
|
||||
- **路线规划**:驾车/步行/公交/骑行
|
||||
- **地理编码/逆地理编码**:地址 ↔ 经纬度
|
||||
- **地点搜索**:POI 关键词检索
|
||||
|
||||
### 特色优势
|
||||
| 能力 | 说明 |
|
||||
|------|------|
|
||||
| **街景服务** | 腾讯独有,360° 街景全景图 |
|
||||
| **微信生态整合** | 与微信小程序/公众号天然打通 |
|
||||
| **腾讯系协同** | 与 QQ 音乐、腾讯视频等同一生态 |
|
||||
|
||||
### 费用模式
|
||||
- 免费额度 + 按量计费(与高德/百度类似)
|
||||
|
||||
### U-Desk 适配评估
|
||||
- 技术层面完全可行(标准 JS API / RESTful)
|
||||
- **如果 U-Desk 已接入 QQ 音乐/腾讯视频**,腾讯地图可作为统一腾讯生态补充
|
||||
- 街景能力是差异化亮点(如展示文件拍摄地点的街景)
|
||||
|
||||
---
|
||||
|
||||
## 八、其他生活服务速查
|
||||
|
||||
### 翻译服务(三选一即可)
|
||||
| 服务 | 免费额度 | 特点 |
|
||||
|------|---------|------|
|
||||
| 百度翻译 API | 标准版免费 5万字符/月 | 中文优化好 |
|
||||
| 有道翻译 API | 免费额度 | 学术文献翻译强 |
|
||||
| 腾讯翻译君 API | 免费额度 | 多语种支持广 |
|
||||
|
||||
**建议**:选百度翻译(免费额度大 + 中文优化)
|
||||
|
||||
### 新闻资讯 — RSS 自建方案(强烈推荐)
|
||||
- 完全自主可控,无第三方依赖
|
||||
- 推荐框架:`rss-parser` (Node.js) 或 `feedparser` (Go)
|
||||
- 可订阅源:36氪/虎嗅/少数派/V2EX/Hacker News 等
|
||||
- U-Desk 实现:Go 后端定时抓取 → Vue 展示新闻列表
|
||||
|
||||
### 12306 / 航旅
|
||||
- **12306**:无公开 API(极其严格)
|
||||
- **航旅纵横**:无公开开发者接口
|
||||
- **各航空公司**:部分有开放 API(如东航/南航)
|
||||
- 结论:暂不可行,以外部链接方式提供
|
||||
|
||||
### 外卖(美团/饿了么)
|
||||
- 主要面向商家端 API
|
||||
- 无消费者端的开放接口
|
||||
- 结论:暂不可行
|
||||
|
||||
### 支付宝/微信支付
|
||||
- 面向商户的支付能力开放
|
||||
- 与 U-Desk 场景关联度低
|
||||
- 如需"打赏"等功能可后续考虑
|
||||
|
||||
---
|
||||
|
||||
## 九、最终推荐组合方案
|
||||
|
||||
### 第一优先级(MVP 必选)
|
||||
|
||||
| 服务 | 平台 | 用途 | 工作量 | 成本 |
|
||||
|------|------|------|--------|------|
|
||||
| 天气 | 和风天气 / 高德天气 | 状态栏/侧栏天气显示 | 0.5天 | 免费~少量 |
|
||||
| 地图 | 高德开放平台 | 文件位置/地址解析/路线 | 1-2天 | 免费 |
|
||||
| 快递 | 快递100 API | 物流追踪面板 | 1-2天 | 免费~少量 |
|
||||
|
||||
### 第二优先级(体验增强)
|
||||
|
||||
| 服务 | 平台 | 用途 | 工作量 |
|
||||
|------|------|------|--------|
|
||||
| 翻译 | 百度翻译 API | 文件内容/界面翻译 | 0.5天 |
|
||||
| 新闻 | RSS 自建聚合 | 信息流/资讯面板 | 1天 |
|
||||
| 效率 | 钉钉开放平台 | 日历/待办/文件分享 | 2-3天 |
|
||||
|
||||
### 第三优先级(锦上添花)
|
||||
|
||||
| 服务 | 平台 | 用途 |
|
||||
|------|------|------|
|
||||
| 日历 | 微软 Graph API | Outlook 日历同步 |
|
||||
| AI 助手 | 对接已有 AI 工作台 | 自然语言操作文件 |
|
||||
|
||||
---
|
||||
|
||||
## 十、U-Desk 生活服务模块架构建议
|
||||
|
||||
```
|
||||
U-Desk 生态链接 - 生活服务模块
|
||||
├── WeatherService (Go)
|
||||
│ ├── GetCurrentWeather() → QWeather / 高德天气 API
|
||||
│ ├── GetForecast() → 未来3-7天预报
|
||||
│ └── GetAirQuality() → 空气质量指数
|
||||
│
|
||||
├── MapService (Go)
|
||||
│ ├── Geocode() → 地址 → 经纬度 (高德)
|
||||
│ ├── ReverseGeocode() → 经纬度 → 地址
|
||||
│ ├── SearchPOI() → 周边 POI 搜索
|
||||
│ └── RoutePlan() → 路线规划
|
||||
│
|
||||
├── ExpressService (Go)
|
||||
│ ├── TrackPackage() → 快递100 查询
|
||||
│ ├── AutoDetectCarrier() → 单号自动识别
|
||||
│ └── BatchTrack() → 批量查询
|
||||
│
|
||||
├── TranslateService (Go)
|
||||
│ └── Translate() → 百度翻译 API
|
||||
│
|
||||
├── NewsService (Go)
|
||||
│ ├── FetchFeeds() → RSS 抓取聚合
|
||||
│ └── ParseFeed() → 解析/去重/分类
|
||||
│
|
||||
├── LifePanel (Vue Components)
|
||||
│ ├── WeatherWidget.vue → 天气小组件
|
||||
│ ├── ExpressTracker.vue → 快递追踪面板
|
||||
│ ├── MapViewer.vue → 地图查看器
|
||||
│ ├── NewsFeed.vue → 新闻资讯流
|
||||
│ └── QuickTools.vue → 翻译/计算器/汇率等
|
||||
│
|
||||
└── DingTalkBridge (Go)
|
||||
├── SyncCalendar() → 日历同步
|
||||
├── ShareToFile() → 文件分享到钉钉
|
||||
└── PushNotification() → 事件通知
|
||||
```
|
||||
|
||||
### 与文件管理器的融合点(核心价值)
|
||||
1. **天气**:任务栏图标 hover 显示天气,不影响主界面
|
||||
2. **快递**:收到快递单号图片/PDF → 右键"查询物流"
|
||||
3. **地图**:GPS 照片/日志文件 → 自动在地图标注位置
|
||||
4. **翻译**:选中文件名或文本 → 右键"翻译"
|
||||
5. **新闻**:文件管理间隙浏览资讯(不打断工作流)
|
||||
6. **钉钉**:文件右键一键分享到钉钉聊天/文档
|
||||
|
||||
---
|
||||
|
||||
## 九、成本预估汇总
|
||||
|
||||
| 服务 | 月成本(个人版预估) | 备注 |
|
||||
|------|---------------------|------|
|
||||
| 和风天气 | ¥0 ~ ¥50 | 免费层够个人使用 |
|
||||
| 高德地图 | ¥0 ~ ¥100 | Web API 免费额度较大 |
|
||||
| 快递100 | ¥0 ~ ¥50 | 有免费试用额度 |
|
||||
| 百度翻译 | ¥0 | 标准版 5万字符/月免费 |
|
||||
| RSS 新闻 | ¥0 | 完全自建,无成本 |
|
||||
| 钉钉 | ¥0 | 企业版可能收费 |
|
||||
| **合计** | **¥0 ~ ¥200/月** | MVP 阶段接近零成本 |
|
||||
|
||||
---
|
||||
|
||||
*Sources:*
|
||||
- *和风天气: https://dev.qweather.com/*
|
||||
- *高德开放平台: https://lbs.amap.com/*
|
||||
- *快递100: https://www.kuaidi100.com/openapi/*
|
||||
- *钉钉开放平台: https://open.dingtalk.com/*
|
||||
- *百度翻译 API: https://fanyi-api.baidu.com/*
|
||||
- *OpenWeatherMap: https://openweathermap.org/api*
|
||||
106
docs/04-功能迭代/生态链接/README.md
Normal file
106
docs/04-功能迭代/生态链接/README.md
Normal file
@@ -0,0 +1,106 @@
|
||||
# U-Desk 生态链接 — 开放平台接入方案总览
|
||||
|
||||
> 最后更新:2026-05-08 | 状态:调研完成,待实施
|
||||
|
||||
---
|
||||
|
||||
## 什么是"生态链接"
|
||||
|
||||
U-Desk 作为 Wails v3 桌面文件管理器,除了核心的文件管理能力外,通过接入第三方开放平台的 **合规 API/SDK**,为用户提供一站式的 **音乐 / 视频 / 广播 / 课程 / 生活服务** 入口。
|
||||
|
||||
**核心理念**:文件管理是主场景,生态服务是增强层 — 不喧宾夺主,而是让用户在管理文件的过程中顺手获得其他服务。
|
||||
|
||||
## 文档结构
|
||||
|
||||
```
|
||||
docs/04-功能迭代/生态链接/
|
||||
├── README.md ← 本文件(总览)
|
||||
├── 01-音乐平台.md ← QQ音乐/网易云/酷狗/Spotify/Apple Music
|
||||
├── 02-视频平台.md ← B站/腾讯视频/YouTube/Vimeo
|
||||
├── 03-广播电台.md ← Radio Browser/iTunes播客/喜马拉雅/CCTV
|
||||
├── 04-课程专栏.md ← 喜马拉雅/得到/豆瓣/知乎/国际MOOC
|
||||
└── 05-生活服务.md ← 天气/快递/地图/翻译/钉钉/RSS新闻
|
||||
```
|
||||
|
||||
## 各模块推荐方案速查
|
||||
|
||||
| 模块 | P0 首选(国内) | P0 首选(国际) | P1 备选 | MVP 工作量 |
|
||||
|------|---------------|---------------|---------|-----------|
|
||||
| **音乐** | ~~QQ音乐~~ (❌ Win不支持) → **Spotify Web API** | **Spotify** | 网易云(实验性) | 3-5天 |
|
||||
| **视频** | **抖音开放 SDK** ✅ | YouTube IFrame | ~~B站~~ (⚠️ API仓库被律师函关停) | 2-3天 |
|
||||
| **广播/播客** | Radio Browser API | iTunes Podcast | 喜马拉雅 Web | 4-6天 |
|
||||
| **课程/知识** | 喜马拉雅 JS SDK | iTunes Search API | ~~豆瓣API~~ (❌仓库404+官方库2014归档) | 2-3天 |
|
||||
| **生活服务** | **高德 / 百度地图**(二选一) | - | 快递100+和风天气+钉钉 | 3-5天 |
|
||||
|
||||
> * 音乐模块含 QQ 音乐桌面端确认的前置依赖,若不支持需切换方案
|
||||
|
||||
## 合规底线
|
||||
|
||||
1. **全部使用官方 API/SDK**,禁止爬虫/逆向/解密
|
||||
2. **必须用户授权登录**,借用用户自身会员权益
|
||||
3. **如实上报播放/调用流水**
|
||||
4. **标注内容版权归原平台及版权方所有**
|
||||
5. **优先采用 iframe/H5 嵌入** 方案(视频/音频),而非自建播放器解析流
|
||||
|
||||
## 技术适配原则
|
||||
|
||||
| 原则 | 说明 |
|
||||
|------|------|
|
||||
| WebView2 兼容 | 所有 Web/JS 方案均可在 Wails WebView2 中运行 |
|
||||
| Go 后端代理 | 敏感操作(API Key 管理/速率控制)通过 Go 后端代理 |
|
||||
| 渐进式加载 | 生态模块按需加载,不影响文件管理器启动速度 |
|
||||
| 统一 UI 风格 | 即使嵌入第三方内容,也用 U-Desk 统一外壳包裹 |
|
||||
|
||||
## 国内平台调研状态总览
|
||||
|
||||
| 平台 | 调研深度 | 状态 | 主要发现 |
|
||||
|------|---------|------|---------|
|
||||
| **抖音开放平台** | ✅ 官网完整抓取 | **可接入** | SDK完善,免费,分享/投稿/授权/支付全链路 |
|
||||
| **高德地图** | ✅ 官网完整抓取 | **可接入** | 44种产品,MCP/CLI 新能力,HarmonyOS 支持 |
|
||||
| **百度地图** | ✅ 官网完整抓取 | **可接入** | AI 向导检索,HarmonyOS 全覆盖,与高德同级 |
|
||||
| **腾讯位置服务** | ✅ 开放平台确认 | **可接入** | 街景特色,微信生态协同 |
|
||||
| **喜马拉雅** | ✅ 官网完整抓取 | **需商务审批** | JS SDK 可用,内容极全(有声书+课程+播客) |
|
||||
| **QQ音乐** | ✅ 代理深度报告 | **⚠️ 待确认** | Windows 桌面端未在支持列表,需邮件确认 |
|
||||
| **得到** | ✅ 官网完整抓取 | **❌ 无 API** | 封闭生态:6400万用户/390门课/10万本电子书均不开放 |
|
||||
| **B站开放平台** | ⚠️ 官网持续不可达(connection refused) | **❌ 已确认不可用** | 非官方API文档已于2026-01-28被律师函关停(SocialSisterYi/bilibili-API-collect) |
|
||||
| **快递100** | ✅ 官网完整抓取 | **可接入** | 2200+ 快递公司,15年经验,企业级方案 |
|
||||
| **和风天气** | ✅ 官网完整抓取 | **可接入** | 全球部署,按量计费,有免费层 |
|
||||
| **钉钉开放平台** | ✅ 官网完整抓取 | **可接入** | 4000+ 接口,全代码/低代码/AI 开发 |
|
||||
|
||||
> **跨模块注意**:喜马拉雅同时覆盖「广播电台」和「课程专栏」两个模块,接入一次即可服务双场景。
|
||||
|
||||
## 实施路线图
|
||||
|
||||
### Phase 0 — 技术验证(1周)
|
||||
- [ ] 发邮件至 QQ 音乐确认 Windows 桌面端支持
|
||||
- [ ] Radio Browser API 对接验证(Go 调用 → Vue 展示 → 播放)
|
||||
- [ ] YouTube IFrame API 嵌入验证
|
||||
- [ ] 高德地图 JS API 嵌入验证
|
||||
|
||||
### Phase 1 — MVP 上线(2-3周)
|
||||
- [ ] 广播电台模块(Radio Browser + iTunes 播客)
|
||||
- [ ] 视频嵌入模块(YouTube + B站)
|
||||
- [ ] 天气小组件(和风天气 / 高德天气)
|
||||
- [ ] 快递追踪面板(快递100)
|
||||
|
||||
### Phase 2 — 深度集成(3-4周)
|
||||
- [ ] 音乐模块(QQ 音乐或 Spotify)
|
||||
- [ ] 地图能力(高德完整 LBS)
|
||||
- [ ] 课程/知识入口(喜马拉雅 + 豆瓣元数据)
|
||||
- [ ] RSS 新闻聚合
|
||||
|
||||
### Phase 3 — 生态完善(持续迭代)
|
||||
- [ ] 钉钉/飞书效率工具联动
|
||||
- [ ] 翻译服务集成
|
||||
- [ ] 更多平台按需接入
|
||||
|
||||
## 成本预估
|
||||
|
||||
| 阶段 | 月成本 | 说明 |
|
||||
|------|--------|------|
|
||||
| Phase 0 | ¥0 | 全部使用免费额度验证 |
|
||||
| Phase 1 | ¥0 ~ ¥100 | 天气+快递少量调用 |
|
||||
| Phase 2 | ¥50 ~ ¥300 | 根据用户量增长 |
|
||||
| Phase 3 | ¥100 ~ ¥500+ | 多平台叠加 |
|
||||
|
||||
> 个人使用场景下,**MVP 阶段月成本可控制在 ¥100 以内**。
|
||||
Reference in New Issue
Block a user