单词纠错
该文档是开发者在产品功能集成阶段 使用的英文单词纠错题型的语音评测技术文档
题型描述
对英文单词里的每个音素进行打分，并反馈错误发音的音标。
评测请求参数
字段 | 类型 | 可选 | 说明 |
coreType | String | 必选 | en.mpd.score表示英文单词纠错 |
refText | String | 必选 | 评分参考文本 |
rank | int | 可选 | 评分分制，这个值可以任意设置,最终会根据与100的比例重新计算 |
attachAudioUrl | int | 可选 | 评测结果中是否返回音频url |
precision | double | 可选 | 设置打分精度，只支持0.1、0.5或者1，默认值为1（如果设置的值不是0.1或0.5则按1处理） |
参数示例
{
"coreType":"en.mpd.score",
"refText":"hot",
"rank":100,
"precision":1,
"attachAudioUrl":1
}返回结果示例
{
"tokenId": "6126571488bf5b0000090001",
"applicationId": "a148",
"audioUrl": "http:\/\/files.cloud.ssapi.cn:8080\/a148\/11ec05b2d06325249b36a148o261e7ba",
"connect": {
"param": {
"app": {
"timestamp": "1629902612",
"applicationId": "a148",
"sig": "c93d876e1038ae3c6cde0bfee24ca64570187188"
},
"sdk": {
"os": "6.2(9200)1",
"product": "",
"source": 7,
"protocol": 1,
"os_version": "6.2(9200)",
"arch": "586",
"version": 16778752
}
},
"cmd": "connect"
},
"params": {
"app": {
"timestamp": "1629902612",
"userId": "ssound_text",
"sig": "c93d876e1038ae3c6cde0bfee24ca64570187188",
"connect_id": "6126571488bf5b00000b0002",
"clientId": "",
"applicationId": "a148"
},
"audio": {
"sampleBytes": 2,
"audioType": "ogg",
"sampleRate": 16000,
"channel": 1
},
"request": {
"request_id": "6126571488bf5b00000a0001",
"tokenId": "6126571488bf5b0000090001",
"precision": 1,
"attachAudioUrl": 1,
"refText": "hot",
"coreType": "en.mpd.score",
"rank": 100
}
},
"recordId": "11ec05b2d06325249b36a148o261e7ba",
"refText": "hot",
"dtLastResponse": "2021-08-25 22:43:32:490",
"cloud_platform": {
"origin_audio_length": 7807
},
"result": {
"accent": "am",
"wavetime": 1990,
"precision": 1,
"systime": 1814,
"rec": "hh aa t",
"version": "0.0.80.2021.7.24.00:01:28",
"rank": 100,
"info": {
"tipId": 10004,
"clip": 0,
"snr": 17.149954,
"volume": 77
},
"delaytime": 19,
"phone_str": "hh aa t",
"res": "eng.mpd.online.0.2",
"details": [
{
"char": "hh",
"type": 0
},
{
"char": "aa",
"type": 0
},
{
"char": "t",
"type": 0
}
],
"pretime": 34,
"overall": 100
},
"eof": 1
}返回结果说明
键 | 类型 | 说明 | 使用建议 |
recordId | string | 音频文件的唯一标识 | 可供参考 |
tokenId | string | 用户请求的唯一标识 | 可供参考 |
audioUrl | string | 用户音频地址，在云端默认只保存一个月，建议保存到产品端服务器 | 可供参考 |
applicationId | string | 授权账号，即用户的Appkey | 内部参数 |
dtLastResponse | string | 云端响应的时间点 | 内部参数 |
eof | int | 0表示返回未结束，后续还有其它的返回结果 1：表示本次评测所有的返回结束 | 内部参数 |
refText | string | 传入的评测文本 | 可供参考 |
params | object | 回显客户端传入的评测请求参数 | |
- app | object | ||
- - applicationId | string | 授权账号，提供的评测Appkey | |
- - userId | string | 产品端的用户标识，可以是自定义的自符串，建议一个用户一个userid,方便排查问题 | |
- - timestamp | string | start时间 | |
- - sig | string | 校验码 | |
- request | object | 评分请求参数节点 | |
- audio | object | 评分请求的音频参数节点 | |
result | object | 评测结果 | |
- version | string | 引擎的版本，包含发布时间 | 内部参数 |
- rank | int | 评分分制 | 内部参数 |
- precision | float | 评分精度 | 内部参数 |
- res | string | 评测本题型时，使用的资源名称 | 内部参数 |
- pretime | int | 云端调用Start接口本身耗时，单位ms | 内部参数 |
- systime | int | 评测整个过程的总耗时，单位ms | 内部参数 |
- delaytime | int | 云端从feed音频结束到获取结果的耗时，单位ms | 内部参数 |
- wavetime | int | 音频时长，单位ms | 可供参考 |
- overall | float | 总分 | 建议字段 |
- rec | string | 识别结果 | 内部参数 |
-phone_str | string | 单词对应音标 | 内部参数 |
- details | array | ||
- - char | string | 识别的音标 | 可供参考 |
- - type | int | 0表示正常（识别的音标与实际应读的匹配）、1表示增读、2、表示漏读、3、表示替换 | 可供参考 |
评测结果展现建议
维度 | 说明 | 详细 |
overall | 总分 | 评测总分 |
评测失败时的返回结果
如果返回的评测结果中result结构为空，说明评测失败。
通过返回结果可以获取 errId 和 error，产品端可以根据相应错误码做续判断和处理。
错误码
错误码参考：评测错误码