SDK 返回 XML 格式的评测结果，可以分成两种： 一种是十分精简的结果； 另一种是详细结果。
[TOC]
## 精简结果
在英语评测中，将 result_level 设置成 plain 将返回精简结果（注：汉语评测返回的都是详细结果），格式如下：
~~~
<?xml version="1.0" ?>
<FinalResult>
<ret value="0"/>
<total_score value="4.496416"/>
</FinalResult>
~~~
结果中包含一个返回值 ret（0 表示评测正常） 和总分 total_score（分值 0-5 分，满分为 5 分）。
## 详细结果
当 result_level 设置为 complete 或不设置时，返回详细的 XML 评测结果，结果中包含的主要标签如下：
|标签| 说明|
|:---:|:---|
|rec_paper| <rec_paper>和</rec_paper>中间的内容即为评测结果，是开发者需要关心的部分。|
|read_syllable| 表明这是单字朗读评测（汉语评测专有）结果。|
|read_word| 表明这是单词朗读评测结果。|
|read_sentence| 表明这是句子朗读评测结果。|
|sentence| 句子。|
|word |单词，句子的组成部分。|
|syllable| 音节，单词发音的组成部分。对于汉语，一个音节对应一个字的发音。|
|phone| 音素，基本发音元素，音节的组成部分。|
read_syllable、 read_word 和 read_sentence 标签中的属性记录了本次评测的各项得分、 整体时长等信息。 sentence、 word、 syllable 和 phone 标签记录的是云端引擎对评测语音的分析结果，如哪些是静音，静音时长多少，哪些是有效发音， 每个字、词的音节发音是否正确等等。
### 中文评测
以下为汉语评测结果的属性说明（注：一帧长度为 10ms）
#### 1. 单个汉字的评测（read_syllable），以下是各个层级的字段说明。
##### *read_syllable*
|属性|含义|
|---|---|
|total_score|总分|
|phone_score|声韵分|
|fluency_score|流畅度分|
|tone_score|调型分|
|integrity_score|完整度分|
|except_info|异常信息，详细请见 except_info 列表|
|beg_pos/end_pos|始/末位置（单位：帧）|
|content |试卷内容|
|time_len| 朗读时长（单位：帧）|
##### *sentence*
|属性|含义|
|---|---|
|time_len |朗读时长（单位：帧）|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|content| 试卷内容|
##### *word*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|symbol |拼音：数字代表声调， 5 和 5 以上表示轻声|
|content |试卷内容|
|time_len| 时长（单位：帧）|
##### *syll*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|dp_message|增漏读信息，详细请见 dp_message 列表|
|symbol |拼音：数字代表声调， 5 和 5 以上表示轻声|
|content| 试卷内容（sil、 silv 表示静音， fil 表示噪音）|
|rec_node_type|paper（试卷内容），sil（非试卷内容）|
|time_len| 时长（单位：帧）|
##### *phone*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|dp_message|增漏读信息，详细请见 dp_message 列表|
|content |试卷内容（sil、 silv 表示静音， fil 表示噪音）|
|rec_node_type|paper（试卷内容），sil（非试卷内容）|
|is_yun|是否是韵母|
|mono_tone|文本调型信息：TONE1(一声)TONE2(二声)<br>TONE3(三声)TONE4(四声)|
|perr_msg|错误信息：1（声韵错）2（调型错）3（声韵调型错）|
|time_len| 时长（单位：帧）|
#### 2. 中文词组评测（read_word），以下是各个层级的字段说明。
##### *read_word*
|属性|含义|
|---|---|
|total_score|总分|
|phone_score|声韵分|
|fluency_score|流畅度分|
|tone_score|调型分|
|integrity_score|完整度分|
|except_info|异常信息，详细请见 except_info 列表|
|beg_pos/end_pos|始/末位置（单位：帧）|
|content |试卷内容|
|time_len| 朗读时长（单位：帧）|
##### *sentence*
|属性|含义|
|---|---|
|time_len |朗读时长（单位：帧）|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|content| 试卷内容|
##### *word*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|symbol |拼音：数字代表声调， 5 和 5 以上表示轻声|
|content |试卷内容|
|time_len| 时长（单位：帧）|
##### *syll*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|dp_message|增漏读信息，详细请见 dp_message 列表|
|symbol |拼音：数字代表声调， 5 和 5 以上表示轻声|
|content| 试卷内容（sil、 silv 表示静音， fil 表示噪音）|
|rec_node_type|paper（试卷内容），sil（非试卷内容）|
|time_len| 时长（单位：帧）|
##### *phone*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|dp_message|增漏读信息，详细请见 dp_message 列表|
|content |试卷内容（sil、 silv 表示静音， fil 表示噪音）|
|rec_node_type|paper（试卷内容），sil（非试卷内容）|
|is_yun|是否是韵母|
|mono_tone|文本调型信息：TONE1(一声)TONE2(二声)<br>TONE3(三声)TONE4(四声)|
|perr_msg|错误信息：1（声韵错）2（调型错）3（声韵调型错）|
|time_len| 时长（单位：帧）|
#### 3. 中文句子评测（read_sentence），以下是各个层级的字段说明。
##### *read_sentence*
|属性|含义|
|---|---|
|total_score|总分|
|phone_score|声韵分|
|fluency_score|流畅度分|
|tone_score|调型分|
|integrity_score|完整度分|
|except_info|异常信息，详细请见 except_info 列表|
|is_rejected|是否被拒（被拒时可以给0分）|
|beg_pos/end_pos|始/末位置（单位：帧）|
|content |试卷内容|
|time_len| 朗读时长（单位：帧）|
##### *sentence*
|属性|含义|
|---|---|
|total_score| 总分|
|phone_score|声韵分|
|fluency_score|流畅度分|
|tone_score|调型分|
|time_len |朗读时长（单位：帧）|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|content| 试卷内容|
##### *word*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|symbol |拼音：数字代表声调， 5 和 5 以上表示轻声|
|content |试卷内容|
|time_len| 时长（单位：帧）|
##### *syll*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|dp_message|增漏读信息，详细请见 dp_message 列表|
|symbol |拼音：数字代表声调， 5 和 5 以上表示轻声|
|content| 试卷内容（sil、 silv 表示静音， fil 表示噪音）|
|rec_node_type|paper（试卷内容），sil（非试卷内容）|
|time_len| 时长（单位：帧）|
##### *phone*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|dp_message|增漏读信息，详细请见 dp_message 列表|
|content |试卷内容（sil、 silv 表示静音， fil 表示噪音）|
|rec_node_type|paper（试卷内容），sil（非试卷内容）|
|is_yun|是否是韵母|
|mono_tone|文本调型信息：TONE1(一声)TONE2(二声)<br>TONE3(三声)TONE4(四声)|
|perr_msg|错误信息：1（声韵错）2（调型错）3（声韵调型错）|
|time_len| 时长（单位：帧）|
#### 4. 中文篇章评测（read_chapter），以下是各个层级的字段说明。
##### *read_chapter*
|属性|含义|
|---|---|
|total_score|总分|
|phone_score|声韵分|
|fluency_score|流畅度分|
|tone_score|调型分|
|integrity_score|完整度分|
|except_info|异常信息，详细请见 except_info 列表|
|is_rejected|是否被拒（被拒时可以给0分）|
|beg_pos/end_pos|始/末位置（单位：帧）|
|content |试卷内容|
|time_len| 朗读时长（单位：帧）|
##### *sentence*
|属性|含义|
|---|---|
|total_score| 总分|
|phone_score|声韵分|
|fluency_score|流畅度分|
|tone_score|调型分|
|time_len |朗读时长（单位：帧）|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|content| 试卷内容|
##### *word*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|symbol |拼音：数字代表声调， 5 和 5 以上表示轻声|
|content |试卷内容|
|time_len| 时长（单位：帧）|
##### *syll*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|dp_message|增漏读信息，详细请见 dp_message 列表|
|symbol |拼音：数字代表声调， 5 和 5 以上表示轻声|
|content| 试卷内容（sil、 silv 表示静音， fil 表示噪音）|
|rec_node_type|paper（试卷内容），sil（非试卷内容）|
|time_len| 时长（单位：帧）|
##### *phone*
|属性|含义|
|---|---|
|beg_pos/end_pos| 始/末位置（单位：帧）|
|dp_message|增漏读信息，详细请见 dp_message 列表|
|content |试卷内容（sil、 silv 表示静音， fil 表示噪音）|
|rec_node_type|paper（试卷内容），sil（非试卷内容）|
|is_yun|是否是韵母|
|mono_tone|文本调型信息：TONE1(一声)TONE2(二声)<br>TONE3(三声)TONE4(四声)|
|perr_msg|错误信息：1（声韵错）2（调型错）3（声韵调型错）|
|time_len| 时长（单位：帧）|
### 英文评测
以下为英语评测结果的属性说明（注：一帧长度为 10ms）
#### 1. 英文单词评测（read_word），以下是各个层级的字段说明。
##### *read_word*
|属性|含义|
|---|---|
|beg_pos/end_pos|多个单词开始/结束时间|
|content |多个单词内容|
|except_info|异常信息，详细请见 except_info 列表|
|is_rejected|是否被拒绝（true / false）。值为 true 表明引擎检测到乱读。|
|total_score| 总分|
|accuracy_score|准确度评分|
|standard_score|（**预留字段，暂不生效**）标准度评分，评测发音地不地道|
##### *sentence*
|属性|含义|
|---|---|
|beg_pos/end_pos|句子开始/结束时间|
|content |句子内容|
|index|句子索引|
##### *word*
|属性|含义|
|---|---|
|beg_pos/end_pos|单词开始/结束时间|
|content |单词内容|
|dp_message|增漏读信息，详细请见 dp_message 列表|
|global_index| 单词在全篇章索引|
|index|单词在句子中的索引|
|property|单词属性（半句、重读、关键字等）|
|pitch|单词基频信息|
|pitch_beg|单词基频开始值|
|pitch_end|单词基频结束值|
|total_score|单词总分|
##### *syll*
|属性|含义|
|---|---|
|beg_pos/end_pos|音节开始/结束时间|
|content| 音节内容（sil、 silv 表示静音， fil 表示噪音）|
|serr_msg| 音节错误信息|
|syll_accent| 音节重读标记|
|syll_score|音节得分|
##### *phone*
|属性|含义|
|---|---|
|beg_pos/end_pos|音素开始/结束时间|
|content| 音素内容（sil、 silv 表示静音， fil 表示噪音）|
|dp_message|增漏读信息，详细请见 dp_message 列表|
#### 2. 英文句子评测（read_sentence），以下是各个层级的字段说明。
##### *read_chapter*
|属性|含义|
|---|---|
|beg_pos/end_pos|篇章开始/结束时间|
|content |篇章内容|
|except_info|异常信息，详细请见 except_info 列表|
|is_rejected|是否被拒绝（true / false）。值为 true 表明引擎检测到乱读。|
|word_count| 篇章中全部单词数量|
|total_score| 总分|
|accuracy_score|准确度评分|
|fluency_score|流畅度评分|
|integrity_score|完整度评分|
|standard_score|（**预留字段，暂不生效**）标准度评分，评测发音地不地道|
##### *sentence*
|属性|含义|
|---|---|
|beg_pos/end_pos|句子开始/结束时间|
|content |句子内容|
|index| 句子索引|
|total_score |句子评分|
|accuracy_score|准确度评分|
|fluency_score|流畅度评分|
|standard_score|（**预留字段，暂不生效**）标准度评分，评测发音地不地道|
|word_count| 句子中全部单词数量|
##### *word*
|属性|含义|
|---|---|
|beg_pos/end_pos|单词开始/结束时间|
|content |单词内容|
|dp_message|增漏读信息，详细请见 dp_message 列表|
|global_index| 单词在全篇章索引|
|index|单词在句子中的索引|
|property|单词属性（半句、重读、关键字等）|
|pitch|单词基频信息|
|pitch_beg|单词基频开始值|
|pitch_end|单词基频结束值|
|total_score|单词总分|
##### *syll*
|属性|含义|
|---|---|
|beg_pos/end_pos|音节开始/结束时间|
|content| 音节内容（sil、 silv 表示静音， fil 表示噪音）|
|serr_msg| 音节错误信息|
|syll_accent| 音节重读标记|
|syll_score|音节得分|
##### *phone*
|属性|含义|
|---|---|
|beg_pos/end_pos|音素开始/结束时间|
|content| 音素内容（sil、 silv 表示静音， fil 表示噪音）|
|dp_message|增漏读信息，详细请见 dp_message 列表|
#### 3. 英文篇章评测（read_chapter），以下是各个层级的字段说明。
##### *read_chapter*
|属性|含义|
|---|---|
|beg_pos/end_pos|篇章开始/结束时间|
|content |篇章内容|
|except_info|异常信息，详细请见 except_info 列表|
|is_rejected|是否被拒绝（true / false）。值为 true 表明引擎检测到乱读。|
|word_count| 篇章中全部单词数量|
|total_score| 总分|
|accuracy_score|准确度评分|
|fluency_score|流畅度评分|
|integrity_score|完整度评分|
|standard_score|（**预留字段，暂不生效**）标准度评分，评测发音地不地道|
##### *sentence*
|属性|含义|
|---|---|
|beg_pos/end_pos|句子开始/结束时间|
|content |句子内容|
|index| 句子索引|
|total_score |句子评分|
|accuracy_score|准确度评分|
|fluency_score|流畅度评分|
|standard_score|（**预留字段，暂不生效**）标准度评分，评测发音地不地道|
|word_count| 句子中全部单词数量|
##### *word*
|属性|含义|
|---|---|
|beg_pos/end_pos|单词开始/结束时间|
|content |单词内容|
|dp_message|增漏读信息，详细请见 dp_message 列表|
|global_index| 单词在全篇章索引|
|index|单词在句子中的索引|
|property|单词属性（半句、重读、关键字等）|
|total_score|单词总分|
##### *syll*
|属性|含义|
|---|---|
|beg_pos/end_pos|音节开始/结束时间|
|content| 音节内容（sil、 silv 表示静音， fil 表示噪音）|
|serr_msg| 音节错误信息|
|syll_accent| 音节重读标记|
|syll_score|音节得分|
##### *phone*
|属性|含义|
|---|---|
|beg_pos/end_pos|音素开始/结束时间|
|content| 音素内容（sil、 silv 表示静音， fil 表示噪音）|
#### **音标对照表（讯飞音标<-->国际音标）**
XML 结果中音素和音节的音标标记（即 syll 和 phone 标签中的 content 属性） 并不
是标准音标，以下是它们与国际标准音标的对应关系：
|*讯飞音标*| 标准音标|*讯飞音标*|标准音标|
|:---:|:---:|:---:|:---:|
|aa|ɑː|f| f|
|ae |æ| g |g|
|ah |ʌ| hh |h|
|ao |ɔː|jh |dʒ|
|ar |eə|k |k|
|aw |aʊ|l| l|
|ax |ə| m| m|
|ay |aɪ|n|n|
|eh |e |ng |ŋ|
|er |ɜː |p |p|
|ey |eɪ |r |r|
|ih |ɪ |s |s|
|ir |ɪə |sh|ʃ|
|iy |iː |t |t|
|oo |ɒ| th |θ|
|ow |əʊ |v |v|
|oy |ɒɪ |w |w|
|uh |ʊ |y |j|
|uw|uː |z |z|
|ur |ʊə |zh |ʒ|
|b |b |dr |dr|
|ch |tʃ |dz|dz|
|d |d |tr |tr|
|dh|ð| ts| ts|
### **dp_message 属性说明**
|取值| 含义| 说明|
|:---:|:---:|---|
|0 |正常| 引擎认为该单元读了，但不一定朗读正确|
|16 |漏读| 该单元没有读|
|32 |增读 |该单元是多读的文本内的内容|
|64| 回读| 该单元是重复读的相邻文本的内容|
|128| 替换| 该单元读成文本内其他的内容|
### **except_info 列表**
|取值 |说明|
|:---:|---|
|0 |无异常|
|28673 |无语音输入或音量太小|
|28676| 检测到语音为乱说类型|
|28680 |音频数据信噪比太低|
|28690| 音频数据出现截幅|
