10. 桌面版專屬

本章說明 HakoSpace Desktop 專屬的功能與設定。其中部分功能需要你所連線的伺服器配合；伺服器版本較舊時，這些功能可能不會出現或無法使用，這時請伺服器的 owner / admin 更新伺服器。

10.1 多伺服器連線

桌面版視窗最左側設有多伺服器側欄。你可以同時連線至多個不同的 HakoSpace Server，並在側欄中透過點擊圖示一鍵切換，無需開啟多個應用程式視窗或瀏覽器分頁。

10.2 系統匣 (System Tray)

當你關閉應用程式主視窗時，HakoSpace Desktop 預設會「縮小到系統匣」並在背景持續執行。即使主視窗不可見，你仍會收到通知；點擊工作列右下角的圖示即可隨時喚回主視窗。如果你希望關閉視窗時直接結束程式，可以在「桌面設定 → 行為 → 關閉按鈕行為」中改為「關閉應用程式」。

對系統匣圖示按右鍵會跳出選單，包含：

顯示：叫回主視窗。
桌面設定：開啟桌面版專屬設定（見 §7.9）。
開啟診斷資料夾：開啟 HakoSpace Desktop 存放診斷紀錄的資料夾。回報問題時，把資料夾裡的 hako-diag.log 一併附上，對釐清狀況很有幫助。
重新啟動以套用更新：背景已下載好新版本、等你套用時才會出現，這時滑鼠停在系統匣圖示上也會看到更新已就緒的提示。按下後 HakoSpace 會關閉、安裝新版本，再自己重新開啟；你在語音頻道或私訊通話中時，會等通話結束才重新啟動（見 §10.8）。
結束應用：完全結束 HakoSpace Desktop。

10.3 全域快捷鍵

在「桌面設定 → 快捷鍵」（開啟方式見 §7.9）可以為以下六個動作各綁定一組快捷鍵，預設都沒有綁定：

「接聽來電」「拒絕來電」：私訊通話的來電響鈴時，接聽或拒絕這通來電（見 §4.3）。
「切換靜音（喇叭）」「切換靜音（麥克風）」：分別與通話控制按鈕（見 §3.2）的「拒聽」與「靜音麥克風」按鈕作用相同。
「切換說話模式」：麥克風沒有靜音時，在「語音感應」與「按鍵發話」之間切換（見 §10.4）。
「按鍵發話按鍵」：「語音輸入模式」為「按鍵發話」時，按住這組按鍵才會送出聲音（見 §10.4）。

接聽與拒絕來電以外的四個動作，要在你身處語音頻道或私訊通話中時才會作用。同時連線多個伺服器時（見 §10.1），快捷鍵會作用在你正在語音中、或來電正在響鈴的伺服器，不需要先切換過去。

綁定與清除：每個動作一列，列名右側的按鈕顯示目前綁定的組合鍵，還沒綁定時顯示「未設定」。

點該列的按鈕，按鈕會變成「請按下快捷鍵…」。
按下想用的組合鍵，例如按住 Alt 再按 M。按鈕改為顯示 Alt+M，設定隨即存下。

按鈕顯示「請按下快捷鍵…」時，按 Esc 或再點一次按鈕可以取消；按 Backspace 或 Delete 會清除這一列的綁定。已綁定的列在按鈕旁另有一個叉號圖示（滑鼠停留會顯示「清除此快捷鍵」），點一下也能清除。

遇到以下兩種情況，按下的組合鍵不會存下：該列下方會出現說明，按鈕維持「請按下快捷鍵…」，直接改按其他組合鍵即可。

單獨的 Enter、Tab、空白鍵或方向鍵：要搭配 Ctrl / Alt / Shift / Super 其中之一才能綁定。
已經指派給另一個動作的組合鍵：說明會寫出是哪一個動作；請先清除那一列，或改用其他按鍵。

在背景使用：組合鍵含有 Ctrl / Alt / Shift / Super（Windows 鍵）等修飾鍵時，在 HakoSpace 前景與背景皆可使用。前景是指你正在操作 HakoSpace 視窗；背景是指 HakoSpace 視窗不在前景，例如你正在使用其他應用程式。遊戲或其他應用程式也會照常收到同一組合鍵，不會被攔截。綁定之後，該列下方會顯示目前的狀態，例如：

「前景、背景皆可使用。採系統層級被動監聽：Alt+M 仍會照常傳遞給其他應用程式，不會被攔截。」

沒有修飾鍵的單一按鍵也可以綁定，但只在 HakoSpace 為前景時有效，也會影響你在 HakoSpace 裡打字；該列會出現以警示符號開頭的說明，寫明影響並建議改綁組合鍵。

在 Linux 的 Wayland 桌面環境下，以及其他背景無法使用的情況，快捷鍵只在 HakoSpace 為前景時有效；該列會出現以警示符號開頭的說明。

在 HakoSpace 裡按下已綁定的按鍵，會改為觸發你綁定的動作，這組按鍵原本的作用（例如 Ctrl + C 複製）就不會發生；「按鍵發話按鍵」例外，按住時這組按鍵原本的作用仍可能發生。

挑選組合鍵時，建議避開遊戲、其他應用程式、HakoSpace 裡已經在用的按鍵，以及遊戲 HUD 的「HUD 快捷鍵」；「HUD 快捷鍵」另在「桌面設定 → HUD」設定，按下時由 HUD 接收（見 §10.11）。

10.4 按鍵發話 (PTT) 與語音感應

語音輸入有兩種模式：

語音感應：偵測到聲音時自動送出。HakoSpace Web 一律使用此模式。
按鍵發話：必須按住指定的按鍵才會送出聲音。

在 HakoSpace Desktop 使用按鍵發話，要設定兩個地方：

在「桌面設定 → 行為 → 語音輸入模式」選「按鍵發話」。
在「桌面設定 → 快捷鍵」的「按鍵發話按鍵」那一列，綁定要按住的按鍵（綁定方式見 §10.3）。

在語音頻道中，也可以對通話控制按鈕裡的麥克風按鈕（見 §3.2）按右鍵，從跳出的小選單選「語音感應」或「按鍵發話」。綁定了「切換說話模式」快捷鍵的話，在語音中、麥克風沒有靜音時按一下，可以在兩種模式之間切換（見 §10.3）。這幾種方式改的都是同一個「語音輸入模式」設定，在語音中切換會立即生效。

「按鍵發話」適合在嘈雜環境（鍵盤聲、機械風扇等）使用，避免不想被聽到的聲音不小心被傳出去。

10.5 螢幕分享的進階能力

桌面版的螢幕分享在瀏覽器原生的螢幕分享之外提供兩項額外能力：

可以擷取應用程式的音訊：分享時可一併送出該應用程式的聲音（例如分享遊戲時把遊戲音效一起傳給其他成員）。
不會因為視窗在背景而降低更新率：當你切換到其他應用程式或將 HakoSpace 視窗最小化時，畫面更新率不會被作業系統 / 瀏覽器降頻，分享串流維持穩定。

擷取引擎由 HakoSpace 自動判斷，不需要你設定：這台電腦的顯示卡支援硬體 H.264 編碼時使用原生的 HakoCap 引擎，否則使用內建的 Chromium 引擎。「桌面設定 → 行為 → 螢幕分享引擎」會顯示這台電腦的偵測結果 ——「HakoCap Ready!」或「Chromium」，那是唯讀的狀態顯示，不是可切換的選項。如果硬體編碼當下無法使用，畫面角落會出現一次提示「硬體螢幕編碼暫時無法使用，已改用 Chromium 螢幕分享。」，分享本身會繼續。

開始分享後，「視訊來源」選單中的「分享螢幕」會切換為「停止分享」並顯示分享中狀態，行為與 §3.4 描述的一致。

觀看用的彈出視窗：用 §3.4 的「彈出視窗」或「彈出舞台」開出的視窗，在 HakoSpace Desktop 中沒有標題列，操作方式如下：

移動視窗：單一畫面的彈出視窗，按住畫面上任何地方拖曳即可移動，右上角「關閉」按鈕一帶與底部控制列除外；整個舞台的彈出視窗，則按住上方工具列上按鈕以外的地方拖曳。
按 Esc：彈出視窗在前景時按 Esc，全螢幕中會退出全螢幕；不在全螢幕時會直接關閉這個視窗 —— 單一畫面回到舞台，整個舞台回到主視窗。

10.6 連結開啟方式

桌面版可以決定點擊訊息中的連結時要在哪裡開啟：

使用外部瀏覽器開啟：把連結交給系統預設瀏覽器處理。
在應用程式內嵌顯示：在訊息區上方的分頁列以一個網頁分頁顯示這個網頁，不離開 HakoSpace。

設定在「桌面設定 → 行為 → 連結開啟方式」。

以「在應用程式內嵌顯示」開啟的網頁可以放大或縮小，操作方式見 §10.9。

10.7 視窗位置與開機啟動

記住視窗位置與大小：關掉 HakoSpace Desktop 之後再開啟，主視窗會回到你上次擺放的位置與尺寸，最大化的狀態也會一併記住。第一次安裝時是置中的預設大小。如果上次的位置落在目前接不到的螢幕上（換了螢幕、改了解析度、拔掉外接螢幕），HakoSpace 會把視窗拉回目前看得到的範圍內。在 Linux 的 Wayland 桌面環境下只會記住尺寸，位置交由系統決定。

啟動方式：「桌面設定 → 行為」裡有兩個各自獨立的開關。

「開機時啟動」：登入這台電腦時自動開啟 HakoSpace。
「最小化啟動」：啟動時收在系統匣、不開視窗 —— 你自己手動點圖示啟動時也一樣，要再點系統匣圖示才會叫出視窗。在你第一次成功把視窗叫回來之前，每次這樣啟動都會發一則系統通知「HakoSpace 已在背景執行，圖示在系統匣。」，點那則通知也能直接叫出視窗。

這兩個開關在不同平台上有不同的條件，設定頁會直接說明目前這台電腦的狀況 —— 例如攜帶版兩者都不適用、Linux 上要先確認「我看得到系統匣中的 HakoSpace 圖示」才能開啟最小化啟動、或是 Windows 的「工作管理員 → 啟動應用程式」已把這個項目停用（那邊的決定 HakoSpace 不會覆寫）。

10.8 桌面版更新

桌面版的更新集中在「桌面設定 → 更新」分頁（桌面設定的開啟方式見 §7.9）。分頁最上面是「桌面應用更新」區塊，下方是「自動更新」與「接收預覽版更新」兩個開關。

「桌面應用更新」區塊列出「本地版本」「協議版本」與「組建指紋」（用來辨識這一份程式的代碼）。用 HakoSpace 的更新功能更新過之後，還會多一列「上次套用更新」，顯示從哪個版本更新到哪個版本，以及套用的時間；更新前後的版本號相同時（同一個版本重新發布），這一列改顯示版本號加上組建指紋。

HakoSpace 自己下載並安裝更新的功能，適用於 Windows 安裝版，也就是用官網下載頁的「安裝程式」安裝的版本。攜帶版（官網下載頁的「免安裝版」）與 Linux 版的更新方式，見本節後面「攜帶版與 Linux 版」那一段。

Windows 安裝版的「自動更新」預設開啟。開著時，HakoSpace 會在兩個時機處理更新：啟動時，以及執行期間。

啟動時：主視窗出現之前，螢幕中央會先出現一個啟動畫面（開了「最小化啟動」時例外，見下文）—— 上面是 HakoSpace 字樣，中間是說明更新進度的文字，底部是目前的版本號。

先顯示「正在檢查更新…」；沒有新版時顯示「已是最新版本」，接著主視窗出現。
有新版時依序顯示「發現新版本 v{版本}」→「正在下載更新 v{版本} ({百分比}%)」（下方出現進度條）→「更新已就緒，即將重新啟動安裝…」。接著啟動畫面消失，HakoSpace 在背景安裝新版本，完成後自己重新開啟。
連不上網路等原因無法檢查時，顯示「無法檢查更新，將直接啟動」；更新過程出了其他問題時，顯示「更新失敗，將直接啟動」。兩種情況都會照常進入主視窗。
同一個版本自動安裝多次都沒有成功時，顯示「自動安裝多次失敗，已改為手動更新（見設定）」。這時可以到「桌面設定 → 更新」按「立即更新」手動更新。

完成更新、HakoSpace 重新開啟時，啟動畫面會先顯示「已更新至 v{版本}」，再檢查一次，接著進入主視窗。

啟動時有更新，除了啟動畫面，也會跳出系統通知告知進度。開了「最小化啟動」、啟動時收在系統匣不開視窗時（見 §10.7），不會出現啟動畫面：更新照樣進行，只用系統通知告知。

啟動畫面與更新的系統通知，會使用你上次在 HakoSpace 使用的介面語言（見 §7.8）。

執行期間：HakoSpace 開著的時候（包括縮小到系統匣時），會定期在背景檢查並預先下載新版本，但不會自行重新啟動。檢查與下載進行時，主視窗右下角會顯示目前的狀態，例如「檢查中…」「下載中…」。下載好之後：

跳出一則系統通知，說明更新已就緒、會在下次啟動時套用，也可以從系統匣選單立即重新啟動。
系統匣右鍵選單多出「重新啟動以套用更新」（見 §10.2）。
「桌面設定 → 更新」除了新版本的資訊，還會顯示「更新已就緒 — 重新啟動以套用」與說明「新版本已在背景下載完成，將在下次啟動 HakoSpace 時自動套用；也可以現在重新啟動立即完成更新。」下方有「重新啟動以套用更新」與「檢查更新」兩個按鈕；按「檢查更新」可以確認這段期間有沒有再發布較新的版本。

要套用時，從系統匣選單或設定頁按「重新啟動以套用更新」，HakoSpace 會關閉、安裝新版本，再自己重新開啟。也可以等下次啟動：啟動時檢查到的仍是這個版本，就直接安裝、不必重新下載；如果這時已經有較新的版本，則改為下載並安裝那一版。

背景已下載好、等你套用時關掉「自動更新」，已下載的版本會被捨棄，系統匣選單的「重新啟動以套用更新」也會消失。設定頁的「更新已就緒 — 重新啟動以套用」連同說明與兩個按鈕，會換成「立即更新」按鈕；要更新就按「立即更新」重新下載。

通話中：你在語音頻道或私訊通話中時，HakoSpace 不會開始背景下載，也不會重新啟動來套用更新。這時按「重新啟動以套用更新」或「立即更新」，會等通話結束才重新啟動；這段期間設定頁顯示「更新就緒 — 通話結束後重新啟動」，也會跳出系統通知告知。

手動檢查與更新：Windows 安裝版不論「自動更新」開或關，都可以手動更新，分成兩段：

按「檢查更新」，HakoSpace 只去問有沒有新版。沒有就顯示「已是最新版本」與上次檢查的時間；有新版時顯示「有新版本可用！」，列出「最新版本」與「發布時間」，可以展開「版本資訊」，並出現「立即更新」按鈕。
按「立即更新」才開始下載，畫面顯示「下載中…」與進度。下載完成後 HakoSpace 會關閉、安裝新版本，再自己重新開啟；重新開啟時同樣會先出現啟動畫面，顯示「已更新至 v{版本}」。

預覽版：開啟「接收預覽版更新」後，不論自動還是手動檢查，都會把預覽版一併納入，提供版本號最高的那一個；關閉時只提供最新的穩定版。開著時下方會出現提醒：「⚠ 預覽版可能包含尚未完成的功能或已知問題，建議僅用於測試環境。」

切換這個開關時，已經找到、或已在背景下載好等你套用的更新會被撤回，設定頁回到只有「檢查更新」按鈕的畫面，請重新檢查一次。
從官網下載頁安裝預覽版之後，要到這裡打開「接收預覽版更新」，才會繼續收到之後的預覽版。
想從預覽版換回穩定版：關掉這個開關，按「檢查更新」，這時列出的是最新的穩定版，版本號可能比你現在的預覽版舊；再按「立即更新」即可（攜帶版與 Linux 版改按「從 GitHub 下載」，見本節最後的「攜帶版與 Linux 版」一段）。只關掉開關的話，自動更新不會把你換回版本號較舊的穩定版。

更新來源：HakoSpace Desktop 檢查與下載更新時，會連線到 HakoSpace 的軟體發佈來源 dl.hakospace.com；這個來源無法使用時，改連 GitHub。下載回來的安裝檔會先自動驗證，確認與 HakoSpace 發布的檔案一致才會安裝。這些連線的資料處理方式，見隱私權政策（開啟方式見 §7.10）。

攜帶版與 Linux 版：「自動更新」開關維持關閉、無法切換，下方顯示「此版本不支援自動更新（攜帶版／不支援的平台）— 請手動下載新版本。」要更新時按「檢查更新」：有新版時會顯示「此版本不支援自動安裝 — 請手動下載新版本。」與「從 GitHub 下載」按鈕。按下後會以系統預設瀏覽器開啟 GitHub 上的 HakoSpace 發布頁面，從那裡下載新版本。

更新沒有照預期進行時，回報問題請附上診斷紀錄 hako-diag.log（開啟方式見 §10.2）。

10.9 顯示比例

「顯示比例」位在「桌面設定 → 行為」的最上面（桌面設定的開啟方式見 §7.9）。它用來放大或縮小伺服器畫面，也就是多伺服器側欄右邊、顯示伺服器內容的整個畫面，作用等同網頁版的瀏覽器頁面縮放。顯示比例有兩項設定：

下拉選單：可選 50%、67%、75%、80%、90%、100%、110%、125%、150%、175%、200%，預設為 100%。選好就立即套用，不需要另外儲存。
「使用 Ctrl + 滑鼠滾輪縮放」（勾選欄位，預設已勾選）：勾選時，在伺服器畫面上按住 Ctrl 滾動滑鼠滾輪，就能直接放大或縮小。

鍵盤縮放：在伺服器畫面上按 Ctrl + = 放大、Ctrl + - 縮小、Ctrl + 0 回到 100%；這三組按鍵不受「使用 Ctrl + 滑鼠滾輪縮放」影響。如果你在「桌面設定 → 快捷鍵」把某個動作（包括「按鍵發話按鍵」）綁定在其中一組上（例如 Ctrl + 0），按下那組按鍵時會改為觸發你綁定的動作。

一格一格調整：用 Ctrl + =、Ctrl + - 或 Ctrl + 滑鼠滾輪縮放時，比例會沿著下拉選單的選項一格一格移動，到 200% 或 50% 就停住。

縮放時的提示：登入伺服器之後，用按鍵或滑鼠滾輪縮放時，主視窗右下角會短暫出現目前的比例，例如「顯示比例 125%」。

套用範圍：所有伺服器共用同一個比例，切換伺服器、新增伺服器或重新啟動 HakoSpace Desktop 之後都會沿用。視窗最上方的標題列（顯示「社群版」字樣與視窗按鈕的那一列）、多伺服器側欄與桌面設定畫面維持原本的大小。

內嵌顯示的網頁：以「在應用程式內嵌顯示」開啟的網頁（見 §10.6），在網頁上按住 Ctrl 滾動滑鼠滾輪，或點一下網頁後按 Ctrl + =、Ctrl + -、Ctrl + 0，縮放的是那個網頁。網頁被放大或縮小時，網頁上方顯示網址的那一列會出現目前的百分比（例如「110%」），點一下就回到 100%。

10.10 高負載觀看加速

Windows 版的 HakoSpace Desktop 在「桌面設定 → 行為」的最下方提供「高負載觀看加速」開關，預設為關閉（桌面設定的開啟方式見 §7.9）。這個設定適合一邊玩遊戲、一邊在語音頻道觀看其他成員螢幕分享的情況：遊戲讓顯示卡處於高負載時，用來減輕你看到的分享畫面卡頓。

什麼時候會套用：開關打開後，只要你在語音頻道中觀看其他成員的螢幕分享，HakoSpace 就會套用加速；你不再觀看任何分享、離開語音頻道，或把開關關掉，加速就會解除。開關切換後立即生效，不需要重新加入語音頻道。關於系統管理員權限，設定頁的說明提到：多數系統可以直接套用；如果系統要求系統管理員權限，套用時會出現 UAC 提示。

加速中的指示：加速套用的期間，會出現以下指示：

加速開始時，主視窗右下角會短暫出現「觀看加速中」提示，數秒後自動消失。
主視窗不是全螢幕時，視窗最上方標題列的右側（「社群版」字樣左邊）會持續顯示「⚡ 觀看加速中」。
主視窗全螢幕時（例如按了舞台上某個磚的「全螢幕」按鈕，見 §3.1），標題列會收起，改由畫面左上角持續顯示「⚡ 觀看加速中」。
「桌面設定 → 行為」的「高負載觀看加速」底下會顯示綠色的「加速中」。

這些指示只在加速套用的期間出現：打開開關時如果還沒有在觀看分享，要等你開始觀看才會出現；加速解除後就會消失。

沒有套用成功時：主視窗右下角會出現一則警告提示，內容依原因而不同：

「觀看加速未啟用：已取消系統管理員授權」（你拒絕了 UAC 提示）
「觀看加速未啟用：缺少系統管理員權限」
「觀看加速套用失敗」

這三種提示的下方都附註「螢幕分享仍可正常觀看，只是未套用高負載加速。」。

設定頁上「高負載觀看加速」底下也會出現對應的一行說明，例如「已取消系統管理員授權，加速未套用；分享仍可正常觀看。」。

這則警告會留在畫面上，你可以按 X 把它關掉；你不再觀看任何分享、離開語音頻道或關掉開關時，它也會消失。想再試一次，到「桌面設定 → 行為」把「高負載觀看加速」關掉再打開即可。

暫時無法解除時：加速應該解除卻沒能立刻解除時，主視窗右下角會持續顯示「觀看加速中」，並附註「加速仍在生效中，暫時無法解除；系統稍後會自動再試。」。設定頁上「加速中」的下方也會出現同一句話。加速解除後，這則提示就會消失。

10.11 遊戲 HUD

Windows 版的 HakoSpace Desktop 提供「遊戲 HUD」：你在語音頻道中玩遊戲時，它會在遊戲畫面上顯示語音成員與文字聊天。在遊戲中按 HUD 快捷鍵可以開啟「HUD 面板」，在面板裡打字聊天、調整語音、觀看其他成員的分享，或直接分享目前的遊戲畫面。

遊戲 HUD 以 Microsoft Edge WebView2 執行階段顯示，這台電腦需要裝有這個執行階段；啟用之後如果沒有安裝，設定頁的「狀態」會說明並提供下載按鈕（見下方「狀態」）。

啟用遊戲 HUD

開啟「桌面設定」（開啟方式見 §7.9），切到左側的「HUD」分頁。
在最上面的「遊戲 HUD」區塊勾選「啟用遊戲 HUD」。這個選項預設不勾選。
第一次勾選時，會先出現「啟用遊戲 HUD 前」對話框，說明 HUD 會讀取哪些視窗資訊、怎麼接收鍵盤輸入、分享整個螢幕或錄影時的情況，以及 HUD 使用的 WebView2 元件（內容見下方「第一次啟用時的說明」）。按「我了解，啟用 HUD」才會啟用；按「取消」則維持關閉。

「HUD」分頁的設定改了立即生效，不需要另外儲存。這些設定存在這台電腦上，不論連線到哪一個伺服器都用同一份。萬一某項變更沒能存下，「遊戲 HUD」區塊會顯示「這項變更沒有儲存，設定維持原狀。」

第一次啟用時的說明

「啟用遊戲 HUD 前」對話框只在第一次啟用時出現。它說明的四件事整理如下；完整條文見隱私權政策第 6 節「桌面應用程式」（開啟方式見 §7.10）。

讀取的視窗資訊：為了判斷要不要在某個程式上顯示 HUD、顯示在哪裡、維護你的停用清單，以及在你於 HUD 面板按「分享目前遊戲畫面」時指定要分享的視窗（分享出去的畫面內容本身，依隱私權政策關於螢幕分享的說明處理），桌面應用程式會讀取目前前景視窗的標題、程序識別碼、執行檔路徑、視窗識別碼、視窗位置及大小，以及該視窗所在螢幕與其縮放比例。對話框寫明：「這些資訊僅於你的裝置上處理，不會傳送至 HakoSpace，也不會傳送至你所連線的伺服器。」
鍵盤輸入：「遊戲 HUD 本身不在系統層級監聽鍵盤，只透過作業系統的快捷鍵註冊功能，接收你為 HUD 設定的那組快捷鍵。HUD 面板開啟時，面板會成為前景視窗並接收你的鍵盤輸入，與切換到其他視窗相同；部分程式可能以直接讀取鍵盤狀態等方式偵測按鍵，這不是本軟體所能控制的。桌面應用程式不會保存你的按鍵紀錄，也不會將按鍵資料傳送至任何伺服器；你在 HUD 輸入框主動送出的訊息，與在應用程式內送出的訊息相同，會傳送至你所連線的伺服器。」
錄影：「分享整個螢幕或用第三方軟體錄影時，HUD 顯示的內容（包含其他成員的訊息）會一併被錄進去。」
WebView2：HUD 以 Microsoft Edge WebView2 執行階段顯示；這個元件的診斷資料收集，由 Microsoft 的隱私權聲明與 Windows「診斷與意見反應」設定規範。

狀態

「遊戲 HUD」區塊的「狀態」會即時顯示 HUD 目前的情況：

「已關閉」：還沒有啟用遊戲 HUD。
「待命中 — 進入語音頻道後啟動」：已經啟用，等你進入語音頻道。
「啟動中…」：HUD 正在啟動。
「HUD 已就緒」：HUD 正在執行，但目前沒有附著在任何程式上。在語音頻道中操作 HakoSpace 的視窗（包括桌面設定）時，看到的就是這個狀態。
「已附著：」後面接著一個視窗標題：HUD 正附著在這個程式上（見下方「什麼時候會出現」）。

HUD 無法運作時，這一行會直接寫出原因與該怎麼做，例如：

「沒有安裝 Microsoft Edge WebView2 執行階段，HUD 無法顯示。」：下方會多一個「下載 WebView2 執行階段」按鈕，按下後會用瀏覽器開啟 Microsoft 的 WebView2 下載頁面。安裝完成後，回到這一頁查看狀態。
「HUD 連續多次無法啟動，本次語音不再嘗試。離開語音頻道後重新加入即可再試一次。」
「無法建立 HUD 需要的本機連線。重新啟動 HakoSpace 可再試一次。」
「這個版本裡找不到 HUD 程式，請重新安裝 HakoSpace 桌面版。」

什麼時候會出現

啟用之後，HUD 在你進入語音頻道時啟動，離開語音頻道 30 秒後關閉；設定頁上的說明是「進入語音頻道後啟動，離開語音 30 秒後關閉。」如果勾選「啟用遊戲 HUD」時你已經在語音頻道中，HUD 會立即啟動。

HUD 啟動後，會「附著」在你目前正在使用、而且最大化或以無邊框全螢幕執行的程式上（通常就是遊戲），顯示在它的畫面上並跟著它移動。切換到其他程式時，HUD 會重新判斷：新的程式符合條件，就改附著在它上面；不符合就隱藏。HakoSpace 自己的視窗、Windows 的桌面與工作列、你加入「停用清單」的程式，以及內建停用清單裡的常見工具軟體（見下方「停用清單」），都不會出現 HUD。

附著之後，HUD 有內容要顯示時才會出現在遊戲畫面上：

「語音成員」平常只列出正在說話的人，以及剛加入或剛離開的成員（標示「＋加入」「－離開」）。
「文字聊天」預設在新訊息進來時出現，一段時間後各自消失。

所以平常沒有人說話、沒有人加入或離開、也沒有新訊息時，遊戲畫面上通常看不到語音成員與文字聊天。想讓它們一直顯示，可以勾選語音成員的「釘選」，或把文字聊天的「顯示方式」改成「總是顯示」（見下方「外觀與其他設定」）。

啟動提示：每次進入語音頻道後，HUD 第一次附著到某款遊戲時，畫面上方正中會短暫顯示兩行提示：「HUD 已啟動 · 按 Shift + ` 開啟 HUD 面板」與「不想在這款遊戲顯示？按 Shift + ` → 在此遊戲停用 HUD」（提示裡寫的是你設定的 HUD 快捷鍵）。不想看到這段提示，在「HUD」分頁取消勾選「顯示啟動提示」即可。

HUD 面板

在遊戲中按 HUD 快捷鍵（預設是 Shift + `，更改方式見下方「HUD 快捷鍵」），就會開啟「HUD 面板」：畫面暗下一層，HUD 上的內容展開成可以操作的樣子。HUD 正附著在某個程式上時才開得了面板。面板開啟時怎麼接收鍵盤輸入，見上方「第一次啟用時的說明」。

要返回遊戲，再按一次 HUD 快捷鍵或按 Esc。面板頂端正中有操作提示，例如「拖曳可移動 · Esc 或 Shift + ` 返回遊戲」；HUD 與 HakoSpace 的連線中斷時，這裡會另外顯示「與 HakoSpace 的連線中斷，正在重新連線…」。

面板裡有：

「語音成員」：列出語音頻道裡的其他成員。每人旁邊有一條音量滑桿，這與成員選單裡的「使用者音量」是同一個設定（見 §3.1）；數值不是 100% 時旁邊會出現「重設」，按下即回到 100%。
你自己的控制列（在語音成員下方）：「靜音麥克風」「拒聽」「離開頻道」「分享目前遊戲畫面」四個按鈕，以及「輸出音量」「輸入音量」兩條滑桿。
「螢幕分享」：有人分享畫面時出現在控制列下方，見下方「觀看分享與 PiP 視窗」。
「文字聊天」：可以往上捲動的聊天內容，底部是輸入框，見下方「文字聊天與輸入框」。
右上角的「在此遊戲停用 HUD」，見下方「停用清單」。

「語音成員」與「文字聊天」兩個區塊的標頭上，各有「背景」「內容」兩條透明度滑桿；語音成員另有「名稱」與「釘選」，文字聊天另有「內容大小」滑桿與「釘選」（文字聊天的「釘選」就是把「顯示方式」切換成「總是顯示」）。按住標頭拖曳可以移動整個區塊，拖曳文字聊天的右下角可以調整寬度與高度上限。這些調整與「桌面設定 → HUD」裡對應的設定是同一份，會一直保留。

文字聊天與輸入框

HUD 上的「文字聊天」就是你所在語音頻道的文字聊天，與語音通話介面裡的文字聊天區相同（見 §3.1）。遊戲中（HUD 面板關閉時）怎麼顯示，由「桌面設定 → HUD」裡「文字聊天區」的「顯示方式」決定：

「自動隱藏」（預設）：新訊息進來時出現，一段時間後各自消失。
「總是顯示」：一直顯示最近的幾則訊息。
「關閉」：不顯示文字聊天。

遊戲中，長訊息與程式碼區塊只顯示開頭，在 HUD 面板裡會完整顯示。一則訊息有多張圖片時，HUD 上只顯示第一張，其餘以「+2 張圖片」這樣的字樣表示；其他檔案只顯示檔名。防劇透的內容要在 HUD 面板裡點一下才會顯示。在 HUD 面板裡可以往上捲動看較早的訊息，捲離最底部時會出現「跳到最新」。

輸入框：開啟 HUD 面板時，文字聊天的底部就是輸入框，面板一開就可以直接打字。輸入框裡預設顯示「在 #{頻道名稱} 中發送訊息」，下方提示「Enter 送出 · Shift+Enter 換行」。

按 Enter 送出，送出後面板會留著，可以繼續打字；按 Shift + Enter 換行。用注音等輸入法選字時按的 Enter 與 Esc 只用在選字上，不會送出訊息，也不會返回遊戲。
送出的訊息會出現在文字聊天裡，與在 HakoSpace 視窗裡送出的訊息相同，會傳送至你所連線的伺服器。
訊息沒有送出、或沒有收到送出確認時，輸入框上方會顯示：「沒有收到送出確認，訊息可能已經送出」（請先看文字聊天裡有沒有出現這則訊息，再決定要不要重送）、「你已不在語音頻道中」或「訊息沒有送出」。這些情況下，你打的字會留在輸入框裡。
關閉 HUD 面板時（例如返回遊戲），輸入框裡還沒送出的文字與圖片不會保留。

「顯示方式」設成「關閉」或開啟「隱私模式」時，文字聊天會整個收起來，HUD 面板裡也一樣；面板頂端會顯示「文字區已關閉」或「隱私模式：文字區已關閉」。

貼上圖片

在 HUD 面板的輸入框按 Ctrl + V，可以把截圖之類的圖片附加到訊息上。例如用截圖工具截好圖，在輸入框貼上、打幾個字，再按 Enter 一起送出。

一次可以附加一張圖片。貼上後，輸入框上方會出現縮圖與檔名；處理完成之前會顯示「圖片處理中…」，這時按 Enter 不會送出。按縮圖旁的 ×（滑鼠停留會顯示「移除圖片」）可以拿掉這張圖。
已經附加圖片時，不打字也可以直接按 Enter 送出。
貼上時可能出現的提示：「這裡只能附加圖片」、「一次只能附加一張圖片」（已經附加了一張；原本那張會留著）、「圖片太大，沒有附加」，或「圖片沒有附加成功」（這時圖片不會附加上去，可以再貼上一次）。
送出時可能出現的提示：「附件已失效，請重新貼上」，或「圖片沒有附加成功」。送出時出現「圖片沒有附加成功」，圖片會留在輸入框上方，再按一次 Enter 會重新嘗試；伺服器不接受這張圖片時（例如超過伺服器允許的上傳大小）顯示的也是這一句，這時再按 Enter 也送不出去，請按 × 移除這張圖片，改貼較小的圖片。
送出之前請不要返回遊戲：關閉 HUD 面板時，還沒送出的圖片會跟著丟掉。

送出後就是一則附有圖片的一般訊息，與在 HakoSpace 視窗裡附加圖片送出的相同，會傳送至你所連線的伺服器。要傳送其他類型的檔案，請回到 HakoSpace 視窗，用訊息輸入框的「附加檔案」（見 §2.1）。

觀看分享與 PiP 視窗

有人分享畫面時，HUD 面板裡語音成員區塊的最下方會出現「螢幕分享」，每個分享一列：分享者的名稱，鏡頭畫面另標「視訊」，OBS 等工具推進來的外部串流標「外部串流」，帶聲音的分享再標「含音訊」。

按「觀看」，這個分享會在 PiP 視窗（永遠置頂的子母畫面視窗）裡播放；按鈕隨即變成「停止觀看」，再按一次就關閉。
帶聲音的分享（你自己的除外）有「音量」滑桿，調整你聽到的這個分享的聲音。
你自己的螢幕分享那一列只顯示「你的分享」。

PiP 視窗出現在遊戲畫面的右下角，同時開了好幾個時會往上疊。你可以拖曳移動它；滑鼠移到 PiP 視窗上時，底部會出現控制列，按右側的四個角框線圖示（滑鼠停留會顯示「全螢幕」）可以切換全螢幕。要關閉時，按右上角的叉號圖示（滑鼠停留會顯示「關閉」），效果與在分享列按「停止觀看」相同。分享結束、你離開語音頻道，或遊戲 HUD 結束執行時，PiP 視窗會自動關閉。

PiP 視窗開著時，HakoSpace 視窗舞台上原本的磚會換成一塊寫著「已在彈出視窗播放」的磚；按這塊磚上的「收回」，PiP 視窗會關閉，畫面回到舞台上繼續播放。

同時能開幾個 PiP 視窗，由「桌面設定 → HUD」的「PiP 視窗上限」決定，可選 1 到 4，預設 2。在 HakoSpace 視窗舞台上觀看中的分享也算在這個上限內（一位成員同時分享螢幕與鏡頭算兩個）。超過上限時，分享列下方會顯示「已達 PiP 上限（2）」（括號裡是你設定的上限）與「先停止觀看其中一個，或到桌面設定調高上限」；這時可以在 HUD 面板按「停止觀看」關掉一個 PiP 視窗，或在 HakoSpace 視窗舞台上按那個磚的「停止觀看」（見 §3.1）。

分享目前遊戲畫面

在 HUD 面板的控制列按「分享目前遊戲畫面」，HakoSpace 會直接分享 HUD 目前附著的那個遊戲視窗，面板也會同時關閉、返回遊戲。分享開始後，畫面上方會短暫顯示「分享中」，以及「按 Shift + ` 開啟 HUD 面板可停止分享」（寫的是你設定的 HUD 快捷鍵）。其他成員看到的是一般的螢幕分享（見 §3.4）。

分享期間開啟 HUD 面板時，畫面外圍會有一圈紅框，面板頂端顯示「分享中」（前面有一個紅點）與「停止分享」按鈕，控制列上的按鈕也會變成「停止分享」。按其中任一個「停止分享」，分享就會停止並返回遊戲，畫面上方會顯示「已停止分享」。

分享沒有順利開始時，畫面上方會顯示原因，例如「目前已有分享進行中」「找不到目前遊戲的視窗」或「無法開始分享。詳細原因顯示在 HakoSpace 視窗。」。如果顯示的是「沒有收到分享的確認」，表示還沒確認分享是否已經開始：之後確認開始時，畫面上方會再顯示「分享中」；你也可以開啟 HUD 面板，看看有沒有紅框與帶紅點的「分享中」。

停用清單

不想讓 HUD 出現在某款遊戲或某個程式上時：

在那個程式上開啟 HUD 面板，按右上角的「在此遊戲停用 HUD」。
確認對話框「在這款遊戲停用 HUD？」會寫出這款遊戲的視窗標題，並說明它會加入停用清單、HUD 立即隱藏，要恢復時到桌面設定的「HUD → 停用清單」移除。
按「停用」：面板關閉，HUD 在這個程式上隨即隱藏，之後也不會再出現。按「取消」則不加入。對話框顯示「無法加入停用清單」時，可以再按一次「停用」。

「桌面設定 → HUD」的「停用清單」區塊列出所有停用的程式：每一列上面是程式的檔名，下面是完整路徑。按該列右側的垃圾桶圖示（滑鼠停留會顯示「從停用清單移除：{名稱}」）就會立即移除，之後 HUD 又可以出現在這個程式上。清單是空的時候顯示「停用清單是空的。」停用清單存在這台電腦的桌面設定裡，直到你移除為止。

同一個區塊也說明了 HUD 的內建停用清單：「HUD 預設也不會顯示在常見的工具軟體上（Office、瀏覽器、程式編輯器、通訊與會議軟體、影片播放器、遊戲平台的啟動器、遠端桌面等）。這份清單內建在 HUD 裡，不佔用下面的停用清單。」所以在這類程式上看不到 HUD，是預設的行為。

HUD 快捷鍵

「桌面設定 → HUD」的「HUD 快捷鍵」區塊寫著：「在遊戲中按這組鍵開啟 HUD 面板；再按一次或按 Esc 返回遊戲。」預設是 Shift + `。要更改：

點顯示目前組合鍵的按鈕，按鈕會變成「按下快捷鍵…」。
按下想用的組合鍵，設定隨即存下；這時改按 Esc 則是取消。

組合鍵要包含 Ctrl、Alt、Shift、Win 其中之一，或單獨使用 F1–F24 功能鍵；不符合時會顯示「請搭配 Ctrl / Alt / Shift / Win，或使用功能鍵（F1–F24）。單一按鍵會在任何地方都被 HUD 取走，包括你正在玩遊戲的時候。」

HUD 快捷鍵在 HUD 啟動之後才有作用（見上方「什麼時候會出現」），按下時由 HUD 接收。它與「桌面設定 → 快捷鍵」分頁的全域快捷鍵（見 §10.3）分開設定。

外觀與其他設定

「桌面設定 → HUD」的其餘區塊可以調整 HUD 的大小、顯示方式與外觀：

「整體內容尺寸」：「尺寸」可選「小」「中」「大」，預設「中」，用來調整整個 HUD 的大小，包括語音成員、文字聊天區，以及面板上的提示與按鈕；HUD 也會依螢幕解析度自動調整。
「語音成員 widget」：勾選「釘選」後，遊戲中會一直顯示全部成員與狀態（預設不勾選）；「顯示名稱」決定遊戲中要不要顯示成員名稱（預設勾選）；「頭像大小」可選「大」（預設）或「小」。
「文字聊天區」：「顯示方式」見上方「文字聊天與輸入框」。「內容大小」「寬度」「高度上限」三條滑桿的右側會顯示目前的數值；「內容大小」只作用在文字聊天區，是在「整體內容尺寸」之上再放大或縮小。
「透明度」：「語音成員」與「文字聊天」各有「背景」「內容」兩條滑桿，都可以從 0% 調到 100%。區塊上的提醒是「背景與內容都調到 0% 的 widget 不會顯示；把其中一個調回來，它就會再出現。」
「位置」：兩個區塊的位置在 HUD 面板裡直接拖曳決定；按「重設 widget 位置」會回到預設位置（語音成員在左上、文字聊天在左下），其他設定不受影響。
「隱私模式」（預設不勾選）：說明寫著「關閉文字區。分享整個螢幕或用第三方軟體錄影時，HUD 顯示的內容（包含其他成員的訊息）會一併被錄進去。」
「PiP 視窗上限」：見上方「觀看分享與 PiP 視窗」。
「顯示啟動提示」（預設勾選）：見上方「什麼時候會出現」。

伺服器也要更新

遊戲 HUD 的部分功能需要你所連線的伺服器也是新版（見本章章首）。伺服器版本較舊時，可能會遇到：

遊戲畫面上與 HUD 面板裡都看不到語音成員與文字聊天。
按「分享目前遊戲畫面」後出現「無法開始分享。詳細原因顯示在 HakoSpace 視窗。」
在輸入框貼上圖片時出現「圖片沒有附加成功」。

遇到這些情況，請伺服器的 owner / admin 把伺服器更新到新版（見《管理員手冊》§11.5）。