336 lines
13 KiB
Markdown
336 lines
13 KiB
Markdown
# 视频平台开放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*
|