中文背诵评测API的请求参数与返回结果-智能科教内容生成平台-阿里云

该文档是开发者在产品功能集成阶段使用的中文背诵评测题型的技术说明文档

题型描述

根据待背诵的内容以及用户发音情况反馈用户的背诵情况。
反馈总分，每个字的得分，流利度得分，完整度得分，用户音频地址等维度。

测评请求参数

字段	类型	可选	说明
coreType	String	必选	cn.recite.score表示中文背诵题型
refText	String	必选	待背诵的文本
symbol	int	可选	返回结果是否包含标点符号：只有设置0或1，默认值为0，不返回标点符号
feedback	int	可选	是否实时的返回背诵的内容：只有设置0或1，默认值为0，非实时方式
attachAudioUrl	int	可选	评测结果中是否返回音频url 0: 不返回 1: 返回

参数示例

{
    "coreType":"cn.recite.score",
    "feedback":1,
    "refText":"床前明月光,疑是地上霜,举头望明月,低头思故乡"
}

返回结果示例

{
    "eof":1,
    "result":{
        "precision":1,
        "rank":100,
        "res":"chn.recite.mfcc.0.1",
        "pretime":1156,
        "systime":7224,
        "wavetime":7400,
        "delaytime":27,
    "overall":68,
        "integrity":75,
    "pron":69,
    "fluency":65,
        "version":"0.0.80.2021.6.25.13:51:13",
        "details":[
            {
                "dur":960,
                "end":1170,
                "start":210,
                "chn_char":"床",
                "char":"chuang",
                "tone":2,
                "score":82
            },
            Object{...},
            Object{...},
            Object{...},
            Object{...},
            {
                "dur":0,
                "end":0,
                "start":0,
                "dp_type":1,
                "chn_char":"疑",
                "char":"ni",
                "tone":3,
                "score":0
            },
            Object{...},
            Object{...},
            Object{...},
            Object{...},
            Object{...},
            Object{...},
            Object{...},
            Object{...},
            Object{...},
            Object{...},
            Object{...},
            Object{...},
            Object{...},
            Object{...}
        ],
        "info":Object{...},
        "overall":49
    },
    "applicationId":"t148",
    "recordId":"11ebd62ec4c98694afcat14801912a77",
    "tokenId":"58dd4400f490b2e5e82df64293bd886f",
    "params":{
        "app":{
            "sig":"default",
            "applicationId":"t148",
            "userId":"test-mini-bsg-cn-recitation",
            "timestamp":"1624678191776"
        },
        "audio":Object{...},
        "request":Object{...}
    },
    "dtLastResponse":"2021-06-26 11:29:59:562",
    "cloud_platform":{
        "origin_audio_length":44496
    },
    "connect":Object{...},
    "refText":"床前明月光,疑是地上霜,举头望明月,低头思故乡"
}

返回结果说明

键	类型	说明	使用建议
tokenId	string	用户请求的唯一标识	可供参考
applicationId	string	授权账号，即用户的Appkey	内部参数
audioUrl	string	用户音频下载地址：音频默认保留20天左右,如需长久保存,建议产品方下载至自己的服务器。域名会因不同访问区域而不同，以实际返回为准。
recordId	string	音频文件的唯一标识
refText	string	待背诵的文本
dtLastResponse	string	云端响应的时间点	内部参数
eof	int		内部参数
params	object	回显客户端传入的评测请求参数
- app	object
- - applicationId	string	授权账号
- - userId	string	产品端的用户标识，可以是自定义的自符串，建议一个用户一个userid,方便排查问题
- - timestamp	string	start时间
- - sig	string	校验码
- request	object
- - coreType	string	使用引擎
- - tokenId	string	用户请求的唯一标识
- - refText	string	待背诵的文本
- - attachAudioUrl	int	评分结果中是否包含音频url
- audio	object
- - sampleRate	int	采样率
- - channel	int	声道
- - sampleBytes	int	每采样字节数，支持单字节和双字节
- - audioType	string	音频格式
result	object	评测结果
- overall	float	总分	内部参数
- systime	int	评测整个过程的总耗时，单位ms
- res	string	评测本题型时，使用的资源名称	内部参数
-fluency	object	流利度情况
-version	string	引擎的版本，包含发布时间
- integrity	float	完整度评分	建议字段
- pretime	int	云端调用Start接口本身耗时，单位ms
- pron	float	发音分	内部参数
-delaytime	int	云端从feed音频结束到获取结果的耗时，单位ms	内部参数
-wavetime	int	音频时长	可供参考
- info	object
- - snr	float	信噪比	可供参考
- - clip	float	音频声音太高，出现截幅，范围(0\~1)。此参数影响评分时，会设置相应的tipId值	内部参数
- - tipId	int	音频质量	建议字段
-- volume	int	录音音量，范围（0～180dB）	可供参考
- details	array	单字详细得分（最终返回的结果）	建议字段
- - tone	int	单个拼音或声韵母声调	0~4分别对应轻声、一声、二声、三声、四声
- - tonescore	int	单个拼音或声韵母声调得分
- - score	float	单个拼音或声韵母得分
- - char	string	单字对应的拼音
- - chn_char	string	单字
- - dp_type	int	表示增漏读	0：表示正常发音，一般不显示(实时反馈模式，此字段必显示) 1：表示漏读此单词 2：表示重复读
- - end	int	单个拼音或声韵母发音时间,单位为毫秒（ms）
- - start	int	单个拼音或声韵母在音频中的起始时间，单位为毫秒（ms）

返回结果说明

维度	说明	详细
overall	总分	整体评分
pron	发音分
fluency	流利度总分
integrity	完整度得分

评测失败时的返回结果

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

错误码

错误码参考：评测错误码