lxy/u-desk
Private
Public Access
1
0
Fork 0
Code Activity
Files
2a363fd7292f6bb5ac5ca4895454909ba5b6fd20
u-desk/docs/04-功能迭代/生态链接/02-视频平台.md

13 KiB
Raw Blame History

视频平台开放API接入方案备忘录

最后更新：2026-05-08 | 用途：U-Desk 生态链接 — 视频模块可行性评估

一、平台总览对比

维度 哔哩哔哩 抖音开放平台 腾讯视频 爱奇艺 优酷 YouTube IFrame
官网 developer.bilibili.com open.douyin.com open.tencent.com 开放程度有限 开放程度有限 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）

四、腾讯视频开放平台（⚠️ 需区分两条路径）

基本信息

⚠️ 关键区分（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（国际内容补充）

基本信息

核心能力

// 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

基本信息

能力

  • 嵌入式播放器（类似 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:

View Git Blame Copy Permalink