語音整合設定指南

1.1 版本

版本	功能變動
V3.22.0	-

1.2 應用場景

FineChatBI 的語音整合功能支援在行動端和 PC 端進行語音錄入，打破了傳統的文字輸入限制，為使用者提供更加方便、高效的交談模式。

1.2 功能簡介

使用者開啟語音輸入功能後，FineChatBI 錄入使用者的語音檔案，併傳送至配置的API地址，由API地址完成語音轉寫，並將轉寫後的正文自動填入輸入框。

2.1 API概覽

• 請求方式：POST

• Content-Type：multipart/form-data（檔案透過此格式傳送至API）

• 請求地址：企業語音轉寫服務地址

在「智慧問答配置>其他配置」中開啟「語音服務」，輸入企業語音轉寫服務地址。

2.2 輸入參數

2.3 匯出參數

2.4 回應範例

為避免中文亂碼，API回應頭（Header）需指定 UTF-8 編碼，格式如下：

Content-Type: application/json; charset=utf-8  

成功回應

{
  "data": "轉寫後的正文內容"
}

錯誤回應

{
  "errorCode": "錯誤碼",
  "errorMessage": "錯誤資訊"
}

2.5 注意事項

• 檔案透過 multipart/form - data 格式傳送，以確定能正確傳輸音頻檔案等二進制資料。

• 檔案是二進制格式，不能直接當作正文處理，需按特定方式解析和處理。

• 需要使用 MultipartFile 或類似方式接收，後終止收程式碼應適配該資料格式。

• 錯誤資訊會原封不動地顯示在 FineChatBI 介面上，方便使用者快速瞭解轉寫失敗原因。

2.6 效果查看

配置成功後，可在 PC 端和行動端透過語音進行提問，如下圖所示：

瀏覽器（ Chrome）出於安全策略限制，預設禁止透過 HTTP 協定呼叫麥克風、攝像頭等敏感裝置權限。若 FineBI 部署在 HTTP 環境中，智慧問答可能無法呼叫麥克風。此時需透過瀏覽器特殊配置，將目標 HTTP 地址視為安全來源，以正常使用語音功能。

本節以 Chrome 為例介紹配置步驟：

1）在 Chrome 中開啟：chrome://flags/#unsafely-treat-insecure-origin-as-secure

2）設定受信任的 HTTP 地址

在「Treat given (insecure) origins as secure origins」選項中，輸入需要信任的 HTTP 地址並啟動，設定成功後重啟瀏覽器。

（格式為 http://IP:埠，例如  http://192.168.222.222:7101  ）

3）重新啟動瀏覽器後，重新存取 FineBI 地址，點選地址左側圖示並進入「網站設定」。如下圖所示：

4）將麥克風權限更改為「允許」，如下圖所示：

配置成功後，語音功能即可正常呼叫麥克風。