---
title: "音频设计"
description: "世界里触发音频的四种方式（播放列表、智能追踪、AI 指令、条件 BGM），再加上行为、音量和淡入淡出的建议。"
---

<div v-pre>

# 音频设计

同样的文字，一个带雨声和远处心跳音效的生存惊悚，和一个只有文字的，玩起来感觉完全不同。设置起来并不费事：上传几条音轨，配好怎么放，剩下的交给引擎。

音轨类型（BGM、音效、环境音）和基本设置，见 [视觉与音频](/zh/creator/visuals-audio)。

要找一条音轨的 ID，打开 **面板 → 音频**，选中这条音轨，用旁边的 **复制 ID** 复制那个只读的 **音轨 ID**。`playAudio(trackId)` 和 `[audio: trackId play]` 这类指令里填的就是这个值。素材里的 **素材 ID** 指的是上传的那个文件，和音轨 ID 不是一回事。下面例子里 `door-slam` 这样的 ID，换成你自己音轨的真实 ID。

---

## 音频是怎么被触发的

世界里的音频有四种放法，从最简单到最灵活。

### 1. 播放列表：设好就不用管

**默认播放列表** 会在玩家进入世界时自动按顺序放一串音轨。大多数世界只需要这个。

在 **面板 → 音频** 的 **BGM 播放配置** 里设置：

| 设置 | 作用 |
|---------|-------------|
| **音轨** | 放哪几条 BGM，按什么顺序 |
| **播放模式** | **循环**（从头再来）、**随机**，或 **顺序**（全部放完再重复） |
| **自动播放** | 世界加载时尝试播放 |
| **等待首条消息** | 等玩家发了第一条消息再开始，适合有角色创建或开场过场的世界 |
| **曲间间隔（秒）**（0-30） | 两首之间留一段安静，像换唱片 |

Sakura Season 和 PRTS Terminal 用的都是最简单的配置：一首 BGM，循环模式，开着自动播放。它们的音频配置就只有这些。

::: details 最简配置
上传一个音频文件。建一条 BGM 音轨。把它加进播放列表，打开 **自动播放**。如果浏览器拦截了自动播放，它会在玩家后续的操作时重试。离开世界，它的音频就停。
:::

### 2. 智能追踪：AI 照着你的提示挑

在 **面板 → 音频** 里，每条音轨都有 **让 AI 自动放这首**（音效是 **让 AI 自动放这个音效**）。在 **什么时候放** 里写一句，比如「热闹欢快，庆祝、集市、追逐打闹时放」，音效就写「有人拔刀动手」。每次回复后，智能追踪会拿当前场景和这些提示对一对：剧情对上某首，就切过去；某个音效的时刻到了，就放一次。这一句留空，这条音轨就只按播放列表和条件规则放。

不管玩家用什么模型都管用，因为写故事的 AI 不需要记得写任何东西。有几项设置决定它和你其它的音乐怎么相处：

- **AI 想换歌，但条件规则正在放它自己的曲子时**：**规则优先**（规则的曲子照放）或 **AI 优先**（换成 AI 选的，直到放完或 AI 交还）
- **AI 选的曲子放完以后**：一直循环直到 AI 换歌，或者只放一遍，放完回到默认播放列表
- **AI 放音效的时候，把背景音乐压低**，放完恢复

智能追踪默认是开着的；它就是 **卡的设置** 里同名的那个开关。

### 3. AI 指令：让旁白给配乐打拍子

AI 可以在回复里嵌入音频命令，用的是和变量指令一样的方括号语法。玩家永远看不到这些。引擎在显示文字之前会把它们去掉。

只有打开了 **允许 AI 控制** 的音轨才能这样控制。它默认是开着的；想把一条音轨留给自定义 UI、脚本、行为或播放列表，就把它关掉（在画布上点这条音轨，或者在 **面板 → 音频** 里）。写指令或自定义 UI 调用时，用 **复制 ID** 复制这条音轨的 **音轨 ID**。

```
门被一声震耳的巨响撞开。[audio: door-slam play]
一个披甲的身影穿过烟雾走了进来。
```

玩家读到的是干净的叙述，同时听到门被撞开的声音。

**可用的指令：**

| 指令 | 作用 |
|-----------|-------------|
| `[audio: trackId play]` | 播放这条音轨 |
| `[audio: trackId stop]` | 停止这条音轨 |
| `[audio: trackId crossfade 2.0]` | 用 2 秒从当前 BGM 渐变到这一首 |
| `[audio: trackId volume 0.5]` | 不停下来，只改音量 |
| `[audio: trackId play chain:nextTrackId]` | 放这一首，放完自动接着放下一首 |

`chain` 指令适合做过渡：先放一声战争号角的音效，号角放完就进战斗 BGM，不用再写第二条指令。

AI 指令可以和状态变化写在同一条回复里：

```
地牢深处传来一阵轰鸣。[audio: earthquake-sfx play]
碎石从天花板落下。[health: -5]
环境音越来越压抑。[audio: ambient-cave volume 0.3]
```

**缺点：** AI 有时会忘记写指令，尤其是回复很长、或者它正专注于复杂剧情的时候。对于必须在准确时刻响起的音频，改用条件 BGM 或行为。

### 4. 条件 BGM：音乐跟着故事走

你定好条件，条件满足时引擎就切换音轨，AI 不参与。在 **面板 → 音频** 的 **条件 BGM** 下点 **添加条件规则**。

结果就是一套跟着游戏状态走的配乐：在酒馆放酒馆音乐，战斗中放战斗音乐，其它地方放探索音乐。

每条条件 BGM 规则有这些设置：

| 设置 | 作用 |
|---------|-------------|
| **条件** | 看什么：**变量条件**、**玩家关键词** / **AI 关键词**（匹配文字）、**回合计数** 或 **会话开始** |
| **条件**（变量检查） | 变量检查（用于 **变量条件**），用 **满足全部条件** 或 **满足任一条件** 组合 |
| **播放** | 切到哪一首 |
| **优先级** | 多条同时满足时，数字大的赢 |
| **淡入 (秒) / 淡出 (秒)** | 过渡用几秒 |
| **停止上一首 BGM** | 一般开着，除非你想叠好几首 |
| **结束时** | 条件不再满足时放什么：**返回默认播放列表**、**返回上一曲**，或指定一首 |

::: details 例子：切换战斗音乐
两首 BGM：`explore-bgm` 和 `battle-bgm`。播放列表默认放探索音乐。一条条件 BGM 规则盯着 `location` 是不是 `battle_arena`。一旦成立，引擎用 0.5 秒渐变到战斗音乐。玩家离开竞技场后，**返回默认播放列表** 把探索音乐放回来。

每当战斗开始和结束，玩家都能听到平滑的音乐过渡，AI 不用记任何跟音频有关的事。
:::

---

## 用行为控制音频

行为有三个音频效果：**播放音乐**、**播放音效** 和 **停止音频**，完全不经过 AI 就能控制音频。对于必须在准确时刻响起的音频，这是最可靠的办法。

Battle Royale 的音频工具里有一条 `death-sfx` 和一条 `heartbeat-sfx`。它现在的版本靠 AI 指令来触发它们；要是接到行为上，就能保证它们在对的时刻响：生命掉到 20 以下放心跳音效，生命归零放死亡音效。

| 效果 | 作用 |
|--------|-------------|
| **播放音乐** | 放一首背景音乐 |
| **播放音效** | 放一个一次性的音效 |
| **停止音频** | 停掉这条音轨 |

配上 **变量越过阈值** 触发，你就有了一定会响的音频提示：

```
条件：  health 降到 20 以下
效果：  播放音乐 → crisis-bgm
```

淡入淡出和改音量不是行为效果。要做这些，用条件 BGM、AI 指令，或者在界面代码里调 `api.playAudio(trackId, { fadeDuration, volume })`。

---

## 设计建议

### 音量平衡

大多数世界的 BGM 放在 0.3-0.5 就合适。玩家在读字，音乐太响会和注意力抢位置。环境音可以更低（0.1-0.3），当作背景质感。音效要响一些（0.7-0.9），因为它很短，就是用来给某个瞬间加重音的。

### 音轨少一点，效果反而好

Battle Royale 有四条音轨：一首角色创建 BGM、一首游戏播放列表 BGM、一个心跳音效、一个死亡音效。这就足够撑起一局好几个小时的生存游戏的紧张感。你不需要一个 20 首的曲库。几首挑好的、过渡做顺的，比塞满的配乐更有用。

### 都加上淡入淡出

声音突然切断很突兀。给 BGM 音轨把 **淡入 (秒)** 设成 2、**淡出 (秒)** 设成 1.5，过渡就顺了。换歌时用 `crossfade`，不要先停再放。条件 BGM 默认的淡入淡出（淡入 1 秒，淡出 1 秒）是个合理的起点。

### 什么时候交给 AI，什么时候自动化

触发点是*剧情*的时候交给 AI：门被撞开、角色倒抽一口气、一声爆炸。这些时刻没法预测，而 AI 知道它们什么时候发生，因为就是它在写。

触发点是*机制*的时候用自动化：进入某个地点、生命越过某条线、到了某个回合数。这些是精确的状态变化，引擎比 AI 盯得更准。

很多世界是混着用的：播放列表放底子音乐，条件 BGM 按地点切换，「什么时候放」的提示或 AI 指令负责戏剧性的音效时刻。

---

## 另见

- [AI 指令与宏](/zh/creator/advanced/directives-macros)：音频指令在整个指令系统里的位置
- [行为与自动化](/zh/creator/advanced/rules-deep)：用行为里的音频效果做精确的音频触发
- [自定义 UI 指南](/zh/creator/advanced/custom-ui-deep)：通过 bridge API 从自定义 UI 控制音频

完整的音频 schema 和播放列表配置 → [World Spec：音频](/zh/world-spec/audio)

</div>
