选读
该文档是开发者在产品开发阶段 中文句子选读题型的技术说明文档
题型描述
设定几个答案，用户读哪个，就会返回哪个句子的得分.
测评请求参数：
字段 | 类型 | 可选 | 说明 |
coreType | String | 必选 | cn.pcha.score表示选择句子阅读评分题型 |
rank | int | 可选 | 总分评分分制 |
precision | double | 可选 | 设置打分精度，只支持0.1、0.5或者1，默认值为1（如果设置的值不是0.1或0.5则按1处理） |
cmd_word | Int | 可选 | 设置命令词识别模式： 0：默认值；表示正常的识别（更精准一点） 1：表示识别的速度更快一些（对于分支特别多的情况）。 |
lm | array | 必选 | 每个text表示一个句子； |
typeThres | int | 可选 | 打分松紧度（分数越高影响越小）：1表示严格，2表示宽松，3表示非常严格，4非常宽松，0为默认值（不启用此功能） |
use_cws | int | 可选 | 启用分词功能（可更好支持多音字及数字）; 只有设置0或1，0为默认值（不启用此功能） |
测评参数示例
{
"coreType":"cn.pcha.score",
"rank":2,
"precision":0.5,
"lm":[
{
"text":"这些书留着有用"
},
{
"text":"大剧院已停止上演了"
},
{
"text":"树林里有只百灵鸟在唱歌"
},
{
"text":"公园里有大型游戏机玩"
}
]
}返回结果说明
键 | 类型 | 说明 | 使用建议 |
recordId | string | 音频文件的唯一标识 | 可供参考 |
tokenId | string | 用户请求的唯一标识 | 可供参考 |
applicationId | string | 授权的评测账号，即Appkey | |
dtLastResponse | string | 云端响应的时间点 | 内部参数 |
eof | int | 内部参数 | |
params | object | 回显客户端传入的评测请求参数 | |
- app | object | ||
- - applicationId | string | 授权的评测账号，即Appkey | |
- - userId | string | 用户标识 ,自定义字符串，方便定位排查问题 | |
- - timestamp | string | start时间 | |
- - sig | string | 校验码 | |
- - clientId | string | ||
- request | object | ||
- -lm | string | 设置可选的评测文本 | |
- -coreType | string | 使用内核 | |
- -tokenId | string | 用户请求的唯一标识 | |
- -rank | int | 评分分制 | |
- -precision | float | 打分精度 | |
- audio | object | ||
- - sampleRate | int | 采样率 | |
- - channel | int | 声道 | |
- - sampleBytes | int | 每采样字节数，支持单字节和双字节 | |
- - audioType | string | 音频格式 | |
result | object | 评测结果 | |
- res | string | 评测本题型时，使用的资源名称 | 内部参数 |
- version | string | 引擎的版本，包含发布时间 | 内部参数 |
- rank | int | 评分分制 | 内部参数 |
- tone | float | 句子升降调得分(0-100) | |
- precision | float | 评分精度 | 内部参数 |
- pretime | int | 云端调用Start接口本身耗时，单位ms | 内部参数 |
- systime | int | 评测整个过程的总耗时，单位ms | 内部参数 |
- delaytime | int | 云端从feed音频结束到获取结果的耗时，单位ms | 内部参数 |
- wavetime | int | 音频时长，单位ms | 可供参考 |
- overall | float | 总分 | 建议字段 |
- index | int | 表示读的第几个句子（从1开始） | 建议字段 |
- details | array | 选读句子的评分详情 | 建议字段 |
- - char | string | 单字对应的拼音 | |
- - chn_char | string | 单字 | |
- - confidence | array | 置信度 | 里面的值依次表示这个字对应的声调为：轻声、一声、二声、三声、四声 的概率。 |
- - score | int | 该字的发音得分 | |
- - dp_type | int | 表示增漏读 | 0：表示正常发音，一般不显示 1：表示漏读此单词 2：表示重复读 3：表示这个字不参与评分，起到注释作用 |
- - pron | int | 发音分 | |
- - start | int | 单字在音频中的起始时间，单位为毫秒（ms） | |
- - dur | int | 单字在音频中的结束时间，单位为毫秒（ms） | |
- - end | int | 单字发音时间,单位为毫秒（ms） | |
- - phn | int | 音素发音得分 | |
- - overall | int | 单字总分 | |
- -score | int | 单字得分 | |
- info | object | ||
- - snr | float | 信噪比，值越高越清晰，范围(0～40dB) 此参数影响评分时，会设置相应的tipId值 | 可供参考 |
- - clip | float | 音频声音太高，出现截幅，范围(0\~1)。 此参数影响评分时，会设置相应的tipId值 | 内部参数 |
- - volume | int | 录音音量，范围（0～180dB） | 可供参考 |
- - tipId | int | 音频质量 | 建议字段 |
评测结果建议展现维度
维度 | 说明 | 详细 |
overall | 发音总分 | 对选读句子的发音情况进行总体评价 |
index | 句子的编号 | 显示评测的是第几个句子 |
detailss.score | 每个单词的得分 | 选读句子中每个单词的得分 |
评测失败时的返回结果
如果返回的评测结果中result结构为空，说明评测失败。通过返回结果可以获取 errId 和 error，需要根据相应错误码进行后续判断和处理。
错误码
错误码参考：评测错误码