語音測試

語音測試功能用於測試麥克風和揚聲器的語音識別能力，確保音訊裝置在面試訓練中能夠正常工作。透過這個功能，你可以驗證麥克風是否能被正確識別、揚聲器是否能捕獲系統音訊，為後續的模擬面試和麵試訓練做好準備。

1. 頁面導航

1.1 開啟主應用視窗

在啟動臺搜尋 CueMate 應用圖示，單擊左鍵開啟應用程式。

啟動 CueMate 桌面應用後，可以看到懸浮在螢幕正上方的控制視窗。控制視窗從左到右的按鈕功能依次為：

• "訪問 CueMate 網站"圖示：點選開啟 CueMate 官方網站
• "語音識別"按鈕：點選啟動語音識別功能，開啟語音功能視窗
• "提問 AI"按鈕：點選開啟 AI 提問視窗，快速向 AI 提問，獲取答案
• "互動模式"圖示：切換視窗的點選穿透模式（互動模式可正常操作視窗，穿透模式點選會穿透到下層應用）
• "主應用視窗"圖示：點選開啟主應用視窗，進入後臺管理介面
• "顯示/隱藏"圖示：點選隱藏或顯示控制欄以及其他所有視窗

點選懸浮控制欄上的"語音識別"按鈕（麥克風圖示），開啟面試功能視窗。

1.2 進入語音測試頁面

在面試功能視窗頂部，點選"語音測試"標籤頁，進入語音測試頁面。頁面分為兩個測試區域：麥克風測試和揚聲器測試。

2. 系統許可權授權

IMPORTANT

語音測試功能需要以下系統許可權：

• 麥克風許可權：用於麥克風音訊採集（麥克風測試）
• 錄屏與系統錄音許可權：用於系統音訊捕獲（揚聲器測試）

請按照以下步驟完成授權，否則測試功能將無法正常使用。

在開始測試之前，需要先授予 CueMate 必要的系統許可權。語音測試功能需要兩個許可權：

• 麥克風許可權：用於麥克風音訊採集（麥克風測試）
• 錄屏與系統錄音許可權：用於系統音訊捕獲（揚聲器測試）

2.1 麥克風許可權授權

首次使用麥克風功能時，系統會自動彈出授權提示框，請點選"允許"按鈕授予 CueMate 訪問麥克風的許可權。

如果誤點了"不允許"或意外關閉了授權視窗：

1. 開啟"系統偏好設定 > 隱私與安全性"
2. 在左側選單中找到並點選"麥克風"

3. 在右側應用列表中找到 CueMate，勾選其右側的開關以啟用麥克風許可權

2.2 揚聲器許可權授權

揚聲器測試需要使用 macOS 的系統音訊捕獲功能（AudioTee），該功能需要"錄屏與系統錄音"許可權才能正常工作。

首次使用揚聲器測試功能時，系統會自動彈出授權提示框，請點選"允許"按鈕授予 CueMate 訪問系統音訊的許可權。

如果誤點了"不允許"或意外關閉了授權視窗：

1. 開啟"系統偏好設定 > 隱私與安全性"
2. 在左側選單中找到並點選"錄屏與系統錄音"

3. 在右側應用列表中找到 CueMate，勾選其右側的開關以啟用系統音訊捕獲許可權
4. 如果列表中沒有 CueMate，可以點選列表底部的"+"按鈕手動新增

授權後，CueMate 就可以捕獲系統音訊（揚聲器播放的聲音），用於面試訓練場景中識別"面試官"的語音。

注意：

• "錄屏與系統錄音"許可權僅用於系統音訊捕獲，CueMate 不會錄製您的螢幕畫面
• 授權後無需重啟應用（首次預設自動重啟應用），直接返回 CueMate 點選測試按鈕即可
• 底部提示"僅系統錄音 - 允許下面的應用程式訪問和錄製系統音訊"說明此許可權僅用於音訊功能

3. 麥克風測試

麥克風測試用於驗證麥克風裝置能否正常採集音訊並被 cuemate-asr 服務識別轉換為文字。這是模擬面試和麵試訓練中使用者語音輸入的核心功能。

3.1 選擇麥克風裝置

在"麥克風裝置"下拉框中，選擇你要測試的麥克風裝置。

裝置選擇說明：

• 系統會自動列出所有可用的音訊輸入裝置
• 預設選中在 語音設定 頁面配置的麥克風裝置
• 如果沒有配置，則自動選中系統預設的第一個可用裝置
• 推薦使用電腦內建麥克風（如 MacBook 內建麥克風）

3.2 開始麥克風測試

選擇好麥克風裝置後，點選"測試"按鈕（藍色按鈕），系統會自動執行以下流程：

1. 啟動麥克風音訊採集，開始錄製您的聲音
2. 連線 cuemate-asr 語音識別服務（WebSocket 連線）
3. 將採集的音訊實時傳送給 cuemate-asr 進行識別
4. 實時顯示識別出的文字內容
5. 根據識別結果自動判斷測試是否成功

測試步驟：

1. 點選"測試"按鈕後，對著麥克風清晰地說話
2. 建議說一句完整的話，5-30 個字左右（如"今天天氣真不錯"）
3. 系統會在麥克風測試區域實時顯示識別的文字
4. 測試狀態從"暫未測試"變為"測試中"
5. 滿足以下任一條件時，測試自動結束：
   • 說話時長 ≥2 秒且識別文字長度在 5-30 字之間
   • 識別文字長度超過 30 字
   • 說話時長 ≥15 秒且成功識別到文字
   • 總測試時長 ≥30 秒（測試超時）

3.3 檢視測試結果

測試完成後，麥克風測試區域會顯示測試結果狀態和詳細資訊：

測試成功

• 狀態圖示顯示為綠色勾號 ✓
• 狀態文字顯示"麥克風測試完成"
• 下方綠色區域顯示"麥克風識別結果："
• 展示完整的識別文字內容（如"今天天氣真不錯"）
• 顯示測試用時（如"00:00:15"表示 0 分 15 秒）

測試失敗

• 狀態圖示顯示為紅色叉號 ✗
• 狀態文字顯示"測試失敗"
• 下方紅色區域顯示錯誤原因
• 常見錯誤資訊：
  • "連線麥克風識別服務失敗"：cuemate-asr 服務未啟動或無法連線
  • "麥克風識別 WebSocket 連線錯誤"：網路連線問題
  • "啟動麥克風識別失敗"：麥克風許可權未授予或裝置不可用
• 顯示測試用時

檢視詳細資訊

點選結果區域可以展開檢視完整的識別文字或錯誤詳情。如果識別內容較長，可以透過滾動檢視全部內容, 或去往 日誌管理 檢視詳情。

4. 揚聲器測試

揚聲器測試實際上是測試系統音訊捕獲能力，驗證 AudioTee 能否正常捕獲揚聲器播放的音訊並被 cuemate-asr 識別。這個功能用於面試訓練場景中識別面試官的語音（透過捕獲面試軟體如騰訊會議、Zoom 的音訊輸出）。

4.1 選擇揚聲器裝置

在"揚聲器裝置"下拉框中，選擇你要測試的揚聲器裝置。

裝置選擇說明：

• 系統會自動列出所有可用的音訊輸出裝置
• 預設選中在語音設定頁面配置的揚聲器裝置
• 如果沒有配置，則自動選中系統預設的第一個可用裝置
• 推薦使用電腦內建揚聲器（如 MacBook 內建揚聲器）

4.2 開始揚聲器測試

選擇好揚聲器裝置後，點選"測試"按鈕（藍色按鈕），系統會自動執行以下流程：

1. 啟動 AudioTee 系統音訊捕獲
2. 連線 cuemate-asr 語音識別服務
3. 監聽揚聲器播放的系統音訊
4. 將捕獲的音訊實時傳送給 cuemate-asr 進行識別
5. 實時顯示識別出的文字內容

測試步驟：

1. 點選"測試"按鈕後，播放一段包含語音的音訊或影片

建議1：直接進入 百度翻譯頁面，貼上一段文字，語音播放：

建議2：直接進入 谷歌翻譯頁面，貼上一段文字，語音播放：

2. 建議播放清晰的中文或英文語音內容
3. 確保音量適中，不要靜音
4. 系統會在揚聲器測試區域實時顯示識別的文字
5. 測試狀態從"暫未測試"變為"測試中"
6. 滿足測試條件後自動結束（條件與麥克風測試相同）

4.3 檢視測試結果

測試完成後，揚聲器測試區域會顯示測試結果狀態和詳細資訊：

測試成功

• 狀態圖示顯示為綠色勾號 ✓
• 狀態文字顯示"揚聲器測試完成"
• 下方綠色區域顯示"揚聲器識別結果："
• 展示完整的識別文字內容
• 顯示測試用時

測試失敗

• 狀態圖示顯示為紅色叉號 ✗
• 狀態文字顯示"測試失敗"
• 下方紅色區域顯示錯誤原因
• 常見錯誤資訊：
  • "AudioTee 不可用，無法進行系統音訊捕獲"：AudioTee 模組載入失敗
  • "連線揚聲器識別服務失敗"：cuemate-asr 服務未啟動或無法連線
  • "啟動揚聲器捕獲失敗"：螢幕錄製許可權未授予
• 顯示測試用時

常見問題解決：

• 如果提示許可權問題，請參考"2.2 錄屏與系統錄音許可權授權"章節完成授權
• 確保播放的音訊音量足夠大，能夠被系統捕獲
• 確認 cuemate-asr 服務正常執行

5. 注意事項

5.1 服務依賴

語音測試功能依賴 cuemate-asr 服務正常執行（預設埠 10095）。如果服務未啟動，測試會失敗並提示連線錯誤。

5.2 測試建議

麥克風測試：

• 保持麥克風距離適中（10-30 釐米）
• 說話清晰，語速適中
• 選擇安靜的環境，避免噪音干擾

揚聲器測試：

• 播放清晰的中文或英文語音內容
• 音量適中，不要靜音或過大
• 確保音訊內容包含完整的語句

相關頁面

• 語音設定 - 配置預設的麥克風和揚聲器裝置
• 系統設定 - 配置系統基礎引數
• 語音提問 - 使用語音提問功能
• 模擬面試 - AI 模擬面試
• 面試訓練 - 真人面試訓練