# 语音评测试题格式及结果说明

评测试题需要符合一定的格式，汉语试题和英语试题有所不同，同语种的不同题型也有差异。

# 中文评测试题格式

# 1. 单个汉字的评测

# 评测题型参数名称

read_syllable

# 试卷格式

支持两种试卷格式：

• 拼音标注试卷 。 以 <customizer:interphonic>开头，字单独一行，紧接着的一行为字的拼音。
  （1）用拼音后加数字代表声调， 1-4 分别代表一到四声， 5 表示轻声。
  （2）ü除了lü和nü用lv和nv表示（如：女：nv3）其他用u表示，如局（ju2）。
  （3）üe用ue表示，如：略（lue4）。
• 纯文本试卷。每个字间用逗号隔开；

不建议超过400字节，且单行汉字个数不要超过100个。

# 试卷示例

• 拼音标注示例：

<customizer: interphonic>
丰   
feng1   
呈   
cheng2   
政    
zheng4    

• 纯文本示例：

丰，呈，政

# 2. 中文词组评测

# 评测题型参数名称

read_word

# 试卷格式

支持两种试卷格式：

• 拼音标注试卷。与字的拼音标注试卷一样，只不过将字换成词语；
• 纯文本试卷。每个词间用逗号隔开；

不建议超过400字节，且单行汉字个数不要超过100个。

# 试卷示例

• 拼音标注示例：

<customizer: interphonic>
宁可     
ning4|ke3    
非难    
fei1|nan4    
灾难    
zai1|nan4    

• 纯文本示例：

宁可，非难，灾难    

# 3. 中文句子评测

# 评测题型参数名称

read_sentence

# 试卷格式

支持两种试卷格式：

• 拼音标注试卷。与词组的拼音标注试卷一样，只不过将词组换成句子；
• 纯文本试卷。

不建议超过2000字节，且单行汉字个数不要超过100个。

# 试卷示例

• 拼音标注示例：

<customizer: interphonic>
这是中文语句评测示例。    
zhe4|shi4|zhong1|wen2|yu3|ju4|ping2|ce4|shi4|li4

• 纯文本示例：

这是中文语句评测示例。 

# 注意事项

• 拼音标注格式下，拼音个数要与汉字个数一致，并且一行汉字不能超过100字。
• 建议每份试卷字数不超过200字，字数太多，朗读语音过长，响应时间较长。

# 4. 中文篇章评测

# 评测题型参数名称

read_chapter

# 试卷格式

支持两种试卷格式：

• 拼音标注试卷。与句子的拼音标注试卷一样，只不过篇章是由多个句子组成；
• 纯文本试卷。

文本不建议超过2000字节，且单行汉字个数不要超过100个。

# 试卷示例

• 拼音标注示例：

<customizer: interphonic>
大家好。这是中文篇章评测示例。    
da4|jia1|hao3|zhe4|shi4|zhong1|wen2|pian1|zhang1|ping2|ce4|shi4|li4   

• 纯文本示例：

大家好。这是中文篇章评测示例。    

# 注意事项

• 请按照语文写作文的格式，需要有准确的标点符号分句，如：分句，逗号，问号，句号，感叹号等。
• 每句话（由分隔号分割）不超过100字。
• 拼音标注格式下，拼音个数要与汉字个数一致，并且一行汉字不能超过100字。
• 建议每份试卷字数不超过200字，字数太多，朗读语音过长，响应时间较长。

# 英文评测试题格式

# 1. 英文单词评测

# 评测题型参数名称

read_word

# 试卷格式

• 一个单词占一行，首行必须用[word]标记，单个单词长度应不大于32字节。
• 数字读法标注试卷：
  （1）在数字下一行必须用[number_replace]标记。
  （2）在[number_replace]的下一行，以“数字/读法/”这种格式标注，注意符号/个数必须为2，且//中内容不可以加符号。
  

不建议超过700字节。

# 试卷示例

• 普通文本

[word]
apple
banana
orange

• 数字读法标注：

[word]
13
[number_replace]
13/thirteen/

# 注意事项

• 单个单词可支持标点符号，仅支持英文半角字符.-'（即点号、连字符、上单引号），如p.m和year-old可支持，hello,world不支持。
• 单个单词不支持标点符号两端都是空格（即标点符号单独作为一个单词会报错）。
• 每个单词字节数不可超过31。
• 单词数量不超过100个。

# 2. 英文句子评测

# 评测题型参数名称

read_sentence

# 试卷格式

普通英文文本，首行必须用[content]标记，单个单词长度应不大于32字节。

• 数字读法标注试卷：
  （1）在数字下一行必须用[number_replace]标记。
  （2）在[number_replace]的下一行，以“数字/读法/”这种格式标注，注意符号/个数必须为2，且//中内容不可以加符号。
  

不建议超过2000字节。

# 试卷示例

• 普通文本：

[content]
This is an example of sentence test.

• 带可支持英文半角字符：

[content]
I don't know.

• 数字读法标注：

[content]
I’m 13 years old.
[number_replace]
13/thirteen/

# 注意事项

• 不支持字符占整个content节点内容字节数的大小不能超过10%。支持字符见下方附录“引擎可支持英文半角字符”。
• 每个单词字节数不可超过31。
• 每句单词数不能超过100个，每句字节数不能超过1024个字节（分句符号也算作一个字节）
• 所有单词数不超过1000个。

# 3. 英文篇章评测

# 评测题型参数名称

read_chapter

# 试卷格式

• 普通英文文本，首行必须用[content]标记，采用英文半角字符.!?;四个进行分句。
• 文本总单词个数不超过1000个。
• 数字读法标注试卷格式请参照句子题型。

# 试卷示例

[content]
Hello,everybody.This is an example of sentence test.

# 注意事项

• 不支持字符占整个content节点内容字节数的大小不能超过10%。支持字符见下方附录“引擎可支持英文半角字符”。
• 每个单词字节数不可超过31。
• 每句单词数不能超过100个，每句字节数不能超过1024个字节（分句符号也算作一个字节）。

# 附录：引擎可支持英文半角字符

# 评测结果格式

• SDK 返回 XML 格式的评测结果，可以分成两种： 一种是十分精简的结果； 另一种是详细结果。
• WebAPI 返回 JSON 格式的评测结果。

# SDK精简结果

在英语评测中，将 result_level 设置成 plain 将返回精简结果（注：汉语评测返回的都是详细结果），格式如下：

<?xml version="1.0" ?>
<FinalResult>
	<ret value="0"/>
	<total_score value="4.496416"/>
</FinalResult>

结果中包含一个返回值 ret（0 表示评测正常） 和总分 total_score。

# SDK详细结果（WebAPI结果完整版）

SDK：当 result_level 设置为 complete 或不设置时，返回详细的 XML 评测结果，结果中包含的主要标签如下
WebAPI：当result_level 设置为 entirety 或不设置时，返回详细的 JSON 评测结果，结果中包含的主要标签如下

read_syllable、 read_word 、 read_sentence 、 read_chapter 标签中的属性记录了本次评测的各项得分、 整体时长等信息。 sentence、 word、 syllable 和 phone 标签记录的是云端引擎对评测语音的分析结果，如哪些是静音，静音时长多少，哪些是有效发音，每个字、词的音节发音是否正确等等。

# 中文评测

以下为中文评测结果的属性说明

# 中文字（read_syllable）

以下是各个层级的字段说明。

read_syllable

sentence

word

syll

phone

# 中文词（read_word）

以下是各个层级的字段说明。

read_word

sentence

word

syll

phone

# 中文句子（read_sentence）

以下是各个层级的字段说明。

read_sentence

sentence

word

syll

phone

# 中文篇章（read_chapter）

以下是各个层级的字段说明。

read_chapter

sentence

word

syll

phone

# 英文评测

以下为英语评测结果的属性说明（注：一帧长度为 10ms）

#####英文单词（read_word）

以下是各个层级的字段说明。

read_word

sentence

word

syll

phone

# 英文句子（read_sentence）

以下是各个层级的字段说明。

read_sentence

sentence

word

syll

phone

# 英文篇章（read_chapter）

以下是各个层级的字段说明。

read_chapter

sentence

word

syll

phone

# 音标对照表

讯飞音标<->国际音标
XML 结果中音素和音节的音标标记（即 syll 和 phone 标签中的 content 属性） 并不是标准音标，以下是它们与国际标准音标的对应关系：

# dp_message属性说明

# property属性说明

# except_info列表