---
title: "玩家界面"
description: "玩家界面就是玩家看到的画面。从片头、状态面板、背包和地图的现成模板开始，接上按钮，不用写代码。"
---

# 玩家界面

玩家界面就是玩家玩的时候实际看到的画面。不动它的话，就是默认的聊天界面。想给你的卡加一个开局页、状态面板、背包或地图，就在这里搭，**不用写代码**。

有两个入口：点顶栏中间的 **玩家界面**，或者在画布上双击贴在「这张卡」上面的玩家界面预览（它右上角的铅笔也行）。

![玩家界面编辑器](./images/canvas/player-view.webp)

## 从模板开始

点上面的 **模板**，打开 **选一个模板**。

![选一个模板](./images/canvas/templates.webp)
一共 22 个现成模板，变量、按钮和给 AI 的说明都已经接好。加上就能玩。

**整个界面**：一次换掉整张卡的样子。一共十二个，这四个覆盖了大多数卡

| 模板 | 适合 |
|---|---|
| 立绘对话 | 讲一个角色的卡：立绘、两条状态、一个详情页 |
| 冒险状态 | 文字冒险和探索：当前位置、天数和时间、两条状态 |
| 养成面板 | 养成、经营、生存：四条状态、金币、天数 |
| 角色卡 | 角色扮演：玩家自己的名字、身份、位置和剧情阶段 |

每个整个界面的模板都写着「会给这张卡加这些变量」。比如养成面板会加天数、时间段、金币、好感、体力……这些是普通变量。回到画布能看到、能改、能用行为驱动。不想要的话，撤销就行。

**开局 · 玩家进故事之前**：片头、选开局、填名字进故事、建档、选出身、选难度、抽一个开局、分配属性点、开局确认页。玩家在故事开始前依次走一遍，选的东西会交给 AI。比如填了名字，AI 从第一句就这么叫你。

**玩的时候 · 从聊天页的「菜单」打开**：状态面板、背包、地图前往、手机私信、关系档案、日程行动、掷骰检定、线索与指认、收集图鉴。

还有一个 **空白页**，什么都没有，自己摆。

在画布上，**玩家界面** 上的 **＋**（**加页面**）打开的也是这个模板库。

## 页面

左边一列是卡里所有的页面，像幻灯片。**新建一页** 也是从同一批模板里挑。一页如果没有任何按钮能离开它，会挂一个 **没出口** 的提醒，玩家就不会被困住。

## 直接在画面上改

上面的 **编辑** 开着的时候，点一个部件就选中，拖一拖换位置，拉角改大小。关掉 **编辑**，就能像玩家一样按按钮。这里是预览：不会调用 AI，也不花钱。

**电脑** 和 **手机** 切换预览的宽度。两种宽度各有一套位置和大小，你改的是你现在看的那一种，所以做完前两边都看一眼。有些部件可以设成只在其中一种上显示。

选中一个部件，右边会打开它的设置。文字可以 **插入变量的值…**，比如「第 {当前天数} 天」。**加一个部件** 里有文字、按钮、图片、色块、状态条、列表、卡片选择、填写项和弹窗。**图层** 列出这一页上的所有部件，被挡住的东西从这里找最方便。

### 对话的样子

中间那块 **对话** 和底下的输入框删不掉，但能换样子。选中它，**消息样子** 里有平台默认、默认气泡、小说排版、信纸和终端。再往下，**细调文字、气泡和特殊写法** 可以分别改字体和气泡颜色，还能给特殊写法（比如 *斜体* 的动作行）配样式。

## 按钮能做什么

选中一个按钮，**按下时，依次做** 里可以排好几步：

![按下时，依次做](./images/canvas/button-steps.webp)

- **替玩家说一句**：比如「看看四周」。点一下就当玩家说了这句
- **改变量**
- **让一条行为生效**：可以 **＋ 传一个值进去**，见[行为 · 按钮传值](/zh/creator/automation#按钮传值)
- **叫一个 AI**：叫一个界面型的 [AI](/zh/creator/ais)，比如算命的
- **切换开场白**、**跳到页面**、**随机抽取**
- **弹出提示**、**播放音频**、**停止音频**
- **重新生成**、**撤回一轮**

**这些填好了才能按**：勾上几个变量，它们都有内容了按钮才亮。开局页的「开始」按钮常用这个，没填名字谁也进不去。

**换个样子**：主题默认、实心、描边、柔底、玻璃。只换外观，不动内容。

## 自己写界面代码

模板和部件不够用的时候，可以完全自己做。界面代码在 **面板 → 界面代码** 里。可以手写，也可以让创作助手帮你写、帮你改。详见 [Custom UI 指南](/zh/creator/advanced/custom-ui-deep)。

## 输入框里的「帮我写」和「给 AI 的话」

默认聊天界面的输入框里，玩家有两个工具：

- **帮我写**（「+」菜单里）：输入框空着时，AI 替玩家写下一步；打了字时，把这句扩写成一段。只写玩家自己的角色，不替别人说话，也不往下推剧情。结果只放进输入框，玩家改完再发。用玩家自己选的模型，按一次调用计费。
- **给 AI 的话**（「+」菜单）：只对下一条回复生效的指示，比如「节奏慢一点，让她先开口」。不算剧情，不进前情提要和记忆。玩家的消息上会显示一行小字。

玩家自己的措辞就是玩法的卡（猜谜、口令），可以在画布上点这张卡，在 **玩家输入** 里关掉 **帮我写**。自己写界面代码的话，用 `api.composeAssist()` 和 `api.sendMessage(text, attachments, { note })`，见 [API 参考](/zh/creator/advanced/08-api-reference)。

## 常见问题

**怎么改主题（颜色、字体）？** **换界面** 里每套版式都自带一套配色。想改，点玩家界面块上的 **编辑**，选中一个部件，设它的颜色、字体和圆角。也可以跟创作助手说，比如「主色换成暗红，用衬线字体」。

**代码在哪？** 点玩家界面块上的 **代码**（卡里有界面代码时才显示），或者打开 **面板 → 界面代码**。在画布的搜索框里输入「代码」或「主题」也能跳过去。

**能把自己这套存成模板吗？** 能。打开 **⋮ → 存为模板或资源包**，选 **模板**，勾上要带的东西，存进你的库。以后在 **资源市场 → 我的库** 里拿出来用，这张卡或新卡都行。

**能加排行榜吗？** 能。跟创作助手说「加个排行榜」，它会按卡现在的样子画一个榜，一局结束时显示名次。榜的样子随你改。见[排行榜](./advanced/recipes/leaderboard.md)。

## 改完以后

保存后，试玩和玩家看到的就是这套界面。改完点左上角的 **←** 回到画布。
