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

1.1.2. 概述

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

1.1.3. 协议详解

协议可分为以下部分：

• 设备认证
• 语义理解（nlp）

索引

• 服务地址
• 协议地址
• 协议概述
• 协议详解
  • 设备认证
  • 语义理解

1.1.4. 服务地址

1.1.5. 协议地址

• github

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

SpeechResponse