createEmptyFigure()

创建空角色，仅有名字和对话功能，无视觉表现。适用于旁白、系统提示等场景。

函数签名


createEmptyFigure(id: string, props: {
  name: string;
  avatar?: string;
}): EmptyFigure

参数

参数	类型	描述
`id`	`string`	角色唯一标识
`name`	`string`	角色名称
`avatar`	`string?`	头像路径（可选）

基础用法


const narrator = createEmptyFigure("narrator", {
  name: "旁白",
});
 
const npc = createEmptyFigure("npc", {
  name: "路人甲",
  avatar: "/avatars/npc.png"
});

使用示例


// 在场景中使用
narrator.speak`这是一个故事的开始...`;
npc.speak`你好，旅行者！`;
 
// 带语音的对话
npc.speak({
  speechUrl: "/audio/vocal/greeting.wav"
})`欢迎光临！`;

可用方法

方法	描述
`.speak()`	显示对话

与其他角色类型的区别

类型	视觉表现	适用场景
EmptyFigure	无	旁白、系统提示、NPC对话
ImageFigure	图片	立绘角色
Live2dFigure	Live2D模型	动态角色