知识平台文档
  1. ASR服务
知识平台文档
  • 统一服务
    • AppAgent
      • Component组件标识符
      • 应用对话
      • 应用列表
      • 应用聚合列表
      • 随机问题
      • 历史对话列表
      • 历史对话详情
      • 删除历史对话
      • 删除历史对话
      • 删除全部历史对话
    • AppBuild
      • 调用模型
      • 流式会话
      • 堵塞会话
      • 上传会话文件
      • 密码加密
      • idaas免登录会话
      • idaas账号登录
    • AppConsole
      • 上传⽂档
      • 确认构建
      • 获取实例详情
      • 调试实例
      • 测试集命中
    • 企搜热点服务
      • 热搜榜单
      • 搜索建议
      • 搜索功能
      • 文档推荐
      • 文件推荐
      • 搜索推荐
      • 获取频道
      • 获取栏目
      • 👍赞赞赞
      • 👎踩踩踩
      • 结果反馈
    • 企搜平台服务
      • 上传文件
      • 用户标签列表
      • 知识图谱搜索
      • 知识图谱属性列表
      • 数据源树结构列表
      • 数据源指定树节点资源列表
      • 文件下载
      • 文件预览
    • 系统参数
      • 面板参数
    • 语言服务
      • ASR服务文档
      • ASR 服务
      • 原生LocalAI-TTS
      • TTS 流式切片
    • DeepSeek
      • 同步调用 DeepSeek
      • 流式调用 DeepSeek
    • 遥感平台
      • 遥感卫星信息查询
      • 遥感卫星影像查询
    • AK服务
      • 生成AK
      • 验证AK
      • 获取AK列表
      • 获取指定用户的AK列表
      • 删除指定AK
  • 数据中心
    • 分类逻辑
    • 地标位置
      • 根据名称获取地标位置
    • 工程关联
      • 河流关联关系
        • 河流关联灌区 NULL
        • 河流关联水电站 NULL
        • 河流关联农村供水工程 NULL
        • 河流关联堤防
        • 河流关联水库 空
        • 河流关联水闸
        • 河流关联泵站
        • 河流关联沟渠 无河流ID字段
        • 河流关联取水
        • 河流关联退水 空
        • 河流关联分洪口门
        • 河流关联涵洞
        • 河流关联险工险段
        • 河流关联水文监测站
        • 河流关联倒虹吸
        • 河流关联跨河工程
        • 河流关联橡胶坝
        • 河流关联岸线功能分区
        • 河流关联蓄滞洪区
    • 工程详细
      • 堤防基础信息列表
      • 灌区列表
      • 堤防详情
      • 水闸基础信息列表
      • 水文测站列表
      • 水闸详情
      • 泵站基础信息列表
      • 泵站详情
      • 湖泊详情
      • 水库基础信息列表
      • 河流基础信息列表 没有unit_name
      • 水库详情
      • 入河排污口列表 ba_rvso_att
      • 行政区划
      • 农村供水工程列表 ba_cws_att
      • 灌区详情
      • 退排水户基础信息列表 ba_drho_att 没有unit_name
      • 水文检测
      • 污水处理设施列表
      • 工情检测
      • 井详情
      • 扬水站详情
      • 入河排污
      • 河流详情
      • 跨河建筑物
    • 工程统计
      • 获取工程数量
      • 清除缓存(可选)
    • 水情监测
      • 时段雨量
      • 时段水位
    • 数据监控
      • 预测管理
        • 观测预测任务
        • 触发预测预热
        • 触发预测任务
        • 取消预测任务
      • 获取时间切片数据
      • 获取服务列表
      • 获取预测数据
    • 基础信息
      • 基础信息查询接口完成情况
      • 字段对照表
      • 基础列表筛选条件
      • 根据表名和id查询详情
      • 树形返回结果
      • 河段详情
      • 手动同步数据
      • 手动同步指定表数据
      • 模糊查询指定表中的数据
      • 模糊查询指定表中的数据
      • 模糊查询指定表中的数据
      • 通用详情查询
      • 通用列表查询
      • 获取所有可提供查询的列表
    • 库表元数据
      • 字段描述-水务对象
    • 河流相关
      • 获取河流及其支流
    • 水利信息接口
    • AB数据同步
      • 获取数据库元数据
      • 全量同步任务
      • 增量同步任务
    • 数据代理
      • 远程元数据
      • 本地元数据
      • 初始化
      • 手动同步
      • 条件查询
  • 知识平台
    • 写作助手
      • 字典
        • 列表
        • 详情
        • 新增
        • 修改
        • 删除
        • 条件
      • 列表
      • 详情
      • 新增
      • 修改
      • 删除
      • 条件
    • 技能注册
      • 平台列表
      • 平台新增
      • 平台修改
      • 平台删除
      • 方法列表
      • 方法列表-定制
      • 方法新增
      • 方法修改
      • 方法删除
      • 参数列表
      • 参数新增
      • 参数修改
      • 参数删除
    • 协同上传文件
      • 上传文件
      • 根据名称下载 现在报错
      • 文件详情
      • 下载
      • 删除文件
    • 知识仓库
      • 工程概况
        • getDetail
        • 根据工程id查询工程特性
      • 工程安全知识库 工程安全评价与鉴定
        • 获取安全评价类型列表
        • 根据名称和类型获取安全评价列表
        • 根据id获取详情
        • 工程隐患记录 分页查询
        • 根据类型 获取隐患类型列表数量
        • 更新隐患记录
        • 上传文件
        • 返回文件模板
      • 方案规则相关接口
        • 知识仓库-调度预案库-获取方案列表类型和数量
        • 知识仓库-调度预案库-获取方案摘要
        • 知识仓库-调度预案库-获取方案详情
      • 业务规则库
        • 根据类型获取列表 getRuleList
        • getBusRuleRel
        • getPustRuleTree
        • getDikeRuleTree
        • getWageRuleTree
        • getResRuleTree
        • 根据名称 一级标签 二级标签查询列表
      • 工程安全知识库
        • 获取工程类别列表
        • 根据类型获取维养记录
        • 获取风险类型列表
      • 历史场景库
        • 获取所有场景类型
        • 根据类型获取场景列表
        • 根据案例id获取事件列表
        • 根据事件id获取案例要素列表
      • 水利百科知识库
        • 根据标题(lv1)获取列表
      • 百科库
        • list
      • 水利学科知识库
        • 获取左侧菜单列表
        • 分页查询
        • 手动保存未下载图片 须在本地运行
      • 危险源风险评估
        • 获取所有危险源类型
        • 根据危险源类型获取风险等级统计
        • 分页
        • 根据id更新
        • 获取模板
        • 上传添加
      • 事故案例 应急预案生成 前端控制器
        • 分页查询
        • update
        • 获取模板
        • 上传添加
    • 系统管理
      • 用户画像
        • 分页查询用户画像
        • 获取最近10条用户聊天记录
        • 获取推荐问题
    • 开发日志
      • 获取日志
      • 新增日志
      • 更新日志
      • 删除日志
    • 对话相关
      • 机器人信息
      • 机器人信息列表
      • 常用工具栏信息
      • 历史记录列表
      • 历史记录详情
      • 删除历史记录
      • 创建对话历史
      • 更新对话历史
      • 添加对话记录到chat_content
      • 搜索历史存储接口
      • 插入历史查询接口
      • 上报模型状态
      • 获取历史记录日志
    • 调用模型平台
      • 20号 工程变形层评价
      • 评价 17号-评价方案
      • 预测
      • ncModel
    • 知识图谱
      • 根据名称查询流域信息
    • 热词关键词
      • 获取所有键
      • 获取对应值
    • 意见反馈
      • 获取当前用户反馈
      • 获取所有反馈
      • 添加反馈
      • 删除反馈
      • 批量删除反馈
    • 企业用户接口
      • 获取企搜 token
      • 推送单用户
      • 修改单用户
      • 删除单用户
  • 对外服务
    • 水文平台
      • DeepSeek对话
    • ASR服务
      • ASR服务文档
  • 知识图谱
    • 获取认证信息 用不了
    • 查询对象图谱专题列表接口
    • 获取主题详情页面调用接口
    • 图谱获取接口
    • 左侧获取接口
    • 图谱主题列表
  • 安全中心
    • issue
      • getIssue
      • getIssueById
      • getAllIssue
      • updateIssueById
      • getIssueLevelCount
      • issueFileProcess
      • saveIssue
      • getIssueEntityAlignment
      • getIssueEntityType
      • getIssueEntity
      • updateIssueEntityDTO
    • AccidentController
      • getAccidentCases
      • getAccidentById
      • updateAccidentById
      • accidentFileProcess
      • saveAccident
    • HazardController
      • getEngineering
      • getHazards
      • getHazardById
      • getHazardLevelCount
      • hazardFileProcess
      • saveHazard
      • updateHazardById
    • OntologyController
      • getOntology
      • addOntology
      • getAllOntology
      • deleteOntologyById
    • FileController
      • getIssue
      • getIssueLocal
      • getFileByName
    • IssueMapController
      • getIssueMapById
      • getIssueMap
  1. ASR服务

ASR服务文档

接口地址#

ws://10.152.116.74:9999/transpond/speech/asr

示例代码#

下载保存示例html后,填写AK密钥即可运行测试
ASR前端示例代码

实时语音识别请求参数分类表#

1. JSON 参数(文本协议)#

参数名类型必填示例值出现阶段说明
akstring是"ak_xxxxxx"首包平台鉴权密钥
idstring是"xxxx-xxxx-xxxx-xxxx"首包、尾包会话唯一ID(需与首包一致)
finishboolean是false(首包)/true(尾包)首包、尾包标记是否为结束请求
modestring是"mixed"首包、尾包识别模式:
online(实时)/offline(离线)/mixed(混合)
answerstring否"你好"服务器响应服务器返回的识别结果

2. 音频参数(二进制协议)#

参数名类型必填示例值出现阶段说明
数据格式ArrayBuffer是Int16Array.buffer音频传输阶段16位有符号PCM音频
采样率number是16000全程固定16kHz采样率(代码硬编码)
声道数number是1全程单声道
分片时长number是0.1(秒)音频传输阶段每100ms发送一帧音频

协议交互流程图#

image.png

关键说明#

1.
JSON 和音频严格分离
只有首包和尾包使用 JSON 协议,中间所有包均为纯二进制音频流
音频数据 不允许 包含任何 JSON 元数据(如时间戳、序号等)
2.
参数一致性要求
首包和尾包的 id、mode 必须完全一致
服务器通过 id 关联同一会话的音频流

整体时序图#

image.png

实时语音识别全流程时序说明#


1. 连接阶段#

触发动作:用户点击 "连接服务" 按钮
代码动作:btnConnect.click → new ASRClient(WS_URL).connect()
网络请求:纯 WebSocket 连接(无参数)
服务器响应:连接成功(onopen 回调)
UI 变化:
状态更新为 "已连接"
禁用 "连接服务",启用 "开始识别" 和 "断开连接"

2. 首包鉴权#

触发动作:用户点击 "开始识别" 且麦克风授权成功
代码动作:btnStart.click → 发送初始化参数
发送参数(JSON 格式):
{
    "ak": "ak_xxxxxxx",  // 鉴权密钥
    "id": "xxxx-xxxx-xxxx-xxxx",  // 会话唯一ID
    "finish": false,              // 非结束标记
    "mode": "mixed"               // 混合识别模式
}
作用:
服务器验证 AK 有效性
初始化会话并准备接收音频流

3. 音频传输阶段#

触发动作:麦克风持续采集音频(每 100ms 触发)
代码动作:scriptProcessor.onaudioprocess → 转换并发送音频
数据格式:
无 JSON 包装,直接发送二进制 PCM 数据(Int16Array.buffer)
采样率:16000Hz,单声道
服务器响应(持续返回):
{
    "answer": "实时识别文本",  // 部分结果
    "finish": false,        // 中间结果标记
    "mode": "online"        // 实时/离线模式
}

4. 尾包结束#

触发动作:用户点击 "停止识别"
代码动作:btnStop.click → 发送结束标记
发送参数(JSON 格式):
{
    "ak": "ak_xxxxxxx",  // 与首包一致
    "id": "xxxx-xxxx-xxxx-xxxx",  // 与首包一致
    "finish": true,               // 结束标记
    "mode": "mixed"               // 混合模式
}
服务器响应(最终结果):
{
    "answer": "完整识别结果",
    "finish": true  // 结束标记
}

5. 断开连接#

触发动作:用户点击 "断开连接"
代码动作:btnDisconnect.click → ws.close()
网络请求:WebSocket 关闭帧(无参数)
UI 变化:状态重置为 "未连接"

关键点#

1.
首包必含鉴权参数:ak 和 id 是会话合法性的唯一依据。
2.
中间包纯音频数据:无任何元数据,仅二进制 PCM 帧。
3.
尾包必须显式结束:finish:true 触发服务器最终结果推送。
4.
首尾包参数对称:ak、id、mode 需完全一致。
上一页
DeepSeek对话
下一页
获取认证信息 用不了
Built with