CineSeek：免费的VIP视频解析站点

先做一个可以浏览的首页#

CineSeek 的首页先从内容开始，而不是只放一个搜索框。

顶部是焦点推荐，可以在几部内容之间切换；下面按照“重磅热播”和“为你推荐”等区域组织内容。电视剧、电影、综艺、动漫等频道放在左侧导航中，也保留了少儿、纪录片、体育和中视频等入口。

首页数据由腾讯视频 Provider 提供。上游返回的卡片、图片、标题、类型和链接，会先被整理成统一的媒体数据，再交给页面展示。

这样首页推荐、频道列表和搜索结果虽然长得不一样，但最后使用的是同一套媒体模型。以后接入其他平台时，页面不用跟着每个平台的字段重新修改。

目前只有腾讯视频#

CineSeek 当前启用的 Provider 只有腾讯视频。

爱奇艺和芒果 TV 已经在 Provider 注册表里预留了位置，不过还没有实现。后续如果继续扩展平台，需要分别处理各个平台的首页、搜索、频道、详情和播放方式，再转换成统一的数据结构。

腾讯这一条链路目前拆成了几个部分：共享模块负责请求端点和原始值读取，卡片解析器负责递归遍历和字段映射，首页、搜索、片库、推荐和详情则各自处理自己的数据。

现在这样拆开，主要是为了让一个页面的数据变化不要牵扯到所有地方。等第二个平台真正接入时，也能更清楚地看到两个 Provider 之间的差异。

搜索之后，直接打开播放页#

搜索页负责把内容找出来。

输入片名、演员或关键词之后，CineSeek 会请求搜索接口，展示搜索结果、类型、海报和简介。搜索建议和热搜也有单独的接口，输入还没有完成时，可以先给出一些可选内容。

找到内容之后，可以直接进入播放页。播放页会显示当前剧集、影片资料、演员表和选集列表。电视剧按照集数展示按钮，并标记限免、预告、VIP 和 SVIP 等状态。

播放解析和播放器#

目前播放解析使用虾米接口。

播放时，服务端先尝试获取 HLS 或 MP4 直链，再交给播放器。如果直链解析失败，则切换到备用的 iframe 播放线路。对页面来说，这只是同一个播放流程里的两条线路。

播放器使用 Artplayer 和 HLS.js。播放页还支持剧集切换、上一集、下一集以及弹幕显示。弹幕按照播放时间窗口请求，不会在页面打开时一次性加载全部数据；播放到对应时间段时，再获取相应内容。

现在最重要的事情不是把播放器做得多复杂，而是让用户能够从搜索结果顺利走到播放页，并且在解析失败时得到清楚的反馈。

页面失败时保留一点余地#

影视内容的上游接口并不总是稳定，所以 CineSeek 做了一些简单的降级处理。

首页首屏会先使用 fallback 数据，客户端加载完成后再请求实时内容。频道页面和推荐内容请求失败时，尽量保留最近一次成功的数据；搜索失败时则不生成伪造结果。

API 错误也会统一返回 error、code 和 retryable 字段，让页面能够判断这次请求是否适合重试。播放直链解析失败时，则优先切换备用线路，而不是让整个播放页直接结束。

这些处理并不能让第三方服务变得稳定，只是尽量让页面在偶尔失败时不要显得突然失去控制。

后面会做什么#

下一步会考虑爱奇艺和芒果 TV。

不过新的 Provider 不只是换一个请求地址。每个平台的首页结构、搜索结果、频道分类、详情字段和播放方式都可能不同，需要分别处理，再转换成统一的媒体模型。

所以我会先把腾讯这一条链路继续整理好，包括播放失败时的提示、更多详情数据、选集交互和移动端体验。等 Provider 的边界稳定下来，再接入其他平台会更自然一些。

目前 CineSeek 还是一个正在变化的项目。先让它能够稳定地找到一部片、打开播放页、切换剧集，再慢慢把其他事情补上。

关于上游内容和使用边界#

CineSeek 不存储影视内容。页面中的标题、图片、简介、播放地址和弹幕数据，都来自上游内容源或第三方解析服务。

腾讯视频相关接口不是版本化的官方应用 SDK，解析服务也可能随时变化。内容的可用性、版权状态和服务条款不由这个项目保证。

使用时请自行确认相关内容和接口的版权、服务条款以及所在地的法律要求。

CineSeek 当前部署在：

https://cineseek.markqq.com