视频 → 滚动驱动着陆页
构建一个电影感着陆页,其中英雄区是随滚动播放的视频,而非按时间播放——类似 Apple 产品页面或 GitHub Copilot 着陆页。帧从源视频中提取,并在用户滚动时依次切换;在粘性英雄区下方,常规滚动的段落承载文案和行动号召按钮。
何时调用
- 用户提供视频并要求创建着陆页、滚动站点、滚动帧英雄区或基于视频的网站
- 提及“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 屏以遍历所有帧)。 - 粘性英雄区
position: sticky; top: 0; height: 100vh,包含所有绝对定位且默认隐藏的帧,仅显示当前活动帧。 - 滚动监听器计算
progress = scrolledIntoStage / scrollableHeight,取值范围 0–1。 idx = floor(progress * (N - 1))—— 将.active类切换到对应帧。- 将监听器包裹在
requestAnimationFrame中以保持 60fps。
设计规则
- 若指定了项目设计系统则使用之,否则默认使用 yuv-design-system 技能:Anton + Inter(英文)/ Rubik + Assistant(希伯来语),Fly High 紫色 (
#5E17EB) + 黄色 (#FFEC00) + 灰色 (#F1F2F2) 调色板,米白色(从不纯#fff),0px 或 999px 圆角(无 8–12px 圆角)。暖色编辑风格(粉色+黄色+米白)仅保留给 Hope/bigcats 品牌系列。 - 英雄区叠加层应微妙——一个暗角和一个大标题;不要淹没帧画面。
- 英雄区下方段落:米白背景,大号 Anton 标题,正文使用 Inter 字体 18–22px,行动号召按钮为醒目的粉色矩形搭配 Anton 文字。
- 希伯来语:尊重 RTL 布局,标题使用 Rubik 900,正文使用 Assistant 400/500。
文件参考
| 文件 | 用途 |
|---|---|
references/extract-frames.py | 基于 ffmpeg 的帧提取器;可选一键构建完整 HTML |
references/landing-template.html | 包含滚动机制的自包含着陆页骨架 |
references/design-notes.md | 排版、调色板和动效默认值 |