消息与视觉小说视图

用对白写成的原稿，别只是读 — 来播放看看吧！只要一行前置元数据，笔记就会变成聊天消息实时往来的消息画面，或是背景、角色、背景音乐都活起来的视觉小说游戏画面。🎮💬

← 回首页：ObsiKO 101 · 相关文章：18-2 角色图鉴与角色参照 · 18-1 电子书与网络小说查看器

🎬 跟着做做看：笔记变成群组聊天室 — 消息视图 · 笔记变成游戏画面 — 视觉小说视图（韩文页面）

1 分钟摘要 ⏱️

view: messenger → 手机外框里的消息视图 💬，view: visualnovel → 全屏幕的视觉小说视图 🎮
剧本用 18-2 角色图鉴与角色参照的 <<名称:图片>> 参照来写 — 对齐后缀（|--／--|）会变成气泡的方向、角色站的位置。
点击 (Space/Enter) 前进一句对白，← 倒回，也能 ▶ 自动播放。
背景音乐、音效、画面演出、情绪动态、退场 — 两种视图看得懂的演出语法完全一样。
记不住语法的话，用编辑器左侧故事工具栏的按钮挑选放入就好（见下方第 4 节）。

1. 剧本的写法 — 共通语法 ✍️

在前置元数据加上 view: messenger 或 view: visualnovel，上方的视图菜单 (👁) 里就会出现对应的条目（“消息视图”“视觉小说视图”）。

💡 只要守住两件事：① view: 的值必须是英文 — messenger、visualnovel（网络小说、书本是 webnovel、book）。大小写不分，视觉小说也可以简写成 vn、visual-novel，但如果写成中文（例如 消息视图），条目就不会出现。② 对白行必须以 <<名称:图片>> 标记开头才会被当成对白（放在句子中间，就只会显示成叙述）。

---
view: messenger
---
<<背景:夜晚巷弄.png>>
<<瑞妍:瑞妍-基本.png|-->> [10:23] 你在哪？到了没？
<<敏俊:敏俊-着急.png--|>> 抱歉抱歉，再 5 分钟！！
<<瑞妍:瑞妍-嘟嘴.png!shake|-->> 又睡过头了吧？
%%shake%%
敏俊开始全速狂奔。
<<敏俊:->>

语法	意思
`<<名称:图片>> 对白`	那个角色的对白（图片＝表情）
`<<背景名称:图片>>`	场景转换 — 消息视图＝聊天室壁纸，视觉小说＝舞台背景（`type: background` 的条目）
`[10:23]`	放在对白前面，就是那则消息的发送时间（消息视图）
`# 标题`	场景标签（章节标注）
一般句子	旁白（叙述）
`> 引用`	消息视图＝固定在上方的公告（群组公告 📢），视觉小说＝画面中央的系统通知
`---`	分隔线 — 在视觉小说里是全员退场＋停止背景音乐（整理场景）
`%%注释%%`	不会出现在画面上的备忘

对齐后缀：在图片名称后面加 |--（靠左）或 --|（靠右），什么都不加就是居中。在消息视图里是气泡的方向（右边是“我”），在视觉小说里是角色站的位置。在 << 自动完成的第 3 步直接选也可以！

在对白的位置放文件 📎

像 <<瑞妍:瑞妍-基本.png>> ![[自拍.jpg]] 这样，把附件放在对白的位置 —
- 图片 → 消息视图＝照片泡泡（点击放大），视觉小说＝画面中央的 CG
- 音频（[[语音.mp3]]）→ 消息视图＝有播放按钮的语音频息
- 其他文件 → 消息视图＝文件卡片
- 只写标记、没有文字的话，在消息视图里会把那个角色的图片当成照片传出去。
- 贴图 → 像 ![[爱心.png|sticker]] 这样在后面加上 |sticker，就会像聊天 App 的贴图一样，传出没有外框的大图（消息视图＝放在气泡的位置，视觉小说＝在说话的角色旁边弹出）。在笔记库创建名为 stickers 的文件夹并放入图片（png、gif、webp），故事工具栏的贴图按钮就会把它们集中显示，而且那个文件夹里的图片不加 |sticker 也会当成贴图。会动的 gif、webp 也照样会动。

演出语法 🎇 — 两种视图共通！

语法	演出
`![[歌曲.mp3]]`（或只有音乐的那一行）	背景音乐 — 循环播放；换歌时，前一首的淡出和新歌的淡入会重叠在一起，顺顺地接上（交叉淡化） 🎵
句子里的 `[叮咚](bell.mp3)`	音效 — 在那句对白之前播放一次 🔔
`%%shake%%` `%%flash%%` `%%fade%%`	画面演出 — 震动、闪光、转暗（韩文别名 `%%흔들림%%` 等也可以）
图片后面加 `!jump` `!shake` `!nod`	情绪动态 — 消息视图＝气泡“蹦！”一下，视觉小说＝角色“蹦！”一下（韩文 `!점프`／`!흔들`／`!끄덕` 也可以）
图片后面加 `!question` `!exclaim` `!sweat` `!heart` `!anger` `!note` `!sleep` `!sparkle`	情绪 — 视觉小说＝角色头上“啵”地冒出小气泡，消息视图＝气泡角落的小徽章。也可以直接用表情符号，像 `!❓` `!💦` `!❤️` `!💢` `!♪` `!💤` `!✨`。和动态叠在一起写成 `!jump!heart` 也 OK（对齐标记放最后：`!jump!heart\|--`）
`<<名称:->>`	退场 — 消息视图＝“○○ 已离开。”的系统消息，视觉小说＝从舞台退场

2. 消息视图 💬 — 聊天实时进行

画面中央会出现手机外框，每点击就送达一则消息。

演出超逼真：左边的对白会先跳出 ••• 输入中 的泡泡；右边（我）的对白则会在下方输入框一字一字打出来再送出！刚送出的消息旁会短暂出现未读的 “1”，接着消失。
时间显示：写了 [10:23] 就用那个时间，没写的话，会有自然流逝的假时间。同一个人连续传好几则时，会像 KakaoTalk 一样只在最后一个泡泡标上时间。
只有 1~3 个表情符号的消息，会不加泡泡、大大地显示 😆
群组公告 📢：在剧本里放 > 引用，聊天上方就会出现固定公告栏（就像 KakaoTalk 群组的公告）。默认是收起来的，点击就会展开。放在第一句对白前面的公告，一打开视图就会显示在上方；播放途中每经过一个新的 > 引用，公告内容就会在那一刻换掉。
链接就像真的消息 App 🔗：对白或旁白里的网址点击就能打开，泡泡下方还会出现预览卡片（标题、说明、缩略图）。[[维基链接]] 也会变成卡片，点下去就会移到那篇笔记。旁白（叙述）里的链接会整理成一行一个的漂亮胶囊按钮。（网页预览图片会在桌面 App 和 iPhone、iPad、Android App 上补上。在浏览器里使用的网页版，有些网站的卡片可能只会显示网址。）
主题 ◐：默认、Kakao、iMessage、深色 — 连输入框的颜色都会一起变。
操作：▶ 自动播放（速度 ×1／×1.6／×2.4）、⏭ 直接展开到最后、⏮ 从头开始、♪ 静音、◐ 主题、← 倒回一步（演出也会一起倒回）。要关闭时，按手机外框左上角的 ‹（返回）按钮或 Esc。读到的位置会按文档分别记住！

3. 视觉小说视图 🎮 — 就像游戏画面

全屏幕的舞台铺上背景，角色站在左、中、右说出台词。

舞台：用背景参照切换（柔和的转场＋淡淡的 Ken Burns 缩放）。正在说话的角色很清楚，没说话的角色会稍微退后、变暗。同一个角色换表情（图片）时也会交叉淡化，唰地换过去 — 会先把新图片读好，再叠着换上。
对白框：没有外框的电影感渐层 — 说话者的名字会用 color 的颜色加上外框线，出现在角色站的那一侧，对白则像打字机一样逐字流出（支持 Markdown 格式与强调色）。
选项分支：在旁白行放入 [[维基链接]]，就会变成选项按钮！[[#小标题]] 是在文档内跳转，[[其他文档]]、[[其他文档#小标题]] 则会接到其他集。交互式故事就完成了！🌿
结局：内容结束时画面会变暗并出现“完” — 连余韵都照顾到了。
操作：点击／Space＝下一句，←＝倒回，▶ 自动播放（速度 ×1／×1.7／×2.6），按住画面（或按住 Ctrl）＝快转，🔇 静音，在 ⚙ 调整文字速度与大小。读到的位置当然也会记住。

🎬 同一份原稿，三种放映厅：同一份剧本，用网络小说视图看像小说，用消息视图看像聊天剧，用视觉小说视图看像游戏。只要换掉 view 的值就好！

🤖 AI 代理完全懂这套语法（16 AI 代理）：说“把这篇小说改成消息视图的剧本”“写一集有瑞妍和敏俊登场、带选项分支的视觉小说”，它就会确认已登录角色的实际图片文件名，做出符合语法的剧本。需要的角色还没有的话，会先帮你创建前置元数据笔记。

4. 故事工具栏 🧰 — 用按钮写剧本

打开前置元数据 view: 是四种故事视图（book、webnovel、messenger、visualnovel）之一的文档时，编辑器的左侧墙边会出现直式工具栏。不用背语法，只要按按钮挑选，就会帮你写好合适的 Markdown。原稿永远都是普通的 Markdown。

按钮	功能
加入角色	选角色 → 表情（图片），放入 `<<名称:图片>>` 对白行。先选中一句话再按，那句话就会变成这个角色的对白
加入背景（电子书、网络小说是放入场景背景）	选背景笔记或笔记库里的图片，放入场景转换
加入背景音乐 · 加入音效	选笔记库里的音频档放入。放入前也能先试听
画面效果	震动 · 闪光 · 转暗
贴图、情绪	发送“贴图”文件夹里的图片，或在角色头上加情绪
场景	放入新场景标题（`# 标题`）或场景分隔（`---`）
选项	选好要接续的段落，放入 `[[#小标题]]` 选项；或创建新段落并直接连起来
公告、时间	放入固定在上方的公告（`>`）或对白的发送时间（`[10:23]`）
预览 ▶	从光标位置开始直接用那个视图播放

每种视图显示的按钮不一样：那个视图用不到的按钮会直接隐藏。电子书、网络小说只有角色、场景背景、背景音乐、场景、预览；消息视图再加上音效、画面效果、贴图、公告与时间；视觉小说则是用选项替换公告与时间。
在手机、平板上：为了不挡住正文，工具栏一开始是收起来的。点击最上面的把手（≡）就能展开或收起，拖动把手就能把工具栏上下移动（移过去的位置会记住）。

← 上一章：18-2 角色图鉴与角色参照 · 回到首页 · 下一章：18-4 随机盒 →