Communitygithub.com

滚动视频网站

构建或优化一个网站,让原生滚动控制经过审核的视频进度,并协调物体过渡到页面内容中。适用于滚动驱动的电影感入场和摄影级物体运动,而非普通的自动播放视频嵌入。

滚动视频网站 是什么?

该技能旨在将一段已审核的视频序列转化为响应式、可逆的网站交互体验。它复用了现有网站的技术栈和已批准的素材,不依赖特定的动画库。核心交互模式是:用户通过原生滚动(鼠标滚轮或触摸滚动)来控制视频的播放进度,从而驱动一个视觉故事,例如产品展示、室内空间揭示或艺术作品展示。该技能要求精确处理视频和3D/2D物体的协同动画,在滚动时保持视频暂停并合并搜索请求以避免性能问题。它支持混合入口(定时播放片段+滚动控制)和全滚动控制两种模式,并强调在滚动结束后,最终场景能够无缝过渡为普通的、可交互的页面内容。该技能为Agent(如Claude Code、Cursor等)提供了详细的实施步骤,从分析项目上下文、准备媒体(包括解码首尾帧)、设计滚动时间线地图,到处理物体连续性(如产品从场景转移到详情页)、确保网站可访问性(包括对减少运动模式的支持)以及最终的跨浏览器和设备验证。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/itsmanuelarx/creative-web-animation-skills/tree/HEAD/skills/scroll-video-website

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

滚动视频网站 是做什么的?

将一段已批准的视觉序列转化为响应式、可逆的网站交互体验。复用现有网站的技术栈和已批准的素材;该技术不需要特定的动画库。主题、路径和目标是项目的输入。将该工作流程应用于产品旋转、室内展示、艺术作品或其他视觉故事。下落的唱片和唱机是示例,并非必需的场景。

建立交互

在编辑之前,检查当前的实现、已批准的版本和最新的用户反馈。根据此上下文解决以下问题:

  • 视频中包含哪些运动,哪些物体在代码中单独动画?
  • 滚动控制整个视频片段,还是在一个有意的定时片段之后才开始滚动?遵循所选行为。从开始即滚动的请求必须能在第一次鼠标滚轮或触摸滚动时工作,无需点击门槛。
  • 最终场景在何处变为普通页面内容?访客如何直接到达主要内容?
  • 哪些尺寸和平台是重要的,必须保留哪个预览?

如果只请求更改时序或控制,不要重新生成媒体。保存当前工作版本,并在请求比较时创建一个独立的替代版本。

准备媒体

使用精确的视频和对应的已解码的起始/结束静态帧。保留色彩解释、宽高比和源文件。如果接缝本身有问题,在通过交互效果隐藏它之前,先修复媒体的交接。

检查时长、帧率、尺寸和搜索行为。较短的关键帧间隔有助于擦洗;全关键帧副本可用于本地原型,但可能对部署来说过大。在实际浏览器中对衍生文件进行基准测试,并单独优化交付。不要为每个片段规定一种编码设置。

在元数据和帧加载时保留一张海报。保留最新请求的时间,并在视频准备好时应用它。缺失或拒绝的视频必须留下一条可用的静态路由到内容。

将滚动映射到时间轴

  1. 使用原生滚动轨道和一个粘性视觉阶段,如果它们适合现有布局。如果滚动是入口控制,保持文档立即可滚动。避免仅仅为了模拟滚动条而拦截滚轮和触摸捕获。
  2. 将选定的故事划分为有意的范围,例如物体运动、相机揭示、定格的场景、物体转移和内容。仅使用对项目有用的阶段;产品旋转不需要包括下落或房间揭示。为短暂但重要的事件分配足够的滚动距离。将每个范围映射到其媒体或变换进度;视频的秒数不需要均匀映射到滚动像素。
  3. 通过由滚动事件调度的单个 requestAnimationFrame 进行更新。在测量时读取布局,而不是在每个动画更新内重复读取。
  4. 保持视频暂停以进行擦洗。合并搜索请求:存储最新的目标,当有搜索挂起时不要开始竞争性搜索,并在 seeked 事件后应用最新的目标。不要建立过时帧的积压。
  5. 对端点进行钳制,并使用一个小的像素容差来处理分数视口计算。使用实际的浏览器滚动位置测试第一帧和最后一帧。
  6. 使停止的滚动保持当前状态。根据所选的交互反转每个阶段,包括当整个片段由滚动控制时的开场动作。
  7. 当访客进行滚轮、触摸或导航键输入时,取消编程式滚动。防止调整大小和恢复的滚动位置意外跳过开场状态。

对于混合入口,明确定义哪个片段是定时的,以及反向滚动在何处停止。不要在完全由滚动控制的体验中悄然引入定时片段。

保持摄影物体连续

在可行的情况下,通过选定的运动和交接使用一个可见的物体,例如产品移入其细节视图或艺术作品转移到画廊。如果将其重新父级化到目标上,在更改前后匹配其位置和投影。

完整的端到端翻转需要暴露边缘的 3D 旋转。平面内的旋转是不同的运动。纹理平面可以适合平面物体,如印刷品或唱片;不要将其描述为完全建模的 3D 场景。在旋转期间其轮廓发生变化的实体产品需要合适的拍摄/生成的视图或 3D 资产。

在一致的坐标系中保持源和目标测量值。当舞台是粘性时,不要混合视口和文档坐标。在调整大小时重新测量并保留有意义的进度。根据其物理原因对依赖动作进行排序。例如,如果目标是唱机,则保持唱针抬起直到唱片落下,然后在播放状态开始前将其放下。

使用匹配的照明和场景几何来混合场景边界。保持标题和内容链接可读,而不是将它们放置在视觉上杂乱图像的上方。在窄视口上,当物体旁边没有足够空间时,让内容位于物体下方。

保留网站访问

在故事中选择的点处显示导航,而不是在长影片结束后才显示。保留直接类别访问、跳过、重播和返回场景的路径。如果类别更改旨在交换物体,则与所选内容和任何依赖运动协调;快速选择应稳定在最新请求上。

不要在一个目标或其祖先处于非交互状态时聚焦该目标。先使其可交互,然后聚焦它,而无需额外的滚动跳跃。在项目对话框关闭后恢复焦点。

减少运动路径应显示可用的静态场景,无需擦洗或翻转,包括在反向滚动时。保持失败媒体状态持久化,以便反向滚动无法恢复破损的叠加层。

验证并移交

使用支持的浏览器工具测试真实输入,而不仅仅是调用内部动画函数:

  • 从新加载开始,不点击直接滚动。中途停止,继续,然后反向滚动到开头。
  • 直观检查视频/静态帧的交接以及物体到目标位置的结合。
  • 在物体过渡是设计的一部分时,通过滚动动画物体到达正确位置,并与主要内容接触。练习类别更改、跳过、重播和键盘焦点。
  • 检查桌面和手机布局,中途调整大小,减少运动模式以及故意不可用的视频。
  • 检查水平溢出、媒体加载和控制台错误。区分浏览器模拟与实际手机测试。

提供审查 URL、有用的屏幕截图、保留的基准以及任何实质性的性能或设备测试限制。保留一个简洁的清单,标识源媒体和时序。实施本地审查本身并不授权发布。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能