使用参数实现英文扩展选择题语音评测-智能科教内容生成平台-阿里云

该文档是开发者在产品功能集成阶段使用的英文扩展选读题型的语音评测技术文档

本题型适用场景：

设定多个答案选项，只有读正确的字段并且发音正确、完整才会得分。
用户可以在按事先设定的固定答案基础上做扩展发音；引擎检查到读得更像哪个答案，就会有对应的得分。
需要设置错误答案，用户回答到错误答案算错。
用户回答多个选项，以后面的回答为准。比如：用户回答是key unkey的话，以unkey为作答。

参数说明：

字段	类型	可选	说明
coreType	String	必选	en.pche.score表示英文扩展选择题
rank	int	可选	总分评分分制
precision	double	可选	设置打分精度，只支持0.1、0.5或者1，默认值为1（如果设置的值不是0.1、0.5则按1处理）
pronScale	int	可选	1:表示总分包含发音分。50%+50%×发音分 0:默认值；表示总分只可能这满分或者0分两种情况。此字段只能设置0和1
lm	array	必选	数组字典，设置扩展选择题的选项（注：lm字段是LM的小写形式）每个text子字段为一种表述正确或错误答案的方式. 括号内为正确或者错误的答案的关键字，符号”\|”用于分隔关键字. 括号外面的句子会与括号内的每个关键词组成一句话，做为一种表述 . 例如：She is from (Tokyo\|Beijing\|London). 在内部会被拆分成：以下三个句子： She is from Tokyo. She is from Beijing. She is from London.
key	array	必选	数组字典，设置正确的答案，可以多个
unkey	array	必选	数组字典，设置错误的答案
phones	object	可选	指定单词的发音。如果单词有多发音，要用”\|”符号分隔开；每个音素之间及音素与音节分隔符"-"之间，必须使用空格隔开。例："phones":{"directory":"d ih - 'r eh k - tr ih\|d ax - 'r eh k - t ax - r ih"};
attachAudioUrl	int	可选	评测结果中是否返回音频url 0: 不返回 1: 返回

参数示例

{
    "coreType": "en.pche.score",
    "rank": 2,
    "precision": 0.5,
    "attachAudioUrl":1,
    "lm": [
        {"text": "(Tokyo|Beijing|London)." },
        {"text": "Linda is from (Tokyo|Beijing|London)." },
        {"text": "Linda comes from (Tokyo|Beijing|London)." },
        {"text": "She is from (Tokyo|Beijing|London)." },
        {"text": "She comes from (Tokyo|Beijing|London)." }
    ],
    "key": [{ "text": "Tokyo" }],
    "unkey": [
        {"text": "Beijing"},
        {"text": "London"}
   ]
}

返回结果示例

返回结果说明

键	类型	说明	使用建议
recordId	string	音频文件的唯一标识	可供参考
tokenId	string	用户请求的唯一标识	可供参考
applicationId	string	授权评测账号，即Appkey	内部参数
audioUrl	string	用户音频地址，在云端默认只保存一个月，建议保存到产品端服务器	可供参考
dtLastResponse	string	云端响应的时间点	内部参数
eof	int	0表示返回未结束，后续还有其它的返回结果 1：表示本次评测所有的返回结束	内部参数
params	object	回显客户端传入的评测请求参数
- app	object
- - applicationId	string	授权评测账号，即Appkey
- - userId	string	用户标识 ,自定义字符串，方便定位排查问
- - timestamp	string	start时间
- - sig	string	校验码
- - clientId	string
- request	object	评分请求参数节点
- audio	object	评分请求的音频参数节点

result	object	评测结果
- res	string	评测本题型时，使用的资源名称	内部参数
- version	string	引擎的版本，包含发布时间	内部参数
- rank	int	评分分制	内部参数
- precision	float	评分精度	内部参数
- pretime	int	云端调用Start接口本身耗时，单位ms	内部参数
- systime	int	评测整个过程的总耗时，单位ms	内部参数
- delaytime	int	云端从feed音频结束到获取结果的耗时，单位ms	内部参数
- wavetime	int	音频时长，单位ms	可供参考
- overall	float	总分	建议字段
- fake_words	object		(只有测评文本中有fake_words时，才有此字段，每个单词一个条目)
- -char	string	词典中不存在的单词(会预测或伪造发音)
- info	object
- - snr	float	信噪比，值越高越清晰，范围(0～40dB) 此参数影响评分时，会设置相应的tipId值	可供参考
- - clip	float	音频声音太高，出现截幅，范围(0\~1)。此参数影响评分时，会设置相应的tipId值	内部参数
- - volume	int	录音音量，范围（0～180dB）	可供参考
- - tipId	int	音频质量，详情请参考 tipId提示信息说明	建议字段

评测结果展现建议

维度	说明	详细
overall	总分	题型的评测得分

评分失败说明

如果返回的评测结果中result结构为空，说明评测失败。通过返回结果可以获取 errId 和 error，需要根据相应错误码进行后续判断和处理。

错误码

错误码参考：评测错误码