訊息與視覺小說檢視

用對白寫成的原稿，別只是讀 — 來播放看看吧！只要一行前置資料，筆記就會變成聊天訊息即時往來的訊息畫面，或是背景、角色、背景音樂都活起來的視覺小說遊戲畫面。🎮💬

← 回首頁：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 隨機盒 →