之前做国漫风格H5项目时,被《时光代理人》那种红蓝撞色、照片记忆美学和“控制时间”的氛围感一直念念不忘。寻思着要是把它做成一个可交互的游戏界面,应该会很有意思。不过这类基于动画IP的练习demo,最怕的就是素材版权问题:直接抠动画截图当背景、直接用角色立绘做按钮,都不太妥当。更好的做法是提取“红蓝时间悖论”、“照片Flashback”、“双主角切换”这些视觉与交互概念,用CSS渐变、滤镜、状态机和布局设计去还原气质,而不是直接搬运美术资源。
本文会从0到1拆解两个版本的实现:一个纯HTML/CSS的“视觉稿先行版”,适合快速看效果和调布局;一个基于React的“交互逻辑版”,专门处理三选一分支、拍照定格和倒计时状态机。全程包含可直接复制的代码、运行步骤和排错思路,新手能跟着搭,有基础的可以直接拿核心代码去改。
1. 游戏界面设计思路:从IP视觉元素到可交互组件
1.1 界面核心情绪板
《时光代理人》的故事核心围绕“进入照片、操控时间、改变因果”展开。做游戏界面时要抓住三个关键词:
- 红蓝双色:代表两位主角程小时(偏红/热情)与陆光(偏蓝/冷静)的能力互补,也暗示时间线的交错与冲突。
- 照片记忆:大量场景以旧照片、宝丽来相纸、胶卷颗粒质感出现,是“进入过去”的媒介。
- 时间暂停感:界面在等待玩家操作时,应该有一种“时间暂停”的凝固感,比如闪烁的倒计时、停滞的指针、悬浮的碎片。
我们可以把这三个关键词映射成具体的UI元素:
| 视觉关键词 | UI映射 | 技术实现思路 |
|---|---|---|
| 红蓝双色 | 主按钮渐变、文本强调、边框光线 | CSS线性渐变+动态光晕动画 |
| 照片记忆 | 背景网格、相纸边框、像素噪点 | CSS滤镜+SVG噪点纹理 |
| 时间暂停 | 倒计时进度条、胶囊切换动效、粒子漂浮 | JavaScript定时器+CSS transform |
1.2 游戏流程定义
一个完整的“时光代理人”风格游戏界面,至少需要四个状态界面:
- 开场/标题界面:展示游戏名称、双主角切换提示。
- 照片选择界面:玩家从若干张“记忆照片”中选择一张进入。
- 事件回溯界面:进入照片内部,展示线索、倒计时和选项分支。
- 结局定格界面:根据选择生成“拍立得”风格结果卡片,可以重玩。
为了让手感接近动画叙事,交互上增加两个核心动作:
- 时间暂停:玩家可在事件回溯界面点击“暂停时间”,系统倒计时停止,并浮现隐藏线索。
- 拍照定格:结局界面通过“快门”动效,把当前画面定格成一张宝丽来相纸。
1.3 技术选型说明
游戏界面本质上是一个“强视觉 + 中交互”的前端工程。两个版本的选型:
| 版本 | 技术栈 | 适用场景 |
|---|---|---|
| 视觉稿版 | HTML + CSS + 原生JS | 快速验证布局、调颜色、看动效 |
| 逻辑功能版 | React + Vite + CSS Modules | 细化交互状态、分支选择、状态机管理 |
React版本并不是必须的。如果只是做一个展示型页面,纯HTML/CSS其实更快。但既然涉及三选一分支、倒计时、拍照定格等跨组件状态管理,使用React更利于维护。下面先从视觉稿开始,把“皮”做好,再切到React版本把“骨”搭好。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与项目说明
2.1 基础环境需求
不需要复杂的服务端环境。建议本地安装:
- Node.js 18+ (仅React版本需要,用于Vite开发服务器)
- 现代浏览器(Chrome / Edge / Firefox最新版)
- 任意代码编辑器(VS Code即可)
纯HTML版本可以直接双击文件运行,或者使用VS Code的Live Server插件启动。React版本需要Node环境,通过npm安装依赖。
版本需要根据你的项目实际情况调整,本文示例以常见环境为例,重点演示配置思路。如果你本地Node版本较低,建议先升级或使用nvm管理版本。
2.2 整体项目结构
code复制time-agent-game/
├── html-version/ # 纯HTML/CSS视觉稿版本
│ ├── index.html
│ ├── css/
│ │ └── style.css
│ └── js/
│ └── main.js
└── react-version/ # React交互逻辑版本
├── package.json
├── vite.config.js
├── index.html
└── src/
├── main.jsx
├── App.jsx
├── components/
│ ├── TitleScreen.jsx
│ ├── PhotoSelect.jsx
│ ├── FlashbackScene.jsx
│ └── EndingCard.jsx
├── hooks/
│ └── useCountdown.js
└── styles/
└── game.css
2.3 版本声明与素材版权注意
《时光代理人》是上海泛色克文化传播有限公司等出品的原创网络动画,相关剧照、原画、角色形象均受版权保护。
本文代码中不会使用任何官方图片素材。所有视觉效果均通过CSS渐变、滤镜、文字和几何图形实现。如果读者希望更还原,建议使用自己绘制的同人素材、原创像素画或替换为无版权图库照片,在非商用练习范围内使用,并注意来源说明。
3. 红蓝时间线视觉体系:CSS实现核心拆解
3.1 动态红蓝渐变与时间线背景
整个界面最核心的视觉记忆点就是红蓝分割。在CSS中可以使用linear-gradient配合background-blend-mode模拟出“时间线撕裂”的效果。
先看一个最基础的红色与蓝色渐变背景:
css复制/* 文件路径:html-version/css/style.css */
body {
margin: 0;
min-height: 100vh;
font-family: 'PingFang SC', 'Microsoft YaHei', sans-serif;
background: linear-gradient(
135deg,
#d62828 0%,
#d62828 45%,
#1d3557 55%,
#1d3557 100%
);
overflow: hidden;
}
这个渐变让页面左右两侧呈现明显视觉割裂。为了让过渡更自然,可以在中间加入一条“时间裂痕”光线:
css复制.time-rift {
position: fixed;
top: 0;
bottom: 0;
left: 50%;
width: 2px;
background: linear-gradient(to bottom, rgba(255,255,255,0.2), #fff, rgba(255,255,255,0.2));
transform: translateX(-50%);
animation: riftPulse 3s ease-in-out infinite;
z-index: 10;
}
@keyframes riftPulse {
0%, 100% { opacity: 0.4; box-shadow: 0 0 6px rgba(255,255,255,0.3); }
50% { opacity: 1; box-shadow: 0 0 20px rgba(255,255,255,0.9); }
}
这里通过riftPulse动画让中间的白色光线周期性脉动,模拟时间线被强行撕开的感觉。
3.2 照片记忆质感:相纸边框与噪点
照片记忆感要分两层:外层的白色相纸边框和内层的成像颗粒感。
相纸边框常见做法是给图片容器加白色内边距和阴影:
css复制.polaroid-frame {
background: #f5f0e8;
padding: 12px 12px 40px 12px;
box-shadow:
0 4px 12px rgba(0, 0, 0, 0.4),
0 1px 2px rgba(255, 255, 255, 0.3) inset;
transform: rotate(-2deg);
transition: transform 0.3s ease;
}
.polaroid-frame:hover {
transform: rotate(0deg) scale(1.02);
}
噪点效果可以用SVG的feTurbulence滤镜实现。在HTML中嵌入一个内联SVG,并通过CSS的filter: url()引用:
html复制<svg width="0" height="0" style="position:absolute">
<filter id="noiseFilter">
<feTurbulence type="fractalNoise" baseFrequency="0.8" numOctaves="3" stitchTiles="stitch"/>
<feColorMatrix type="matrix" values="0 0 0 0 0, 0 0 0 0 0, 0 0 0 0 0, 0 0 0 0.15 0"/>
</filter>
</svg>
css复制.photo-content {
filter: url(#noiseFilter) sepia(0.2) contrast(1.1) saturate(0.9);
}
sepia滤镜配合SVG噪点,可以非常接近老照片成像质感。注意feColorMatrix中的透明度值不宜过高,否则照片内容会看不清。
3.3 双主角状态指示器
游戏界面上需要明确提示玩家当前操控的角色。我们用两个胶囊型指示器表示“程小时”与“陆光”。红方激活时右侧高亮,蓝方激活时左侧高亮:
html复制<div class="agent-switch">
<div class="agent left active">程小时</div>
<div class="agent right">陆光</div>
</div>
css复制.agent-switch {
display: flex;
background: rgba(0, 0, 0, 0.5);
border-radius: 999px;
padding: 4px;
width: 240px;
backdrop-filter: blur(4px);
border: 1px solid rgba(255, 255, 255, 0.2);
}
.agent {
flex: 1;
text-align: center;
padding: 8px 0;
border-radius: 999px;
color: rgba(255, 255, 255, 0.6);
transition: all 0.4s cubic-bezier(0.4, 0, 0.2, 1);
cursor: pointer;
}
.agent.active {
color: #fff;
font-weight: 600;
}
.agent.left.active {
background: linear-gradient(135deg, #d62828, #e85d04);
box-shadow: 0 0 16px rgba(214, 40, 40, 0.6);
}
.agent.right.active {
background: linear-gradient(135deg, #1d3557, #457b9d);
box-shadow: 0 0 16px rgba(29, 53, 87, 0.6);
}
这里利用了backdrop-filter: blur(4px)实现毛玻璃质感,配合透明面板,营造“时间暂停”时空气凝固但界面依然通透的感觉。
4. 完整实战:纯HTML/CSS/JS构建时光倒流选择界面
4.1 页面结构与布局流程
这个版本的目标是实现“进入游戏 -> 选择照片 -> 倒计时回溯 -> 拍立得结局”的完整闭环。所有素材用CSS几何图形代替。
在index.html中,页面主体分为四个section:标题区、照片选择区、事件回溯区、结局区。
html复制<!-- 文件路径:html-version/index.html -->
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>时光代理人 - 游戏界面演示</title>
<link rel="stylesheet" href="css/style.css">
</head>
<body>
<div class="time-rift"></div>
<div class="bg-particles" id="particlesContainer"></div>
<!-- 标题界面 -->
<section id="titleScreen" class="screen active">
<div class="title-logo">
<h1>时 光 代 理 人</h1>
<p>Time Agent</p>
</div>
<div class="title-sub">每一次进入照片,都将改变未来。</div>
<button class="btn-primary" id="enterBtn">进入任务</button>
<div class="agent-switch">
<div class="agent left active">程小时</div>
<div class="agent right">陆光</div>
</div>
</section>
<!-- 照片选择界面 -->
<section id="photoSelect" class="screen">
<h2>选择一张记忆照片</h2>
<div class="photo-grid">
<div class="polaroid-frame" data-scene="老街">
<div class="photo-content scene-a"></div>
<p class="photo-caption">老街钟表店</p>
</div>
<div class="polaroid-frame" data-scene="校园">
<div class="photo-content scene-b"></div>
<p class="photo-caption">废弃教室</p>
</div>
<div class="polaroid-frame" data-scene="天台">
<div class="photo-content scene-c"></div>
<p class="photo-caption">天台日落</p>
</div>
</div>
</section>
<!-- 事件回溯界面 -->
<section id="flashback" class="screen">
<div class="flashback-header">
<div class="agent-switch">
<div class="agent left active">程小时</div>
<div class="agent right">陆光</div>
</div>
<div class="timer-bar">
<div class="timer-fill" id="timerFill"></div>
</div>
<span class="timer-text" id="timerText">10s</span>
</div>
<div class="scene-area" id="sceneArea">
<h3 id="sceneTitle">老街钟表店</h3>
<p id="sceneDesc">你进入了照片中的午后钟表店。空气里满是旧木与机油的气味,墙上的挂钟全部停在3点17分。</p>
<div class="clue-box" id="clueBox">
<span>🔍 线索提示:尝试使用“时间暂停”会发现隐藏细节。</span>
</div>
</div>
<div class="choice-area">
<button class="choice-btn" data-idx="0">检查柜台下的旧抽屉</button>
<button class="choice-btn" data-idx="1">抬头望着静止的吊钟</button>
<button class="choice-btn" data-idx="2">走向后门的走廊</button>
</div>
<button class="btn-pause" id="pauseBtn">⏸ 暂停时间</button>
</section>
<!-- 结局界面 -->
<section id="ending" class="screen">
<div class="polaroid-frame ending-card">
<div class="photo-content ending-photo" id="endingPhoto"></div>
<p class="ending-title" id="endingTitle">结局:未被修改的过去</p>
<p class="ending-desc" id="endingDesc"></p>
</div>
<button class="btn-primary" id="restartBtn">再次进入照片</button>
</section>
<script src="js/main.js"></script>
</body>
</html>
4.2 完整CSS样式
这里需要先设定各个屏的状态切换逻辑:.screen默认display: none,只有.active才显示。
css复制.screen {
display: none;
width: 100vw;
height: 100vh;
position: absolute;
top: 0;
left: 0;
justify-content: center;
align-items: center;
flex-direction: column;
box-sizing: border-box;
padding: 20px;
text-align: center;
}
.screen.active {
display: flex;
}
照片背景区域用纯CSS生成三种不同场景:老街、教室、天台,通过径向渐变和大色块区分:
css复制.scene-a {
background:
radial-gradient(circle at 20% 40%, rgba(255, 220, 150, 0.3), transparent 35%),
linear-gradient(90deg, #6b4f3e 20%, #a07a5a 40%, #7a5a42 80%);
height: 180px;
}
.scene-b {
background:
linear-gradient(0deg, #2c3e50 30%, #bdc3c7 30%, #ecf0f1 100%);
height: 180px;
}
.scene-c {
background:
linear-gradient(180deg, #ff9a56 0%, #f76b1c 60%, #2c3e50 100%);
height: 180px;
}
4.3 JavaScript核心逻辑
JS部分主要实现四个动作:
- 标题界面进入照片选择界面。
- 点击照片进入事件回溯界面,根据场景切换文案。
- 倒计时从10秒开始,归零后跳转结局。
- “暂停时间”按钮冻结倒计时,并显示额外线索。
javascript复制// 文件路径:html-version/js/main.js
const titleScreen = document.getElementById('titleScreen');
const photoSelect = document.getElementById('photoSelect');
const flashback = document.getElementById('flashback');
const ending = document.getElementById('ending');
const enterBtn = document.getElementById('enterBtn');
const restartBtn = document.getElementById('restartBtn');
const pauseBtn = document.getElementById('pauseBtn');
const timerFill = document.getElementById('timerFill');
const timerText = document.getElementById('timerText');
const sceneTitle = document.getElementById('sceneTitle');
const sceneDesc = document.getElementById('sceneDesc');
const clueBox = document.getElementById('clueBox');
let countdown = 10;
let timerId = null;
let isPaused = false;
let currentScene = '';
const sceneData = {
'老街': {
title: '老街钟表店',
desc: '你进入了照片中的午后钟表店。空气里满是旧木与机油的气味,墙上的挂钟全部停在3点17分。',
hiddenClue: '柜台角落的账本上,写着今天凌晨3点17分有一笔奇怪预约。',
ending: '结局:未被修改的过去。钟表店的风铃没有响,一切如旧。'
},
'校园': {
title: '废弃教室',
desc: '教室后排的黑板上残留着半句粉笔字:“不要打开那扇门”。阳光穿过窗帘的破洞落在地板上。',
hiddenClue: '黑板下方压着一张褪色的值日表,日期显示下周一。',
ending: '结局:门被推开前,你选择停下脚步。'
},
'天台': {
title: '天台日落',
desc: '下午五点半的天台,远处广播体操音乐刚结束。栏杆上的锁刻着两个名字。',
hiddenClue: '锁的背面还刻着一串日期,是明天。',
ending: '结局:你被夕阳晃了一下眼睛,没能看清那张脸。'
}
};
function showScreen(screen) {
[titleScreen, photoSelect, flashback, ending].forEach(s => s.classList.remove('active'));
screen.classList.add('active');
}
function startGame() {
showScreen(photoSelect);
}
function enterScene(sceneName) {
currentScene = sceneName;
const data = sceneData[sceneName];
sceneTitle.textContent = data.title;
sceneDesc.textContent = data.desc;
clueBox.style.display = 'none';
showScreen(flashback);
startTimer();
}
function startTimer() {
clearInterval(timerId);
countdown = 10;
isPaused = false;
pauseBtn.textContent = '⏸ 暂停时间';
updateTimerUI();
timerId = setInterval(() => {
if (isPaused) return;
countdown -= 1;
updateTimerUI();
if (countdown <= 0) {
clearInterval(timerId);
finishGame();
}
}, 1000);
}
function updateTimerUI() {
timerText.textContent = `${countdown}s`;
timerFill.style.width = `${countdown * 10}%`;
}
function togglePause() {
isPaused = !isPaused;
pauseBtn.textContent = isPaused ? '▶ 恢复时间' : '⏸ 暂停时间';
if (isPaused) {
clueBox.style.display = 'block';
const hiddenClue = sceneData[currentScene].hiddenClue;
clueBox.innerHTML = `<span>🔍 ${hiddenClue}</span>`;
}
}
function finishGame() {
const data = sceneData[currentScene];
const endingPhoto = document.getElementById('endingPhoto');
const endingTitle = document.getElementById('endingTitle');
const endingDesc = document.getElementById('endingDesc');
endingTitle.textContent = data.ending.split('。')[0] + '。';
endingDesc.textContent = data.ending;
endingPhoto.className = 'photo-content ending-photo ' + getSceneClass(currentScene);
showScreen(ending);
}
function getSceneClass(sceneName) {
if (sceneName === '老街') return 'scene-a';
if (sceneName === '校园') return 'scene-b';
if (sceneName === '天台') return 'scene-c';
return 'scene-a';
}
enterBtn.addEventListener('click', startGame);
restartBtn.addEventListener('click', () => showScreen(photoSelect));
document.querySelectorAll('.polaroid-frame').forEach(frame => {
frame.addEventListener('click', () => {
const sceneName = frame.dataset.scene;
enterScene(sceneName);
});
});
pauseBtn.addEventListener('click', togglePause);
4.4 运行验证
用Live Server启动后,依次执行:
- 点击“进入任务”,显示照片选择界面。
- 三张拍立得卡片悬停时轻微水平校正,点击任意一张。
- 进入回溯界面,倒计时从10s开始递减,进度条同步变短。
- 点击“暂停时间”,倒计时停止,推迟出的线索框出现。
- 倒计时归零后,进入结局界面,显示拍立得卡片与结局文本。
- 点击“再次进入照片”,回到照片选择界面。
整个过程没有使用任何外部图片资源,但视觉上已经具备“时光定格”的观感。
5. 进阶交互代码:React 版本的状态机与分支选择
纯HTML版本适合展示和走查,但遇到需要复杂状态管理、分支影响结局的情况,建议迁移到React版本。
5.1 定义游戏状态机
在React中,我们可以用一个状态字段表示当前所处的界面阶段:
javascript复制const GAME_STATE = {
TITLE: 'TITLE',
PHOTO_SELECT: 'PHOTO_SELECT',
FLASHBACK: 'FLASHBACK',
ENDING: 'ENDING'
};
再定义一个照片场景配置,包含倒计时时长、三个分支选项和不同结局:
javascript复制export const sceneConfig = {
'老街钟表店': {
type: 'clock',
subtitle: '午后3点17分的钟声即将响起',
options: [
{ text: '检查柜台下的旧抽屉', next: 'good', desc: '你找到一封没有署名的信,收件人写着自己的名字。' },
{ text: '抬头望着静止的吊钟', next: 'neutral', desc: '吊钟背后传来轻微的齿轮转动声。' },
{ text: '走向后门的走廊', next: 'bad', desc: '走廊尽头地板上的相框裂痕突然扩大。' }
]
},
'废弃教室': {
type: 'school',
subtitle: '黑板上的粉笔字在慢慢消失',
options: [
{ text: '擦掉黑板上的字迹', next: 'good', desc: '粉笔灰落下时,窗外传来迟到的上课铃。' },
{ text: '翻开讲台的笔记本', next: 'neutral', desc: '笔记本里夹着半张运动会合影。' },
{ text: '推开那扇门', next: 'bad', desc: '门后是一间空房间,却有人刚刚坐过的余温。' }
]
},
'天台日落': {
type: 'rooftop',
subtitle: '夕阳把影子拉得很长',
options: [
{ text: '转身离开天台', next: 'good', desc: '你决定不让今天的遗憾留下。' },
{ text: '盯着栏杆上的双人锁', next: 'neutral', desc: '锁上刻着两个人的名字,以及昨天。' },
{ text: '朝楼下望去', next: 'bad', desc: '楼下操场空无一人,但广播在播报今天的日期。' }
]
}
};
5.2 实现倒计时自定义Hook
在React中,把倒计时逻辑抽成useCountdown,方便在组件中复用,也可以搭配暂停条件:
javascript复制// 文件路径:react-version/src/hooks/useCountdown.js
import { useEffect, useRef, useState, useCallback } from 'react';
export function useCountdown(initialSeconds, onComplete) {
const [secondsLeft, setSecondsLeft] = useState(initialSeconds);
const [isPaused, setIsPaused] = useState(false);
const timerRef = useRef(null);
const start = useCallback(() => {
clearInterval(timerRef.current);
setSecondsLeft(initialSeconds);
setIsPaused(false);
}, [initialSeconds]);
const reset = useCallback(() => {
clearInterval(timerRef.current);
setSecondsLeft(initialSeconds);
setIsPaused(false);
}, [initialSeconds]);
useEffect(() => {
if (isPaused || secondsLeft <= 0) return;
timerRef.current = setInterval(() => {
setSecondsLeft(prev => {
if (prev <= 1) {
clearInterval(timerRef.current);
onComplete();
return 0;
}
return prev - 1;
});
}, 1000);
return () => clearInterval(timerRef.current);
}, [isPaused, secondsLeft, onComplete]);
return { secondsLeft, isPaused, start, reset, setIsPaused };
}
5.3 编写FlashbackScene组件
FlashbackScene组件负责展示照片内容、倒计时、分支选项和暂停按钮:
javascript复制// 文件路径:react-version/src/components/FlashbackScene.jsx
import { useEffect, useRef, useState } from 'react';
import { useCountdown } from '../hooks/useCountdown';
import { sceneConfig } from '../gameConfig';
export default function FlashbackScene({ sceneKey, onFinish, onReturnSelect }) {
const config = sceneConfig[sceneKey];
const [selectedIndex, setSelectedIndex] = useState(null);
const [extraClue, setExtraClue] = useState('');
const { secondsLeft, isPaused, setIsPaused } = useCountdown(10, () => {
finishGame();
});
function finishGame() {
onFinish({
sceneKey,
optionIndex: selectedIndex,
optionDesc: selectedIndex !== null ? config.options[selectedIndex].desc : '',
timeout: selectedIndex === null,
});
}
function handlePause() {
setIsPaused(prev => !prev);
if (!isPaused && selectedIndex !== null) {
setExtraClue('你注意到了暂停时浮现的提示文字,时间似乎被“某个人”注视着。');
}
}
function handleChoice(index) {
setSelectedIndex(index);
setTimeout(finishGame, 600);
}
return (
<div className="screen active game-flashback">
<div className="flashback-header">
<div className="agent-switch">
<span className="agent left active">程小时</span>
<span className="agent right">陆光</span>
</div>
<div className="timer-bar">
<div className={`timer-fill ${secondsLeft <= 3 ? 'danger' : ''}`}
style={{ width: `${secondsLeft * 10}%` }}></div>
</div>
<span className="timer-text">{secondsLeft}s</span>
</div>
<div className={`scene-visual type-${config.type}`}></div>
<h3>{sceneKey}</h3>
<p className="scene-subtitle">{config.subtitle}</p>
{extraClue && <div className="clue-box">{extraClue}</div>}
<div className="choice-area">
{config.options.map((opt, idx) => (
<button
key={idx}
className={`choice-btn ${selectedIndex === idx ? 'selected' : ''}`}
onClick={() => handleChoice(idx)}
disabled={selectedIndex !== null}
>
{opt.text}
</button>
))}
</div>
<div className="action-row">
<button className="btn-pause" onClick={handlePause}>
{isPaused ? '▶ 恢复时间' : '⏸ 暂停时间'}
</button>
<button className="btn-ghost" onClick={onReturnSelect}>返回选照片</button>
</div>
</div>
);
}
5.4 App.jsx 串联全局状态
在App.jsx中,通过一个gameState对象控制当前显示哪个组件:
javascript复制// 文件路径:react-version/src/App.jsx
import { useState } from 'react';
import TitleScreen from './components/TitleScreen';
import PhotoSelect from './components/PhotoSelect';
import FlashbackScene from './components/FlashbackScene';
import EndingCard from './components/EndingCard';
const GAME_STATE = {
TITLE: 'TITLE',
PHOTO_SELECT: 'PHOTO_SELECT',
FLASHBACK: 'FLASHBACK',
ENDING: 'ENDING'
};
export default function App() {
const [gameState, setGameState] = useState(GAME_STATE.TITLE);
const [selectedScene, setSelectedScene] = useState(null);
const [endingResult, setEndingResult] = useState(null);
function enterGame() {
setGameState(GAME_STATE.PHOTO_SELECT);
}
function chooseScene(sceneKey) {
setSelectedScene(sceneKey);
setGameState(GAME_STATE.FLASHBACK);
}
function handleFinish(result) {
setEndingResult(result);
setGameState(GAME_STATE.ENDING);
}
function restart() {
setGameState(GAME_STATE.PHOTO_SELECT);
setSelectedScene(null);
setEndingResult(null);
}
return (
<div className="game-wrapper">
{gameState === GAME_STATE.TITLE && <TitleScreen onEnter={enterGame} />}
{gameState === GAME_STATE.PHOTO_SELECT && <PhotoSelect onChoose={chooseScene} />}
{gameState === GAME_STATE.FLASHBACK && (
<FlashbackScene
sceneKey={selectedScene}
onReturnSelect={() => setGameState(GAME_STATE.PHOTO_SELECT)}
onFinish={handleFinish}
/>
)}
{gameState === GAME_STATE.ENDING && (
<EndingCard result={endingResult} onRestart={restart} />
)}
</div>
);
}
5.5 React版本运行
在react-version目录下执行:
bash复制npm install
npm run dev
浏览器打开Vite输出的本地地址,即可体验完整的React版本流程。相比HTML版本,React版本的优势在于:分支选项选中后会短暂顿挫再进入结局,倒计时归零或选完分支都能触发结局,暂停时间与选分支交互可以叠加,方便继续扩展结局分支。
6. 常见问题与排查思路
在复现这类游戏界面时,最容易踩的坑基本集中在计时器、CSS滤镜、组件状态三块。
| 问题现象 | 常见原因 | 解决思路 |
|---|---|---|
| React版本倒计时不触发结局 | useEffect依赖缺失或cleanup覆盖定时器 | 检查useCountdown中onComplete是否在依赖数组,必要时使用ref缓存回调 |
| 浏览器滤镜无效 | SVG滤镜没有内联在HTML中,或filter: url(#id)作用在没有尺寸的元素上 |
添加内联SVG,确保被过滤元素有明确宽高 |
| 点击照片后无法进入回溯 | 事件监听绑定时元素尚未渲染 | 纯HTML版改为在DOMContentLoaded之后绑定事件;React版直接交给onClick |
| 倒计时和暂停按钮状态不同步 | 多个组件共享状态但未提升 | 把isPaused与secondsLeft提升到父组件,或用全局store |
| 相纸卡片渲染过慢 | 大量CSS滤镜叠加导致GPU占用过高 | 为卡片添加will-change: transform,或减少噪点层的尺寸 |
| 本地打开HTML时背景图片不显示 | 相对路径不对或跨域限制 | 纯HTML版不要依赖本地大图,直接使用渐变与CSS图形替代 |
另外,如果要在生产环境复用这套界面,需要注意:
- 倒计时建议使用基于
Date.now()的时间戳差,而不是单纯setInterval计数,避免浏览器切换标签时定时器延迟。 - 照片选择界面如果使用真实图片,建议统一压缩为WebP,并设置
loading="lazy"。 - 所有交互按钮需要支持键盘操作,至少要让Tab键可以聚焦,避免纯粹依赖鼠标点击。
7. 工程化建议与扩展方向
这个项目定位是“界面演示”,如果要真正产品化,还有几个方向值得继续优化:
7.1 状态管理升级
目前React版本用useState串联游戏状态,场景数量增多后容易产生混乱。建议将gameState、selectedScene、endingResult抽成一个useReducer,让每个状态转移更透明:
javascript复制function gameReducer(state, action) {
switch (action.type) {
case 'ENTER_GAME': return { ...state, stage: 'PHOTO_SELECT' };
case 'CHOOSE_SCENE': return { ...state, stage: 'FLASHBACK', scene: action.payload };
case 'FINISH': return { ...state, stage: 'ENDING', result: action.payload };
case 'RESTART': return { ...state, stage: 'PHOTO_SELECT', scene: null, result: null };
default: return state;
}
}
7.2 声音与动效反馈
游戏界面只有视觉不够,建议增加简单的声音反馈。点击照片时播放快门声,暂停时间时播放低频“滋滋”的倒带声。使用Web Audio API可以免素材生成基础音效:
javascript复制const audioCtx = new AudioContext();
function playShutter() {
const buffer = audioCtx.createBuffer(1, 0.1 * audioCtx.sampleRate, audioCtx.sampleRate);
const data = buffer.getChannelData(0);
for (let i = 0; i < data.length; i++) {
data[i] = (Math.random() * 2 - 1) * (1 - i / data.length);
}
const source = audioCtx.createBufferSource();
source.buffer = buffer;
source.connect(audioCtx.destination);
source.start();
}
7.3 面向移动端的适配
HTML版本默认使用100vw / 100vh,在移动端需要处理地址栏伸缩问题。建议把容器改为100dvh,同时适配安全区:
css复制.screen {
height: 100vh;
height: 100dvh;
padding-top: env(safe-area-inset-top);
padding-bottom: env(safe-area-inset-bottom);
}
7.4 照片记忆动态效果
更进一步,可以使用CSS的clip-path动画模拟照片撕碎的边角,也可以结合CSS变量让照片背景颜色随时间线切换而变化。这里给出一个撕边效果思路:
css复制.photo-content {
clip-path: polygon(2% 0%, 98% 1%, 100% 8%, 99% 45%, 100% 92%, 95% 99%, 3% 98%, 0% 93%, 1% 50%, 0% 5%);
}
8. 总结与下一步
至此,我们已经完成了一个致敬《时光代理人》视觉气质的游戏界面。从纯HTML版本的快速原型,到React版本的分支状态管理,整套流程拆解了红蓝时间线配色、照片记忆质感、双角色状态指示器、倒计时交互、暂停互动、结局分叉这些核心模块。
如果只是做个静态展示页面,直接使用HTML/CSS版就足够;如果想要做真正的多分支剧情游戏,建议把React版本中的状态机、倒计时Hook和结局判断逻辑全部抽成独立模块,再接入实际素材与剧情配置。
下一步可以继续尝试三个方向:
- 把三选一扩展成多分支树,结局数量从3个增加到10个以上。
- 加入角色头像与对话文本,形成完整的剧情事件链。
- 引入本地缓存,让玩家可以查看已经解锁的不同结局。
动手敲一遍代码,比看十遍教程更有用。建议先把HTML版本跑通,再对照React版本看状态迁移,动手改几个场景词条和结局文案,感觉会完全不一样。如果本文对你有帮助,可以收藏备用,后续我也会继续分享游戏界面动效与React状态管理的实战技巧。
