游戏引擎 / 系统课时
用 interface 定义角色配置
用 interface 定义角色配置
角色配置需要同时传给创建逻辑和技能系统,散落的匿名对象容易让字段名各自演化。本节定义一份角色接口,把初始血量、技能参数和可选说明放进明确的数据协议,再用创建函数把配置转换为可修改的角色状态。
学习目标
- 用 interface 表达角色与技能配置的结构。
- 正确处理可选属性与只读配置。
- 区分配置协议、运行状态和外部数据校验。
接口描述结构而非实例
interface 描述一个对象必须具有哪些字段,它不会自动创建对象,也不会在运行时留下可用来检查 JSON 的类。配置需要的是结构契约,因此适合接口;行为与可变状态则由函数或类承担,避免把配置对象直接当角色血量容器。
技能也有独立结构,嵌套接口能在访问 damage 和 cooldown 时提供明确提示。可选属性用问号表达可能不存在,读取时使用默认值或检查。readonly 可以阻止已知类型下的直接赋值,但不代表深层冻结,嵌套对象和其他别名仍需要单独考虑。
从配置创建独立状态
文件:main.ts,完整纯 TypeScript 主例程,strict 编译后执行 dist/main.js。
export {};
interface SkillConfig {
readonly id: string;
readonly damage: number;
readonly cooldown: number;
}
interface RoleConfig {
readonly id: string;
readonly maxHp: number;
readonly skill: SkillConfig;
readonly description?: string;
}
function createRole(config: RoleConfig): { id: string; hp: number } {
// 接口不限制数值范围,创建边界补上业务检查。
if (!Number.isFinite(config.maxHp) || config.maxHp <= 0) {
throw new Error('invalid maxHp');
}
return { id: config.id, hp: config.maxHp };
}
const config: RoleConfig = {
id: 'knight', maxHp: 100,
skill: { id: 'slash', damage: 20, cooldown: 1.5 },
};
const role = createRole(config);
role.hp -= 20;
// 修改运行状态不应回写配置。
console.log(`${role.id}:${role.hp}/${config.maxHp}`);
console.log(config.description ?? 'no description');预期输出:
knight:80/100
no description配置保存最大血量,运行状态保存当前血量,因此受伤后仍能显示正确分母。createRole 返回新对象,角色之间也不会共享同一个 hp 字段。若将 config 的 maxHp 直接用作当前血量,多个使用者可能相互污染,接口本身无法纠正这种职责混用。
让实现遵守同一协议
一个对象只要具有接口所需结构,就能作为参数,不必通过某个特殊构造器创建。角色策划配置和程序内测试配置可以共用这个契约。增加必填字段会让缺少它的调用点报错;这正是协议修改需要明确处理的影响范围。
可选字段不应该被用来掩盖真正必需的数据。角色 id 和 maxHp 是创建入口必需条件,不能全部改成问号再到处填默认值。description 只是显示补充信息,缺失时采用默认文本合理;技能缺失却仍创建角色,则必须由游戏规则明确决定。
外部配置另有验证入口
练习加入一个可选称号,让显示代码在未填写时使用角色 id,同时保持创建函数无须了解称号。再删去技能 damage,检查编辑器是否在配置声明处提示缺字段。这样可以观察接口约束的是哪些边界,而不是把所有逻辑都塞进接口。
从网络或存档解析的内容先视为 unknown,经过字段类型和范围检查后再返回 RoleConfig。直接写 JSON.parse(text) as RoleConfig 不执行任何检查。接口的静态规则依据 TypeScript 对象类型,运行时验证应由业务代码明确实现。