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|e| ts| ts|
### **dp_message 屬性說明**
|取值| 含義| 說明|
|:---:|:---:|---|
|0 |正常| 引擎認為該單元讀了,但不一定朗讀正確|
|16 |漏讀| 該單元沒有讀|
|32 |增讀 |該單元是多讀的文本內的內容|
|64| 回讀| 該單元是重復讀的相鄰文本的內容|
|128| 替換| 該單元讀成文本內其他的內容|
### **except_info 列表**
|取值 |說明|
|:---:|---|
|0 |無異常|
|28673 |無語音輸入或音量太小|
|28676| 檢測到語音為亂說類型|
|28680 |音頻數據信噪比太低|
|28690| 音頻數據出現截幅|