抓包录制请求结果推送接口
ODFS在控制音视频录制服务器录制时,只是让音视频录制服务器开启转发ASR的识别结果。因此,需要提供给音视频录制服务器接口,来接收不停上报的识别结果。
接口方法
设置成“POST”。
URL
https://IP:PORT/oifde/rest/api/flow/asrrecognizeresult
消息头
Content-Type:application/json; charset=UTF-8
请求说明
| 参数名称 | 数据类型 | 参数位置 | 必选/可选 | 描述 |
|---|---|---|---|---|
| serviceToken | String | body | True | 鉴权token,OIAP调用宇高请求识别接口(transfertoasr)携带的serviceToken字段 |
| subCCID | String | body | False | 呼叫中心编号 |
| taskID | String | body | True | capturesession时使用的ID 对话开启抓包录制请求(inaction=7)中使用的呼叫唯一标志,与userid 、call_id取值相同,给流程使用。 说明: capturesession的含义请参见对应音视频录制服务器配套提供的接口参考。 |
| respType | String | body | True | NormalResult:正常结束 StartSpeech:用户开始说话 默认为StartSpeech |
| sentence | Json Object | body | True | 转写结果信息,请参考表2 |
| analysis | Json Object | body | False | 对象质检分析信息,请参考表3 |
| speakerID | String | body | False | 通话者标识,人工通话时使用 0 客户 1 座席 2 其它 缺省为0 |
| 参数 | 数据类型 | 参数位置 | 必选/可选 | 描述 |
|---|---|---|---|---|
| st | int | body | True | 一句的起始时间戳,单位ms |
| et | int | body | True | 一句的结束时间戳,单位ms |
| isFinal | boolean | body | True | true表示是最终结果,false表示是中间临时结果 |
| text | String | body | True | 识别结果文本,使用 text = URLEncoder.encode(text,"UTF-8"); |
| confidence | float | body | True | 识别结果的置信度0~1,中间结果统一为0 |
| 参数 | 数据类型 | 参数位置 | 必选/可选 | 描述 |
|---|---|---|---|---|
| emotions | emotion[] | body | False | 情绪信息数组,如果 checkEmotion 为 false 或者没有检测到情绪信息时,没有此字段 说明: checkEmotion的含义请参见对应音视频录制服务器配套提供的接口参考。 |
| avgVol | int | body | False | 平均音量,如果 outputVolume 为 false, 则无此字段 说明: outputVolume的含义请参见对应音视频录制服务器配套提供的接口参考。 |
| maxVol | int | body | False | 最大音量,如果 outputVolume 为 false, 则无此字段 |
| speed | int | body | False | 语速,如果 outputSpeed 为 false, 则无此字段 说明: outputSpeed的含义请参见对应音视频录制服务器配套提供的接口参考。 |
| 参数 | 数据类型 | 参数位置 | 必选/可选 | 描述 |
|---|---|---|---|---|
| st | int | body | True | 音频开始时间,单位ms |
| et | int | body | True | 音频结束时间,单位ms |
| c | float | body | True | 置信度,范围[0.0, 1.0] |
| e | String | body | False | 情绪, HAPPY, ANGRY, SAD, DISGUSTED 之一(不同ASR厂家可能不同) |
响应说明
| 参数名称 | 数据类型 | 参数位置 | 必选/可选 | 描述 |
|---|---|---|---|---|
| retCode | String | body | True | 错误码 0:成功 非0表示失败 |
| retMsg | String | body | True | 描述信息 |
报文样例
- 请求消息样例
{ "serviceToken":"160*******************bbb489426", "subCCID":"10001", "taskID":"node_action_97511fbc15d9b23074405ee736187a82c529", "respType":"StartSpeech", "sentence":{ "st":1, "et":2, "isFinal":true, "text":"sdffasdfaedfasdfasdfsad", "confidence":0 } } - 响应消息样例
{ "retCode" : "0", "retMsg":"asr recognize success" }