对一分钟内的短语音进行识别,适用于对话聊天、控制口令、语音输入法、语音搜索等较短的语音识别场景。
功能简介
NUI SDK提供更小的工具包和更完善的状态管理。为满足不同用户需求,NUI SDK既能提供全链路的语音能力,同时可做原子能力SDK进行使用,并保持接口的统一。
使用须知
输入格式:PCM编码、16bit采样位数、单声道(mono)。
音频采样率:8000Hz/16000Hz。
时长限制:语音数据时长不能超过60s。
设置返回结果:是否返回中间识别结果、在后处理中添加标点、将中文数字转为阿拉伯数字输出。
设置多语言识别:在管控台编辑项目中进行模型选择,详情请参见模型选择。
服务地址
访问类型 | 说明 | URL |
---|---|---|
外网访问 | 所有服务器均可使用外网访问URL(SDK中默认设置了外网访问URL)。 | wss://nls-gateway.cn-shanghai.aliyuncs.com/ws/v1 |
上海ECS内网访问 | 使用阿里云上海ECS(即ECS地域为华东2(上海)),可使用内网访问URL。 ECS的经典网络不能访问AnyTunnel,即不能在内网访问语音服务;如果希望使用AnyTunnel,需要创建专有网络在其内部访问。 说明 使用内网访问方式,将不产生ECS实例的公网流量费用。-关于ECS的网络类型请参见网络类型。 | ws://nls-gateway.cn-shanghai-internal.aliyuncs.com:80/ws/v1 |
交互流程
下图展示iOS SDK、Android SDK的交互流程。
所有服务端的响应都会在返回信息的header包含表示本次识别任务的task_id参数,请记录该值,如果出现错误,请将task_id和错误信息提交到工单。
1. 鉴权和初始化
客户端在与服务端建立WebSocket连接的时候,使用Token进行鉴权。关于Token获取请参见获取Token。
初始化参数如下。
参数 | 类型 | 是否必选 | 说明 |
---|---|---|---|
workspace | String | 是 | 工作目录路径,SDK从该路径读取配置文件。 |
app_key | String | 是 | 管控台创建项目的appkey。 |
token | String | 是 | 请确保该token可以使用并在有效期内。 说明 token可以在初始化时设置,也可通过参数设置进行更新。 |
device_id | String | 是 | 设备标识,唯一表示一台设备(如Mac地址/SN/UniquePsuedoID)。 |
debug_path | String | 否 | debug目录,当初始化SDK时的 |
save_wav | String | 否 | 当初始化SDK时的 |
2. 开始识别
客户端发起一句话识别请求前需要进行参数设置,各参数由SDK中setParams接口以JSON格式设置,该参数只需设置一次。各参数含义如下。
参数 | 类型 | 是否必选 | 说明 |
---|---|---|---|
appkey | String | 否 | 管控台创建的项目appkey,一般在初始化时设置。 |
token | String | 否 | 如果需要更新,则进行设置。 |
service_type | Int | 是 | 需要请求的语音服务类型,一句话识别为“0”。 |
direct_ip | String | 否 | 支持客户端自行DNS解析后传入IP进行访问。 |
nls_config | JsonObject | 否 | 访问语音服务相关的参数配置,详情请参见下表。 |
参数nls_config配置如下。
参数 | 类型 | 是否必选 | 说明 |
---|---|---|---|
sr_format | String | 否 | 音频编码格式,支持OPUS编码和PCM原始音频。默认值:OPUS。 说明 如果使用8000Hz采样率,则只支持PCM格式。 |
sample_rate | Integer | 否 | 音频采样率,默认值:16000Hz。根据音频采样率在管控台对应项目中配置支持该采样率及场景的模型。 |
enable_intermediate_result | Boolean | 否 | 是否返回中间识别结果,默认值:False。 |
enable_punctuation_prediction | Boolean | 否 | 是否在后处理中添加标点,默认值:False。 |
enable_inverse_text_normalization | Boolean | 否 | 是否在后处理中执行ITN。设置为true时,中文数字将转为阿拉伯数字输出,默认值:False。 说明 不会对词信息进行ITN转换。 |
customization_id | String | 自学习模型ID。 | |
vocabulary_id | String | 否 | 定制泛热词ID。 |
enable_voice_detection | Boolean | 否 | 是否启动语音检测。默认值:False。 |
max_start_silence | Integer | 否 | 当 |
max_end_silence | Integer | 否 | 当 |
3. 发送数据
客户端循环发送语音数据,持续接收识别结果:
若enable_intermediate_result设置为true,SDK会持续多次通过onNuiEventCallback回调上报EVENT_ASR_PARTIAL_RESULT事件,即中间识别结果:
{ "header": { "namespace": "SpeechRecognizer", "name": "RecognitionResultChanged", "status": 20000000, "message_id": "e06d2b5d50ca40d5a50d4215c7c8****", "task_id": "4c3502c7a5ce4ac3bdc488749ce4****", "status_text": "Gateway:SUCCESS:Success." }, "payload": { "result": "北京的天气" } }
header对象参数说明:
参数
类型
说明
namespace
String
消息所属的命名空间。
name
String
消息名称。RecognitionResultChanged表示获取到中间识别结果。
status
Integer
状态码。表示请求是否成功,见服务状态码。
message_id
String
本次消息的ID,由SDK自动生成。
task_id
String
任务全局唯一ID,请记录该值,便于排查问题。
status_text
String
状态消息。
payload对象参数说明:
参数
类型
说明
result
String
中间识别结果。
说明最后一次获取的中间识别结果与最终的识别的结果不一定相同,请以EVENT_ASR_RESULT事件的结果为最终识别结果。
若enable_intermediate_result设置为false,此步服务端不返回任何消息。
4. 结束识别
客户端发送停止一句话识别请求,通知服务端语音数据发送结束,停止语音识别,服务端返回最终识别结果:
{
"header": {
"namespace": "SpeechRecognizer",
"name": "RecognitionCompleted",
"status": 20000000,
"message_id": "10490c992aef44eaa4246614838f****",
"task_id": "4c3502c7a5ce4ac3bdc488749ce4****",
"status_text": "Gateway:SUCCESS:Success."
},
"payload": {
"result": "北京的天气。"
}
}
header对象参数说明:
参数 | 类型 | 说明 |
---|---|---|
namespace | String | 消息所属的命名空间。 |
name | String | 消息名称。RecognitionCompleted表示识别完成。 |
status | Integer | 状态码。表示请求是否成功,见服务状态码。 |
message_id | String | 本次消息的ID,由SDK自动生成。 |
task_id | String | 任务全局唯一ID,请记录该值,便于排查问题。 |
status_text | String | 状态消息。 |
payload对象参数说明:
参数 | 类型 | 说明 |
---|---|---|
result | String | 一句话识别最终结果。 |
错误码
一句话识别的错误码信息,请参见错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交