语音听写，是基于自然语言处理，将自然语言音频转换为文本输出的技术。语音听写技术与语法识别技术的不同在于，语音听写不需要基于某个具体的语法文件，其识别范围是整个语种内的词条。

自2019/8/16起，高阶功能-动态修正免费开放！可到这里 动态修正效果 在线体验 使用方法详见 动态修正

在听写时，可以上传个性化的词表，如联系人列表等，提高列表中词语的匹配率（详情见个性化热词设置）。

语音听写详细的接口介绍及说明请参考： MSC Android API 文档 。

在集成过程中出现错误，请优先查询SDK&API 错误码查询 。如有疑问，请提交工单 进行咨询，也可登录讯飞开放平台论坛 与广大开发者共同学习和交流。

小语种：

根据官网控制台 提示，直接下载SDK，SDK中包含简易可运行的Demo。如下图所示：

备注：Android sdk目前支持android4.4及以上系统，同时建议真机调试。 下载完SDK后，解压至相应的路径，以Android Studio集成开发工具为例，测试时建议直接用真机进行测试。

打开Android Studio，在菜单栏File--->new--->import project当前解压sdk路径，使用在线服务能力选择导入SpeechDemo，如下图所示：

导入成功之后sync编译下，编译无误可连接手机，开启手机USB开发调试模式，直接在Android Studio运行导入的Speechdemo，最后生成的apk可直接安装在对应的手机上，如下图所示: 如果编译时出现“ERROR: Plugin with id 'com.android.application' not found.”错误，请在build.gradle文件中添加以下代码。

如在导入项目中还出现其他问题，可参考帖子：安卓demo常见错误排查

打开Android Studio,在菜单栏File--->new--->import module当前解压sdk路径，使用在线服务能力选择导入SpeechDemo。 导入成功之后sync编译下，编译无误可连接手机，开启手机USB开发调试模式，直接在Android Studio运行导入的Speechdemo，最后生成的apk可直接安装在对应的手机上。

《Android SDK目录结构一览》

将在官网下载的Android SDK 压缩包中libs目录下所有子文件拷贝至Android工程的libs目录下。如下图所示：

注：

在工程 AndroidManifest.xml 文件中添加如下权限

注意：如需在打包或者生成APK的时候进行混淆，请在proguard.cfg中添加如下代码：

初始化即创建语音配置对象，只有初始化后才可以使用MSC的各项服务。建议将初始化放在程序入口处（如Application、Activity的onCreate方法），初始化代码如下：

注： 多候选效果是由引擎决定的，并非绝对的。即使设置了多候选，如果引擎并没有识别出候选的词或句，返回结果也还是单个。

备注：以上均为SDK常用参数说明，均在setParam()方法里面设置，设置示例：mIat.setParameter(SpeechConstant.LANGUAGE, "en_us");更多详细参数请参考：MSC Android API 文档 .

sdk提供了两种识别方式，分别为带UI识别和无UI方式：

无论在哪一种语言中，不同的单词或字（word），或多或少，都会有相似的发音（pronounce）。尤其在汉语中，这种现象更普遍，如当一个人说 /zhang/ /s[h]an/ 时，对应的词语的组成，可能是 {张，章，彰，...} {三，姗，珊，...}，这些文字的组合，在汉语的习惯中出现频率最高的，当然是“张三”了。

而在听写返回结果时，会结合上下文，把日常生活中，出现频率最高的词汇返回给客户端。这时，如果我们实际想要的结果并不是出现频率最高的词汇，如上文中我们实际要的是“张姗”——这样的情况在手机联系人信息中经常会出现，此时听写结果就不是我们想要的。这种情况下，我们可以通过上传个性化热词的方式，增加热词的识别权重，需要注意的这些个性化信息只是增加相应词条的识别率，但并不是绝对的。

个性化热词分为：应用级热词和用户级热词。

用户级热词：在程序代码中上传的叫用户级热词（参考MSC Android API 文档中 SpeechRecognizer 类的 updateLexicon 函数介绍，demo里面也有代码示例），用户级热词只对上传热词的某个用户（设备）生效，一般上传后10分钟左右生效，影响的范围是，当前 APPID 应用的当前设备——即同一应用，不同设备里上传的热词互不干扰；同一设备，不同APPID的应用上传的热词互不干扰。

应用级热词：在网页上上传的是应用级热词（讯飞开放平台官网—控制台 —个性化热词设置），上传后1-2小时后生效，应用级热词是对所有运行你应用的设备都生效，更新给当前APPID的所有使用设备。

注：个性化热词仅支持中文，不支持数字和英文及其他小语种。

在createUtility接口的params参数中添加：

例如：SpeechUtility.createUtility(context, SpeechConstant.APPID + “=12345678” + “,” + “net_type=custom, proxy_ip=192.168.1.2, proxy_port=8080”); 注意：各参数间，以英文逗号分隔。

接口原型： public static SpeechUtility createUtility(Context context, java.lang.String params)

注意： 若在设置代理参数后，使用语音服务过程中，报错10204/10205/10212等网络异常错误时，请查阅以下内容，做出相关操作：

听写结果示例：

多候选结果示例：

若开通了动态修正功能并设置了dwa=wpgs（仅中文支持），会有如下字段返回：

动态修正返回结果解析代码示例：