第三方应用如何调用 VidHub API 播放影片

VidHub API 概述

VidHub 提供了 URL Scheme API，允许其他应用通过特定格式的 URL 直接唤起 VidHub 并指定要播放的视频。这是 VidHub 跨应用联动的核心机制。

应用场景

第三方应用调用 VidHub API 的典型场景：

• 网页端视频链接 → 点击链接直接在 VidHub 中打开
• 其他 App 的视频列表 → 选择 VidHub 作为播放器
• 快捷指令（Shortcuts） → 自动化触发 VidHub 播放特定视频
• 浏览器扩展 → 识别视频链接后一键跳转 VidHub

URL Scheme 格式

VidHub 的 URL Scheme 入口格式（以官方最新版本为准）：

vidhub://play?url=<视频文件URL>&title=<影片标题>

参数说明

支持的 URL 类型

• HTTP(S) 视频流：https://example.com/video.mp4
• WebDAV 链接：https://webdav.example.com/path/video.mkv
• SFTP/SMB：部分版本支持
• 本地文件 URL：file:///path/to/video.mp4（仅在设备本地有效）

快捷指令集成示例

iOS 快捷指令（Shortcuts）是 VidHub API 最常见的使用场景：

示例一：快捷播放本地视频

1. 创建新快捷指令
2. 选择操作：获取文件（选择本地视频文件）
3. 添加操作：URL（构建 vidhub://play?url=...）
4. 添加操作：打开 URL
5. 运行快捷指令 → VidHub 自动打开并播放选中的视频

示例二：Safari 中一键播放网页视频

1. 在 Safari 中长按视频链接 → 分享 → 快捷指令
2. 快捷指令自动把链接格式化为 vidhub://play?url=<链接>
3. 点击运行 → VidHub 打开并播放该链接

开发集成注意事项

编码规范

• 所有 URL 参数必须 URL 编码（空格 → %20，中文 → %E4%B8%AD%E6%96%87）
• 标题建议也编码
• 不同平台可能支持略有差异，建议各端测试

权限问题

• 某些云盘 URL 可能需要额外认证
• 临时签名的 URL（如阿里云盘临时链接）过期后播放会失败
• 本地文件 URL 仅在同一设备有效

兼容性

• VidHub 的 URL Scheme 在 iOS/iPadOS/macOS 上都支持
• Android 端可能需要不同的 URL Scheme 或 Intent 方式
• API 可能随版本变化，建议以官方最新文档为准

更多资源

• 官方帮助中心有更详细的 API 说明（搜索"VidHub API"）
• 快捷指令社区有现成的 VidHub 集成模板
• GitHub 上有开发者分享的 VidHub URL Scheme 使用示例

具体 API 参数和支持的 URL Scheme 以 VidHub 官方最新版的帮助中心文档为准。功能可能随版本更新变化。