# 操作

用戶端預設按鍵綁定與 /ssvc 指令

Source: https://socketsvc.vercel.app/zh-TW/client/controls
## 預設按鍵綁定 [#default-key-bindings]

這些按鍵綁定位於 Minecraft「控制」設定的「SocketSVC 語音」類別下，可以在那裡修改。

| 按鍵綁定名稱 | 預設按鍵 | 用途 |
| --- | --- | --- |
| 開啟語音設定 | <kbd>V</kbd> | 開啟 SocketSVC 設定；在標題畫面、尚未加入世界或伺服器時也能使用 |
| 按鍵說話 | <kbd>B</kbd> | 在「按鍵說話」模式下，按住說話、放開停止 |
| 切換麥克風靜音 | <kbd>M</kbd> | 切換麥克風靜音；停止接收語音時無法開啟麥克風 |
| 切換接收語音 | <kbd>N</kbd> | 切換停止接收語音；關閉接收語音時會一併將麥克風靜音，重新開啟後則恢復先前的靜音狀態 |
| 切換發話指示圖示 | <kbd>H</kbd> | 切換左下角的 HUD 狀態圖示（與「顯示語音狀態」設定相同） |
| 開啟音效板 | <kbd>U</kbd> | 開啟[音效板](/client/soundboard) |
| 開啟語音群組 | <kbd>G</kbd> | 開啟[語音群組](/client/groups)選單；如果伺服器關閉了群組功能，選單也會說明原因 |
| 音效板快速選取（按住＋滾輪） | 未綁定 | 按住會開啟快速選取介面，放開即播放反白的音效 |
| 音效板欄位 1–10 | 未綁定 | 播放指派給該欄位的音效 |

- 除了在標題畫面按 <kbd>V</kbd>，這些按鍵只在沒有開啟其他畫面時才有作用。
- 在 Simple Voice Chat 或 Plasmo Voice 已連上、但沒有 SocketSVC 的伺服器上，這些按鍵不會有反應，讓給另一個模組使用。請參閱[相容性](/client/compatibility#running-alongside-another-voice-chat-mod)。
- 原有的按鍵綁定會保留；升級後若想改用新的預設按鍵，請手動變更或重設。
- 靜音與停止接收語音的狀態會儲存下來，重新啟動遊戲後也不會重設。
- 在裝有 Mod Menu 的 Fabric 上，也能從 Mod Menu 開啟設定。

## 指令 [#commands]

| 指令 | 用途 |
| --- | --- |
| `/ssvc`、`/ssvc settings` | 開啟設定（尚未完成首次設定時，會改為開啟首次設定） |
| `/ssvc status` | 顯示連線狀態、音量等級與裝置診斷資訊 |
| `/ssvc reconnect` | 索取新的授權並重新連線；有冷卻時間限制，也需要伺服器支援 |
| `/ssvc mute` | 切換麥克風靜音，並回覆「麥克風已開啟」或「麥克風已關閉」 |
| `/ssvc deafen` | 切換停止接收語音，並回覆「接收語音已開啟」或「接收語音已關閉」 |
| `/ssvc setup` | 重新開啟設定對話框；只會套用設定，不會重新連線 |
| `/ssvc mictest` | 開啟「進階設定」分頁，可在這裡測試麥克風 |
| `/ssvc groups` | 開啟[語音群組](/client/groups)選單，與按 <kbd>G</kbd> 開啟的畫面相同 |

### `/ssvc status` [#ssvc-status]

會輸出以下內容：

```text title="範例輸出"
SocketSVC status:
  Connection: Connected
  Muted: Off, Deafened: Off
  Mic RMS level: 120 (threshold 300)
  Frames sent this session: 1532
  Input device: System default
  Output device: System default
```

輸出中的 threshold 是目前生效的語音偵測門檻，「自動」模式下固定為 300。

### `/ssvc reconnect` [#ssvc-reconnect]

斷線後，語音通常會[自動重新連線](/client/troubleshooting#automatic-reconnection)，很少需要用到這個指令。等自動重試停止了再使用即可：

- 伺服器必須已更新，並支援重新索取授權。
- 每 5 秒只能索取一次，與伺服器的保護機制一致。成功時會回覆「已要求新語音授權，請稍候；每 5 秒可要求一次。」
- 如果當下無法發出請求，會回覆「目前無法連線，請稍後再試。」

## 麥克風音量 [#microphone-volume]

在「一般設定」分頁調整「麥克風音量」（0–200%，預設 100%）。變更會立即生效，關閉設定時儲存：

- 0% 會送出無聲的訊號；超過 100% 會放大音量並套用限幅。
- 自動與手動增益模式都適用，也不會改變語音偵測門檻。
- 「進階設定」分頁的麥克風測試音量，顯示的仍是調整之前的輸入。
- 只需要更新用戶端。

其他設定請參閱[設定](/client/settings)。