{{ docItem.name }}
{{ listItem.name }}
{{ listItem.name }}
{{ item.name }}
{{ item }}
>
儿童单词评测快速集成版
- 该文档方便开发者在技术验证阶段 快速集成单词跟读题型的语音评测技术文档
- 适用于12岁以下儿童单词跟读评测功能
题型描述
- 对英文单词、词组进行打分。
- 反馈维度包含单词总分，重音判断，音素得分。
评测请求参数
| 字段 | 类型 | 可选 | 说明 |
|---|---|---|---|
| coreType | string | 必选 | en.word_kid.score表示英文幼儿单词评测 |
| refText | string | 必选 | 评分参考文本 |
参数示例
请求测评参数示例如下：
{
"coreType":"en.word_kid.score",
"refText":"egg"
}返回结果示例
- 返回结果采用JSON结构,参考样例
返回结果说明
| 键 | 类型 | 说明 | 使用建议 |
|---|---|---|---|
| recordId | string | 音频文件的唯一标识 | 可供参考 |
| audioUrl | string | 用户音频下载地址： 音频默认保留20天左右,如需长久保存,建议产品方下载至自己的服务器。 域名会因不同访问区域而不同，以实际返回为准。 |
可供参考 |
| tokenId | string | 用户请求的唯一标识 | 可供参考 |
| applicationId | string | 授权账号，先声提供的评测Appkey | 内部参数 |
| refText | string | 传入的评测文本 | 可供参考 |
| params | object | ||
| - app | object | ||
| - - applicationId | string | 授权账号，先声提供的评测Appkey | |
| - - userId | string | 自定义字符串，建议一个用户一个userid,方便定位问题 | |
| - request | object | 请求评分的参数设置节点 | |
| - audio | object | 请求评分的音频参数设置节点 | |
| result | object | 评测结果节点 | |
| - wavetime | int | 音频时长，单位ms | 可供参考 |
| - overall | float | 总分 | 建议字段 |
| - pron | float | 发音分 | 内部参数 |
| - details | array | ||
| - - char | string | 规整后的单词文本 | 可供参考 |
| - - score | int | 单词得分 | 可供参考 |
| - - fake_pron | int | 单词不在先声词典（集外词），才会输出此字段。如果需要对集外词进行评测，可以通过refText传音标的方式进行评测。 | |
| - info | object | ||
| - - snr | float | 信噪比，值越高越清晰，范围(0～40dB) 此参数影响评分时，会设置相应的tipId值 | 可供参考 |
| - - clip | float | 音频声音太高，出现截幅，范围(0\~1)。 此参数影响评分时，会设置相应的tipId值 | 内部参数 |
| - - volume | int | 录音音量，范围（0～180dB） | 可供参考 |
| - - tipId | int | 音频质量 | 建议字段 |
| 详情请参考文本符号说明tipId字段说明 |
- 注：返回结果中其它未在上面展示的字段是内部参数，产品层面不需要关注
评测结果展现建议
| 维度 | 说明 | 详细 |
|---|---|---|
| overall | 单词总分 | 对单词的整体评价 |
| pron | 发音得分 | |
| details.syllable.score | 音节得分 | 对单词中具体某个音节发音的评价。获取之前要进行非空判断 |
| details.stress.score | 单词重读得分 | 对单词中具体某个重读发音的评价。获取之前要进行非空判断 |
| details.phone.score | 音素得分 | 对单词中具体某个音素发音的评价。获取之前要进行非空判断 |
| details.dp_type | 单词的增漏读 | 表示单词是否重读/漏读（参考对应题型的返回说明） |
| details.fake_pron | 伪造发音 | 表示单词是否在词典中，如果不在词典中，会为单词预测发音 |
评测失败时的返回结果
- 如果返回的评测结果中result结构为空，说明评测失败。
- 通过返回结果可以获取 errId 和 error，产品端可以根据相应错误码做续判断和处理。
错误码
- 错误码参考：语音评测错误码
