ebnf 语法

xbnf文件采用 ebnf 语法作为基础语法，开发者通过编辑该文件用以限定识别范围同时规定输出的语义项格式。

基本

扩展巴科斯-瑙尔范式(EBNF)是表达作为描述计算机编程语言和形式语言的正规方式的上下文无关文法的元语法(metalanguage)符号表示法。见ebnf。

• ebnf语法有两部分组成：定义变量及主执行语句；形如:

  $hello=你好;
  (\<s\> ($hello) \<\/s\>)
  

• 主执行语句用于指定当前识别的语法，其定义为

  ( 语法内容 )
  

  我们一般在前后加上"<s>"、"</s>",用于表明句子的开始及结束，实际使用中对应用户开始的静音及结束时的静音；
• 变量，如果ebnf语法是较为复杂的语法，且有共用的地方，可以使用变量来做为替换。变量定义语法：

  $变量名=...;   #以$开始标明变量名，同时以分号结束;
  

  变量名由字母或者中文组成，如:

  $hello=你好;
  $你好=你好|hello;
  (\<s\> ( $hello | $你好 ) \<\/s\>)
  

变量再使用的时候，使用"$变量名"引用，以空格结束。

正则标记

目前支持的正则标记有：

语义设定

• K，V项的设置

在扩展属性语法"/.../"中设置"k","v"，用于识别反馈语义，如:

$digit = (1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0);
$phone_num =($digit/min=1,max=11,k="number"/);              
$expr1=(打电话给)/k="action",v="call"/ $phone_num;

( \<s\> ($expr1) \<\/s\>)

如果识别结果为"打电话给123456"，对应的语义输出为:

{"action":"call","number":"123456"}

说明: 如果扩展属性语法"/.../"中存在"k"值，即当前结果是要做语义输出的，如果没有指定"v"，则采用对应的识别结果做为对应的键值；如果指定v，则使用"v"做为输出。如:

$phone_num =($digit/min=1,max=11,k="number"/) => 输出 "number":"123456"
(打电话给)/k="action",v="call"/   => 输出 "action":"call";

• 层级嵌套的设定

语法属性支持层级的设计，输出结果为json，如:

$digit = (1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0);
$phone_num =($digit/min=1,max=11,k="number"/);              
$expr1=((打电话给)/k="action",v="call"/ $phone_num)/k="test"/;

( \<s\> ($expr1) \<\/s\>)

如果识别结果为"打电话给123456"，对应的语义输出为:

{"test":{"action":"call","number":"123456"}}

• 扩展的属性

同时支持自定义扩展属性，用于json输出: 如check="hook即为自定义属性，输出为"check":"hook"

$NUM = ( $DIGIT/min=1,max=11,k="number",check="hook"/);

其对应的json输出为:

{"number":"123456","check":"hook"}

语义识别结果说明

实例语法形如:

$DIGIT = (1 | 2 | 3 | 4 | 5 | 6 | 7 | 8 | 9 | 0); 
$NUM = ( $DIGIT/min=1,max=11,k="number"/); #number字段使用长度为1～11的数字填充
$PERSON = (小明|小华|小金)/k="person"/;  #person字段使用(小明|小华|小金)中的一个填充
$PHONE_ACTION = (打[电话]给 | 电话给 | 呼叫 | 联系 | 致电 | 拨通 | 拨打)/action="call"/; #为其加上自定义的属性，以表明具体动作
$CMD = ($PHONE_ACTION ($PERSON | $NUM))/domain="phone"/; #为其加上自定义的属性domain="phone"，以区分大类

( \<s\> (  $CMD  ) \<\/s\> )

如果识别中设置setUseXbnfRec(true),对应的语义识别结果形如:

{
    "version": "0.0.34.2014.4.3.16:19:48", 
    "res": "grammar.h.0.0.9", 
    "eof": 1, 
    "rec": "打电话给小明", 
    "conf": 0.832383, 
    "post": {
        "sem": {   //语义识别结果
            "domain":"phone",
            "action": "call",   
            "person": "小明"
        }
    }
}

{
    "version": "0.0.34.2014.4.3.16:19:48", 
    "res": "grammar.h.0.0.9", 
    "eof": 1, 
    "rec": "打电话给10086", 
    "conf": 0.832383, 
    "post": {
        "sem": {   //语义识别结果
            "domain":"phone",
            "action": "call",   
            "number": "10086"
        }
    }
}