Linux SDK 文档

1、简介

语法（命令词）识别，是基于语法规则，将与语法一致的自然语言音频转换为文本输出的技术。语法识别的结果值域只在语法文件所列出的规则里，故有很好的匹配率，另外，语法识别结果携带了结果的置信度，应用可以根据置信分数，决定这个结果是否有效。语法识别多用于要更准确结果且有限说法的语音控制，如空调的语音控制等。在第一次使用某语法进行识别时，应用需要先编写一个语法文件，然后通过调用QISRBuildGrammar接口编译本地语法文件，以及获得语法ID，并在会话时，传入语法ID，以使用该语法，在之后的会话中，继续使用此语法进行识别，无需再次构建。

本文只对构建和使用语法的 SDK 调用过程进行介绍，关于语法的规则说明，请参考语法开发指南；

详细代码调用请参考 Samples中的 asr_sample(语法识别示例)。API详细描述请参考API文档

#2、SDK集成指南

#2.1 Demo运行步骤

1.在控制台下载对应sdk

2.进入sdk内samples/asr_offline_sample目录source 64bit_make.sh或32bit_make.sh, 视系统位数选择

3.运行成功后进入sdk bin目录下cd ../../bin/，运行./asr_offline_sample即可看到运行结果

#2.2 项目集成步骤

#2.2.1 sdk包说明

《SDK目录结构一览》

bin(运行时目录)：
- 相关资源文件
doc：
- 相关技术文档
include:
- 调用SDK所需头文件
libs：
- libmsc.so（x64 和 x86库文件）
samples：
- asr_offline_sample （离线命令词示例-已录制音频）
- asr_offline_record_sample（离线命令词示例-从麦克风录入）
注意：
- 为了减少SDK包在应用中占用的大小，官网在下载单个功能的SDK包时，可能并不包含其他功能，如下载唤醒的SDK包时，可能不包含听写或合成等功能，因此在运行未包含功能的示例时，可能会报错。对此请下载对应功能的SDK，或下载组合的SDK包。

#2.2.2 sdk导入

新建目录Demo，将SDK中bin,include,libs文件夹复制到新建工程“Demo”文件夹下
在demo目录新建文件demo.c，详细源码请参考samples中对应的语音示例
在demo目录下，创建Makefile文件，具体参见samples下的Makefile，修改路径和目标文件即可
将samples目录下“32bit_make.sh”文件或者“64bit_make.sh”文件拷到demo目录下,修改libmsc.so库搜索路径
cd到demo目录下，执行“source 32bit_make.sh”或者 “source 64bit_make.sh”完成编译
cd到bin目录下运行目标文件，SDK启动后，bin/msc目录下会生成日志（注意：msc文件夹下需有msc.cfg文件）

#2.3 参数与说明

#2.3.1 常用参数说明

以下为常用参数说明，更多参数设置请参考API文档

参数	名称	说明
asr_threshold	识别门限	离线语法识别结果门限值，设置只返回置信度得分大于此门限值的结果可取值：0~100，默认值：0
asr_res_path	离线识别资源路径	离线识别资源所在路径，对应格式如下：access_type1\|file_info1\|[offset1]\|[length1];access_type2\|file_info2\|[offset2]\|[length2]各字段含义如下：access_type：文件访问方式，支持路径方式（fo）和文件描述符方式（fd）；file_info：此字段和access_type 对应，文件路径对应fo，文件描述符对应fd，
grm_build_path	离线语法生成路径	构建离线语法所生成数据的保存路径（文件夹）

#2.3.2 命令词结果

开发者需要关注置信度（confidence）字段，来判断该次命令词是否生效

<?xml version='1.0' encoding='utf-8' standalone='yes' ?><nlp>
  <version>1.1</version>
  <rawtext>打电话给丁伟</rawtext>
  <confidence>94</confidence>
  <engine>local</engine>
  <result>
    <focus>dialpre|contact</focus>
    <confidence>81|100</confidence>
    <object>
      <dialpre id="10001">打电话给</dialpre>
      <contact id="65535">丁伟</contact>
    </object>
  </result>
</nlp>

#3、常见问题

#arm架构如何使用SDK？

答：默认提供的只有X86的so库，arm和mips架构请提交交叉编译工单（申请交叉编译的用户需要先完成企业认证，然后下载填写交叉编译申请表格提交到工单中）。

#错误码及相应解决方案查询网址

答：错误码及相应解决方案查询

#离线命令词sdk如何下载试用？

答：文档中心---快速指引有介绍步骤---根据步骤下载相应平台的离线命令词sdk，离线命令词SDK包有10个装机量，试用期为90天。

#离线命令词识别支持多少命令词？

答：离线识别的命令词是开发者自己定义，命令词最大长度为16个汉字，需要先构建语法，然后指定使用的语法。
语法文件开发文档请参考识别语法分享--在线语法和离线语法编写指南（http://bbs.xfyun.cn/forum.php?mod=viewthread&tid=7595）

最后修改时间： 1 年前