视频 → 滚动驱动着陆页
构建一个电影感着陆页,其中 Hero 区域不再是按时间播放视频,而是随滚动播放——就像 Apple 产品页面或 GitHub Copilot 着陆页那样。从源视频中提取帧,并在用户滚动时切换显示;粘性 Hero 区域下方是正常滚动的文案和行动号召区域。
何时调用
- 用户提供视频并请求着陆页、滚动网站、滚动帧 Hero 或从视频生成网站
- 提到“Apple 风格滚动”、“GitHub Copilot 着陆页”、“按帧滚动”、“滚动帧”
- 希伯来语对应表达:"דף נחיתה מסרטון", "אתר עם גלילה", "סרטון בגלילה"
保存位置
默认: ~/Documents/yuv-projects/landings/<slug>/ ——始终将着陆页保存至此,以便后续查找。如父目录缺失,请先创建。
mkdir -p ~/Documents/yuv-projects/landings
cd ~/Documents/yuv-projects/landings
# 在此处创建 <slug>/ 目录
最终路径:~/Documents/yuv-projects/landings/<slug>/。每次构建完成后告知用户着陆页的存放位置。
工作流程(8 步)
- 探测源文件 —— 使用
ffprobe获取时长、帧率、分辨率、音频信息。 - 选择帧数 —— 默认
80。下限40(低于此值会显得卡顿),上限160(页面过重)。按时长选择:≤10 秒 → 50,10–30 秒 → 80,30–60 秒 → 120,>60 秒 → 160。 - 确定输出目录 —— 默认
~/Documents/yuv-projects/landings/<slug>/。<slug>应简短,源自视频文件名或主题。仅在明确要求时覆盖。 - 提取帧 —— 运行
references/extract-frames.py <source-video> <output-dir> [count]。输出为output-dir/frames/f_0001.jpg……使用一致的 JPG 质量 82 和最大宽度 1920(如果源视频分辨率更大则缩小)。 - 复制并定制
references/landing-template.html到output-dir/index.html:- 将
__FRAMES__占位符替换为每个帧的<img>标签(当你传递--build-html时,构建脚本会自动完成)。 - 填写
__HEADLINE__、__TAGLINE__、__CTA_TEXT__、__CTA_HREF__和各个区块。 - 对于希伯来语内容:设置
<html lang="he" dir="rtl">并将字体切换为 Rubik/Assistant(参见references/design-notes.md)。
- 将
- 优化帧 —— 构建脚本已缩放到最大宽度 1920px。如果页面总大小超过 12 MB,则将质量降低到 75 或减少帧数。
- 预览 —— 在输出目录内执行
python -m http.server,然后打开http://localhost:8000。在性能较好的机器上滚动体验非常流畅。 - 部署 —— 将文件夹拖放到 Vercel/Netlify/Cloudflare Pages 上。无需构建步骤。
滚动机制
- 外部滚动容器
.scroll-stage高度设置为视口单位(默认600vh= 滚动 5 屏以遍历所有帧)。 - 粘性 Hero
position: sticky; top: 0; height: 100vh,包含所有绝对定位且隐藏的帧,仅显示当前活动的帧。 - 滚动监听器计算
progress = scrolledIntoStage / scrollableHeight,范围限制在 0–1 之间。 idx = floor(progress * (N - 1))—— 将.active类切换到该帧。- 将监听器包装在
requestAnimationFrame中以保持 60fps。
设计规则
- 如果项目是 YUV.AI 品牌(Yuval 个人、其作品集、其品牌):调用
yuv-design-system并根据媒介锁定模式——- 霓虹模式(YUV.AI 网页的默认模式):亮粉色 (
#FF1464) + 霓虹青色 (#00E5FF) + 白色或深黑色画布。Anton + Inter(英文)/ Rubik + Assistant(希伯来文)。边框圆角 0px 或 999px。 - 暖色编辑模式:仅用于 Hope、Marcus、bigcats.ai、practical.yuv.ai —— 粉色 + 黄色 + 骨白,使用非纯白色
#fff。 - 切勿在着陆页使用 Decks 模式(Fly High 紫色/黄色) —— 该调色板仅用于幻灯片。
- 霓虹模式(YUV.AI 网页的默认模式):亮粉色 (
- 如果项目不是 YUV.AI 品牌:不要应用 yuv-design-system。选择适合源视频氛围的调色板。Anton + Inter 仍然是合理的默认选择,但不是强制要求。
- Hero 叠加元素应微妙 —— 一点点渐晕和一行大标题;不要淹没画面。
- Hero 下方区块:浅色画布(霓虹模式下为白色,暖色编辑模式下为米白色,通用暖色风格则用骨白),大号 Anton 标题,正文用 Inter 18–22px,行动号召按钮为锐利药丸形状(
border-radius: 999px)—— 霓虹模式下使用粉色填充,其他情况使用品牌色。 - 希伯来语:遵循 RTL,标题使用 Rubik 900,正文使用 Assistant 400/500。
文件引用
| 文件 | 用途 |
|---|---|
references/extract-frames.py | 基于 ffmpeg 的帧提取器;可选地一次性构建完整 HTML |
references/landing-template.html | 包含滚动机制的自包含着陆页骨架 |
references/design-notes.md | 字体、调色板和动效默认值 |