语义理解

优质
小牛编辑
184浏览
2023-12-01

1.1.1. 开放平台 Websocket 协议 nlp 接口定义文档

1.1.2. 概述

本文档目的是描述云端语音接口的 WebSocket 版本的开放协议,主要包含语音识别、语义理解、语音合成三大部分功能,主要面向想要了解语音交互细节,并具有一定开发能力的开发者或用户。

1.1.3. 协议详解

协议可分为以下部分:

索引

1.1.4. 服务地址

环境地址用途
线上wss://apigwws.open.rokid.com/api对外提供的正式稳定环境

1.1.5. 协议地址

1.1.6. 协议概述

此文档用于定义开放平台上云端应用接口开发协议,协议遵循 websocket 协议。协议采用先认证,再使用的方式,步骤如下:

  • 建立 wss 连接,注意是 websocket + ssl
  • 认证设备
  • 设置认证中 service 为 speech,则此连接后续可进行一次或多次语义理解,直至连接断开

语义理解

  • 设置认证中 service 为 speech,则此连接后续可进行一次或多次语音理解,直至连接断开
流程
  1. 需要先进行 service 为 speech 的 设备认证
  2. 一次完整的语音识别的数据包以 id 来标识,称为一个 session
  3. 设备端发送以下的数据
    • TEXT 发送需要理解的文本数据
  4. 云端返回 RespType 的数据
    • FINISH 返回 nlp 结果
  5. 每个 session 以 FINISH 结束
SpeechRequest
参数类型描述默认值
idint32唯一标识,用于跟踪一个完整的请求,处理及响应事件。0
typeReqTypeTEXT
voicebytes需要识别的语音流
asrbytes需要理解的 asr 文本
SpeechResponse
参数类型描述
idint32唯一标识,用于跟踪一个完整的请求,处理及响应事件。
resultSpeechErrorCode错误信息
typeRespType结果类型:FINISH
asrstringasr实时识别的结果
nlpstringnlp识别的结果: {"appId": "技能id", "appName": "技能名称", "asr": "asr识别结果", "cloud": "是否为云端技能: true / fasle", "intent": "意图", "pattern": "设定的用户语句","slots": { "槽名称": { "type": "槽类型", "value": "槽的值" }}}
actionstringcloud app处理的结果,json字符串
extrastring目前有:{"activation": "xxx"}