新增: SFTP直连+网站预览+OSS区域嗅探+热键+BGM播放

2026-05-12 11:06:28 +08:00
parent 545d7a864d
commit 2a363fd729
62 changed files with 6687 additions and 660 deletions
--- a/docs/04-功能迭代/生态链接/02-视频平台.md
+++ b/docs/04-功能迭代/生态链接/02-视频平台.md
@@ -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*