文档首页/ 云客服/ API参考/ 机器人管理/ 抓包录制请求结果推送接口
更新时间:2023-09-27 GMT+08:00

抓包录制请求结果推送接口

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

表2 sentence参数说明

参数

数据类型

参数位置

必选/可选

描述

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

表3 analysis参数说明

参数

数据类型

参数位置

必选/可选

描述

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的含义请参见对应音视频录制服务器配套提供的接口参考。

表4 emotion参数说明

参数

数据类型

参数位置

必选/可选

描述

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" 
    }