语音集成设置指南

1.1 版本

1.2 应用场景

FineChatBI 的语音集成功能支持在移动端和 PC 端进行语音录入，打破了传统的文字输入限制，为用户提供更加便捷、高效的交互方式。

1.2 功能简介

用户开启语音输入功能后，FineChatBI 录入用户的语音文件，并发送至配置的接口地址，由接口地址完成语音转写，并将转写后的文本自动填入输入框。

2.1 接口概览

• 请求方式：POST

• Content-Type：multipart/form-data（文件通过此格式发送至接口）

• 请求地址：企业语音转写服务地址

在「智能问答配置>其他配置」中打开「语音服务」，输入企业语音转写服务地址。

2.2 输入参数

2.3 输出参数

2.4 响应示例

为避免中文乱码，接口响应头（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）将麦克风权限更改为「允许」，如下图所示：

配置成功后，语音功能即可正常唤起麦克风。