抓包录制请求结果推送接口
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" }