{{ docItem.name }}
{{ listItem.name }}
{{ listItem.name }}
{{ item.name }}
{{ item }}
>
句子题型快速集成版
- 该文档方便开发者在技术验证阶段 快速集成句子跟读题型的语音评测技术文档
题型描述
- 对英文句子进行打分。
- 反馈总分、流利度得分、准确度得分、完整度得分、每个单词的发音得分。
评测请求参数
| 字段 | 类型 | 可选 | 说明 |
|---|---|---|---|
| coreType | string | 必选 | en.sent.score表示英文句子评测 |
| refText | string | 必选 | 评分参考文本,支持整个句子, 可以带标点符号，例"I want to know the past and present of Hong Kong." 文本符号说明 |
参数示例
请求测评参数示例如下：
{
"coreType": "en.sent.score",
"refText": "let us play basketball, are you ok?"
}返回结果示例
- 返回结果采用JSON结构,参考样例
返回结果说明
| 键 | 类型 | 说明 | 使用建议 |
|---|---|---|---|
| recordId | string | 音频文件的唯一标识 | 可供参考 |
| tokenId | string | 用户请求的唯一标识 | 可供参考 |
| applicationId | string | 授权账号，即先声提供的Appkey | 内部参数 |
| dtLastResponse | string | 云端响应的时间点 | 内部参数 |
| eof | int | 0表示返回未结束，后续还有其它的返回结果 1：表示本次评测所有的返回结束 | |
| refText | string | 传入的评测文本 | 可供参考 |
| params | object | ||
| - app | object | ||
| - - applicationId | string | 授权账号，先声提供的评测Appkey | |
| - - userId | string | 产品端的用户标识，可以是自定义的自符串，建议一个用户一个userid,方便排查问题 | |
| - request | object | 评测请求参数节点 | |
| - audio | object | 评测请求音频参数 | |
| result | object | 评测结果 | |
| - rank | int | 评分分制 | 内部参数 |
| - precision | float | 评分精度 | 内部参数 |
| - wavetime | int | 音频时长，单位ms | 可供参考 |
| - overall | float | 总分 | 建议字段 |
| - pron | float | 发音得分 | 内部参数 |
| - integrity | float | 完整度评分 | 建议字段 |
| - accuracy | float | 发音得分（同pron字段） | 建议字段 |
| - fluency | object | 流利度评分（完整度为0时，流利度得分为0） | 建议字段 |
| -- overall | float | 流利度总体得分（0-100） | 建议字段 |
| -- pause | int | 停顿次数 | 可供参考 |
| -- speed | int | 语速快慢（默认为0，漏读时也为0），0：慢，1：正常，2：快 | 可供参考 |
| - details | array | 单词详细得分 | 建议字段 |
| -- char | string | 单词 | 建议字段 |
| -- score | int | 单词发音得分 | 建议字段 |
| -- fluency | float | 流利度评分(0-100) | 保留备用 |
| -- stressref | int | 重读标识，可参考[stressref] | 可供参考 |
| -- stressscore | int | 重读反馈（0、1），可参考[stressscore] | 可供参考 |
| -- toneref | int | 升调标识，可参考toneref | 可供参考 |
| -- tonescore | int | 升降调反馈(0、1)，可参考tonescore | 可供参考 |
| -- senseref | int | 意群停顿标识,可参考senseref | 可供参考 |
| -- sensescore | int | 意群停顿反馈(0、1)，可参考tonescore | 可供参考 |
| -- liaisonref | int | 连读标识，可参考liaisonref | 可供参考 |
| -- liaisonscore | int | 连读反馈(0、1)，可参考liaisonscore | 可供参考 |
| -- accent | string | 请求参数中配置accent时不返回此字段，否则返回此字段"accent":"ea" | |
| - info | object | ||
| -- tipId | int | 音频质量 详情请参考 tipId字段说明 | 建议字段 |
- 注：返回结果中其它未在上面展示的字段是内部参数，产品层面不需要关注
评测结果展现建议
| 维度 | 说明 | 详细 |
|---|---|---|
| overall | 总分 | 对整个句子的发音情况进行总体评价 |
| pron | 发音得分 | |
| integrity | 完整度 | 评测录音内容与待测句子的完整程度，只评测是否读完整 |
| accuracy | 准确度 | 对已读内容的发音评价，与完整度无关 |
| fluency.overall | 流利度 | 评测录音是否流利，与朗读的内容无关 |
| details[i].score | 单词得分 | 对句子中每个单词的发音评价。获取之前要进行非空判断 |
| detials[i].fake_pron | 伪造发音 | 表示单词是否在词典中，如果不在词典中，会为单词预测发音 |
| detials[i].stressref | 重读标识 | 1表示设置单词重读，0表示单词不需要重读；默认全部为0 |
| detials[i].stressscore | 重读得分 | 返回1或0， 1表示实际重读与设置的一致，0表示实际与设置不一致。获取之前要进行非空判断 |
| detials[i].toneref | 升降调标识 | 1表示设置单词升调，0表示设置单词降调；如果没有设置，结尾默认为0 |
| detials[i].tonescore | 升降调得分 | 返回1或0，1表示实际与设置一致，0表示实际与设置不一致。获取之前要进行非空判断 |
| detials[i]. senseref | 意群停顿标识 | 1表示设置单词意群停顿，0表示单词不需要意群停顿；结尾默认为1 |
| detials[i]. sensescore | 意群停顿得分 | 返回1或0，1表示实际与设置一致，0表示实际与设置不一致。获取之前要进行非空判断 |
| detials[i]. liaisonref | 连读标识 | 1表示设置单词连读，0表示单词不需要连读；默认全部为0 |
| detials[i]. liaisonscore | 连读得分 | 返回1或0，1表示实际与设置一致，0表示实际与设置不一致。获取之前要进行非空判断 |
评测失败时的返回结果
- 如果返回的评测结果中result结构为空，说明评测失败。
- 通过返回结果可以获取 errId 和 error，产品端可以根据相应错误码做续判断和处理。
错误码
- 错误码参考：语音评测错误码
