# 抓包录制请求结果推送接口
ODFS在控制音视频录制服务器录制时,只是让音视频录制服务器开启转发ASR的识别结果。因此,需要提供给音视频录制服务器接口,来接收不停上报的识别结果。
#### 接口方法
设置成"POST"。
#### URL
https://IP:PORT/oifde/rest/api/flow/asrrecognizeresult
#### 消息头
Content-Type:application/json;charset=UTF-8
#### 请求说明
表1请求体参数 
| 参数名称         | 数据类型        | 参数位置 | 必选/可选 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|:---|
| 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 |
   
 表2sentence参数说明 
| 参数         | 数据类型    | 参数位置 | 必选/可选 | 描述                                                                                                                                                                 |
|:---|:---|:---|:---|:---|
| 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                                                                                                                                              |
   
 表3analysis参数说明 
| 参数       | 数据类型        | 参数位置 | 必选/可选 | 描述                                                                                                                                                                                                                                                                                                           |
|:---|:---|:---|:---|:---|
| 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的含义请参见对应音视频录制服务器配套提供的接口参考。                 |
   
表4emotion参数说明 
| 参数 | 数据类型   | 参数位置 | 必选/可选 | 描述                                               |
|:---|:---|:---|:---|:---|
| 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" 
  }
  ```