AILocalSemanticEngine (DUI Lite SDK

java.lang.Object
- com.aispeech.export.engines2.AILocalSemanticEngine

public class AILocalSemanticEngine
extends java.lang.Object

离线语义引擎

字段概要

字段
限定符和类型字段和说明

static java.lang.String TAG

字段
限定符和类型	字段和说明
`static java.lang.String`	`TAG`

方法概要

所有方法静态方法实例方法具体方法已过时的方法
限定符和类型	方法和说明
`void`	`cancel()` 取消本次识别操作
`static boolean`	`checkLibValid()`
`static AILocalSemanticEngine`	`createInstance()`
`void`	`destroy()` 销毁本地识别引擎
`void`	`feedData(byte[] data)` 已过时。
`void`	`feedData(byte[] data, int size)` 传入数据,在不使用SDK内部录音机时调用
`java.util.List<java.lang.String>`	`getVocab(java.lang.String vocabName)` 获取 ldm contents 同步方法读取联系人需要在线程中调用
`void`	`init(AIASRListener listener)` 已过时。已过时, see `init(AILocalSemanticConfig, AIASRListener)`
`void`	`init(AILocalSemanticConfig config, AIASRListener listener)` 初始化本地识别引擎
`void`	`notifyWakeup()` 告知识别引擎已经唤醒，该接口在oneshot功能中使用，内部会记录唤醒的时间点，之后在vad end的时候来判断到底用户说的是不是唤醒词+指令，还是只有唤醒词
`void`	`setAsrNetBin(java.lang.String asrNetBin)` 设置识别网络资源名, 适用于识别网络资源放在assets目录下须在init之前设置才生效
`void`	`setAsrNetBinPath(java.lang.String path)` 设置识别网络资源自定义路径, 适用于通过语法构建引擎动态生成网络资源或者网络资源放在自定义路径须在init之前设置才生效
`void`	`setAsrResBin(java.lang.String asrResBin)` 设置识别声学资源名须在init之前设置才生效, 适用于识别声学资源放在assets目录下
`void`	`setAsrResBinPath(java.lang.String path)` 设置识别声学资源名须在init之前设置才生效, 适用于识别声学资源放在自定义目录下
`void`	`setDomain(java.lang.String domain)` 设置前一轮对话领域信息,start之前设置生效
`void`	`setExpandFnPath(java.lang.String path)` ExpandFn 文件路径,用于动态拆分net.bin文件 start 之前传入有效
`void`	`setLanguages(Languages languages)` 已过时。已过时使用 AILocalASRConfig 统一配置 `init(AILocalSemanticConfig, AIASRListener)`
`void`	`setMaxSpeechTimeS(int seconds)` 设置音频最大录音时长，达到该值将取消语音引擎并抛出异常允许的最大录音时长单位秒 0 表示无最大录音时长限制默认大小为60S 须在start之前设置才生效
`void`	`setNoSpeechTimeOut(int milliSecond)` 设置无语音超时时长，单位毫秒，默认值为5000ms ；如果达到该设置值时，自动停止录音并放弃请求识别内核须在start之前设置才生效
`void`	`setPauseTime(int pauseTime)` 设置VAD右边界
`void`	`setSaveAudioPath(java.lang.String path)` 设置保存的音频路径，最终的音频路径为path + local_semantic_+ recordId + ".pcm" 需要在start之前调用
`void`	`setSelectRuleThreshold(double threshold)` 设置 grammar 与 ngram 最终输出结果的决策阈值
`void`	`setSemLuaFolder(java.lang.String semLuaFolder)` 设置语义lua资源所在文件夹, 适用于语义lua资源所在文件夹放在assets目录下须在init之前设置才生效
`void`	`setSemLuaFolderPath(java.lang.String semLuaFolderPath)` 设置语义lua资源所在文件夹自定义路径, 适用于语义lua资源所在文件夹放在自定义路径须在init之前设置才生效
`void`	`setSemResFolder(java.lang.String semResFolder)` 设置语义资源文件夹,名适用于语义资源文件夹放在assets目录下须在init之前设置才生效
`void`	`setSemResFolderPath(java.lang.String semResFolderPath)` 设置语义资源文件夹自定义路径, 适用于语义资源文件夹放在自定义路径须在init之前设置才生效
`void`	`setSkillID(java.lang.String skillID)` 设置SKILLID
`void`	`setTask(java.lang.String task)` 设置前一轮的对话task信息，start之前设置生效
`void`	`setUseConf(boolean useConf)` 设置是否开启置信度须在start之前设置才生效
`void`	`setUseCustomFeed(boolean useCustomFeed)` 设置是否自行feed数据,不使用内部录音机(包括MockRecord和AIAudioRecord), 需要在init之前调用, 默认为false
`void`	`setUseDelimiter(java.lang.String delimiter)` 添加识别结果分割符,如设置 "," 识别结果显示： "打,开,天,窗" start 之前设置生效
`void`	`setUseFormat(boolean useFormat)` 设置是否开启语义格式归一化,默认 false
`void`	`setUseFrameSplit(boolean useFrameSplit)` 设置是否开启识别中间结果
`void`	`setUseMaxSpeechResult(boolean useMaxSpeechResult)` 设置是否使用录音超时之后的识别结果，默认返 `AIError.ERR_MAX_SPEECH` 开启后则尝试将录音识别结果返回须在start之前设置才生效
`void`	`setUsePinyin(boolean usePinyin)` 设置是否开启拼音输出须在start之前设置才生效
`void`	`setUseRefText(boolean useRefText)` 设置是否关闭识别并只传入语义文本功能，
`void`	`setUseSelectRule(boolean useSelectRule)` 设置是否使用SDK内部的 grammar 与 ngram 决策规则，默认 false
`void`	`setUseXbnfRec(boolean useXbnfRec)` 设置是否启用基于语法的语义识别须在start之前设置才生效
`void`	`setVadEnable(boolean vadEnable)` 设置是否启用vad 须在init之前设置才生效
`void`	`setVadRes(java.lang.String vadRes)` 设置VAD资源名,适用于VAD资源放置在assets目录须在init之前设置才生效
`void`	`setVadResPath(java.lang.String path)` 设置VAD资源名绝对路径，适用于VAD资源放置在自定义目录下须在init之前设置才生效
`void`	`start()` 已过时。已过时, 不推荐使用
`void`	`start(AILocalSemanticIntent intent)` 识别+语义模式启动引擎
`void`	`startWithRecording()` 启动录音，开始语音识别
`void`	`startWithText(java.lang.String refText)` 已过时。请参考 `startWithText(java.lang.String)`
`void`	`startWithText(java.lang.String refText, java.lang.String pinyin)` 启动引擎，输入文本和拼音，拼音可从识别结果中获取
`void`	`stopRecording()` 停止录音，等待识别结果
`void`	`updateNetBinPath(AIUpdateListener listener, java.lang.String asrNetBin)` 更新 netBin
`void`	`updateNetBinPath(java.lang.String asrNetBin)` 已过时。该接口不支持结果回调，请使用新接口 `updateNetBinPath(AIUpdateListener, String)`
`void`	`updateVocabs(AIUpdateListener updateListener, Vocab... vocabs)` 更新 ldm 词库

从类继承的方法 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- 字段详细资料
  - TAG
```
public static final java.lang.String TAG
```
    另请参阅:
    
    常量字段值
- 方法详细资料
  - createInstance
```
public static AILocalSemanticEngine createInstance()
```
  - checkLibValid
```
public static boolean checkLibValid()
```
  - setAsrResBin
```
public void setAsrResBin(java.lang.String asrResBin)
```
    设置识别声学资源名须在init之前设置才生效, 适用于识别声学资源放在assets目录下
    
    参数:
    
    asrResBin - 资源名
  - setAsrResBinPath
```
public void setAsrResBinPath(java.lang.String path)
```
    设置识别声学资源名须在init之前设置才生效, 适用于识别声学资源放在自定义目录下
    
    参数:
    
    path - 资源名全路径
  - setAsrNetBin
```
public void setAsrNetBin(java.lang.String asrNetBin)
```
    设置识别网络资源名, 适用于识别网络资源放在assets目录下须在init之前设置才生效
    
    参数:
    
    asrNetBin - 资源名
  - setAsrNetBinPath
```
public void setAsrNetBinPath(java.lang.String path)
```
    设置识别网络资源自定义路径, 适用于通过语法构建引擎动态生成网络资源或者网络资源放在自定义路径须在init之前设置才生效
    
    参数:
    
    path - 资源名全路径
  - setSemResFolder
```
public void setSemResFolder(java.lang.String semResFolder)
```
    设置语义资源文件夹,名适用于语义资源文件夹放在assets目录下须在init之前设置才生效
    
    参数:
    
    semResFolder - 语义资源文件夹
  - setSemResFolderPath
```
public void setSemResFolderPath(java.lang.String semResFolderPath)
```
    设置语义资源文件夹自定义路径, 适用于语义资源文件夹放在自定义路径须在init之前设置才生效
    
    参数:
    
    semResFolderPath - 语义资源文件夹全路径
  - setSemLuaFolder
```
public void setSemLuaFolder(java.lang.String semLuaFolder)
```
    设置语义lua资源所在文件夹, 适用于语义lua资源所在文件夹放在assets目录下须在init之前设置才生效
    
    参数:
    
    semLuaFolder - 语义lua资源所在文件夹
  - setSemLuaFolderPath
```
public void setSemLuaFolderPath(java.lang.String semLuaFolderPath)
```
    设置语义lua资源所在文件夹自定义路径, 适用于语义lua资源所在文件夹放在自定义路径须在init之前设置才生效
    
    参数:
    
    semLuaFolderPath - 语义lua资源所在文件夹全路径
  - notifyWakeup
```
public void notifyWakeup()
```
    告知识别引擎已经唤醒，该接口在oneshot功能中使用，内部会记录唤醒的时间点，之后在vad end的时候来判断到底用户说的是不是唤醒词+指令，还是只有唤醒词
  - updateNetBinPath
```
public void updateNetBinPath(java.lang.String asrNetBin)
```
    已过时。该接口不支持结果回调，请使用新接口 updateNetBinPath(AIUpdateListener, String)
    
    允许引擎初始化后动态更新识别网络资源, 适用于通过语法构建引擎动态生成网络资源或者网络资源放在自定义路径引擎处于识别中调用无效,如资源更新失败抛出 AIError.ERR_NET_BIN_INVALID 错误
    
    参数:
    
    asrNetBin - 资源完整路径,如：sdcard/aispeech/net.bin
  - updateNetBinPath
```
public void updateNetBinPath(AIUpdateListener listener,
                             java.lang.String asrNetBin)
```
    更新 netBin
    
    参数:
    
    listener - 更新接口回调 AIUpdateListener
    
    asrNetBin - asr 加载使用 net.bin 资源
  - setDomain
```
public void setDomain(java.lang.String domain)
```
    设置前一轮对话领域信息,start之前设置生效
    
    参数:
    
    domain - 领域信息，如地图
  - setSkillID
```
public void setSkillID(java.lang.String skillID)
```
    设置SKILLID
    
    参数:
    
    skillID - 离线技能ID
  - setTask
```
public void setTask(java.lang.String task)
```
    设置前一轮的对话task信息，start之前设置生效
    
    参数:
    
    task - task信息，如：导航、附件检索等
  - setVadEnable
```
public void setVadEnable(boolean vadEnable)
```
    设置是否启用vad 须在init之前设置才生效
    
    参数:
    
    vadEnable - true:使用Vad；false:禁止Vad，默认为true
  - setVadRes
```
public void setVadRes(java.lang.String vadRes)
```
    设置VAD资源名,适用于VAD资源放置在assets目录须在init之前设置才生效
    
    参数:
    
    vadRes - vadResName
  - setVadResPath
```
public void setVadResPath(java.lang.String path)
```
    设置VAD资源名绝对路径，适用于VAD资源放置在自定义目录下须在init之前设置才生效
    
    参数:
    
    path - vad资源名全路径
  - setPauseTime
```
public void setPauseTime(int pauseTime)
```
    设置VAD右边界
    
    参数:
    
    pauseTime - pauseTime 单位：ms,默认300
  - setUseDelimiter
```
public void setUseDelimiter(java.lang.String delimiter)
```
    添加识别结果分割符,如设置 "," 识别结果显示： "打,开,天,窗" start 之前设置生效
    
    参数:
    
    delimiter - 分割符 , 离线语义引擎不推荐打开,会导致识别结果送入语义引擎无法出结果
  - setUseConf
```
public void setUseConf(boolean useConf)
```
    设置是否开启置信度须在start之前设置才生效
    
    参数:
    
    useConf - true 启用,默认为false
  - setUseXbnfRec
```
public void setUseXbnfRec(boolean useXbnfRec)
```
    设置是否启用基于语法的语义识别须在start之前设置才生效
    
    参数:
    
    useXbnfRec - true 启用，默认为false
  - setExpandFnPath
```
public void setExpandFnPath(java.lang.String path)
```
    ExpandFn 文件路径,用于动态拆分net.bin文件 start 之前传入有效
    
    参数:
    
    path - ExpandFn 文件的绝对路径 slots 文件示例{"slot": [{"name": "DEVICE","path": "device.slot.bin" }, {"name": "WAKEUP_WORD","path": "wakeup_word.slot.bin" }]}
  - setUsePinyin
```
public void setUsePinyin(boolean usePinyin)
```
    设置是否开启拼音输出须在start之前设置才生效
    
    参数:
    
    usePinyin - usePinyin,默认为false
  - setUseFormat
```
public void setUseFormat(boolean useFormat)
```
    设置是否开启语义格式归一化,默认 false
    
    参数:
    
    useFormat - boolean
  - setSelectRuleThreshold
```
public void setSelectRuleThreshold(double threshold)
```
    设置 grammar 与 ngram 最终输出结果的决策阈值
    
    参数:
    
    threshold - 决策阈值，默认是 0.63
  - setUseSelectRule
```
public void setUseSelectRule(boolean useSelectRule)
```
    设置是否使用SDK内部的 grammar 与 ngram 决策规则，默认 false
    
    参数:
    
    useSelectRule - boolean,自定义决策阈值见
    
    另请参阅:
    
    setSelectRuleThreshold(double)
  - setNoSpeechTimeOut
```
public void setNoSpeechTimeOut(int milliSecond)
```
    设置无语音超时时长，单位毫秒，默认值为5000ms ；如果达到该设置值时，自动停止录音并放弃请求识别内核须在start之前设置才生效
    
    参数:
    
    milliSecond - 超时时长，单位毫秒
  - setMaxSpeechTimeS
```
public void setMaxSpeechTimeS(int seconds)
```
    设置音频最大录音时长，达到该值将取消语音引擎并抛出异常
    允许的最大录音时长单位秒
    - 0 表示无最大录音时长限制
    - 默认大小为60S
    须在start之前设置才生效
    参数:
    
    seconds - seconds
  - setUseMaxSpeechResult
```
public void setUseMaxSpeechResult(boolean useMaxSpeechResult)
```
    设置是否使用录音超时之后的识别结果，默认返 AIError.ERR_MAX_SPEECH 开启后则尝试将录音识别结果返回须在start之前设置才生效
    
    参数:
    
    useMaxSpeechResult - useMaxSpeechResult
  - setUseFrameSplit
```
public void setUseFrameSplit(boolean useFrameSplit)
```
    设置是否开启识别中间结果
    
    参数:
    
    useFrameSplit - true 启用,默认为false
  - setUseCustomFeed
```
public void setUseCustomFeed(boolean useCustomFeed)
```
    设置是否自行feed数据,不使用内部录音机(包括MockRecord和AIAudioRecord), 需要在init之前调用, 默认为false
    
    参数:
    
    useCustomFeed - the useCustomFeed to set
  - setUseRefText
```
public void setUseRefText(boolean useRefText)
```
    设置是否关闭识别并只传入语义文本功能，
    
    参数:
    
    useRefText - 默认为false，开启识别功能
  - setLanguages
```
public void setLanguages(Languages languages)
```
    已过时。已过时使用 AILocalASRConfig 统一配置 init(AILocalSemanticConfig, AIASRListener)
    
    设置语种，init 之前设置生效 , 默认 Languages.CHINESE
    
    参数:
    
    languages - Languages
  - setSaveAudioPath
```
public void setSaveAudioPath(java.lang.String path)
```
    设置保存的音频路径，最终的音频路径为path + local_semantic_+ recordId + ".pcm" 需要在start之前调用
    
    参数:
    
    path - 路径
  - init
```
public void init(AIASRListener listener)
```
    已过时。已过时, see init(AILocalSemanticConfig, AIASRListener)
    
    初始化本地识别引擎
    
    参数:
    
    listener - 本地识别回调接口
  - init
```
public void init(AILocalSemanticConfig config,
                 AIASRListener listener)
```
    初始化本地识别引擎
    
    参数:
    
    config - 初始化参数 AILocalSemanticConfig
    
    listener - 本地识别回调接口AIASRListener
  - updateVocabs
```
public void updateVocabs(AIUpdateListener updateListener,
                         Vocab... vocabs)
```
    更新 ldm 词库
    
    参数:
    
    updateListener - 状态回调
    
    vocabs - 词库
  - getVocab
```
public java.util.List<java.lang.String> getVocab(java.lang.String vocabName)
```
    获取 ldm contents 同步方法读取联系人需要在线程中调用
    
    参数:
    
    vocabName - 文件名
    
    返回:
    
    词库内容
  - start
```
public void start()
```
    已过时。已过时, 不推荐使用
    
    默认配置启动引擎
    
    另请参阅:
    
    在AILocalSemanticIntent中配置此参数
  - start
```
public void start(AILocalSemanticIntent intent)
```
    识别+语义模式启动引擎
    
    参数:
    
    intent - 启动参数AILocalSemanticIntent
  - startWithRecording
```
public void startWithRecording()
```
    启动录音，开始语音识别
  - startWithText
```
public void startWithText(java.lang.String refText)
```
    已过时。请参考 startWithText(java.lang.String)
    
    启动引擎，输入文本
    
    参数:
    
    refText - 文本
  - startWithText
```
public void startWithText(java.lang.String refText,
                          java.lang.String pinyin)
```
    启动引擎，输入文本和拼音，拼音可从识别结果中获取
    
    参数:
    
    refText - 文本
    
    pinyin - 拼音
  - feedData
```
@Deprecated
public void feedData(byte[] data)
```
    已过时。
    
    传入数据,在不使用SDK内部录音机时调用
    
    参数:
    
    data - 音频数据流
    
    另请参阅:
    
    setUseCustomFeed(boolean)
  - feedData
```
public void feedData(byte[] data,
                     int size)
```
    传入数据,在不使用SDK内部录音机时调用
    
    参数:
    
    data - 音频数据流
    
    size - 音频数据大小
    
    另请参阅:
    
    setUseCustomFeed(boolean)
  - stopRecording
```
public void stopRecording()
```
    停止录音，等待识别结果
  - cancel
```
public void cancel()
```
    取消本次识别操作
  - destroy
```
public void destroy()
```
    销毁本地识别引擎

类 AILocalSemanticEngine

字段概要

方法概要

从类继承的方法 java.lang.Object

字段详细资料

TAG

方法详细资料

createInstance

checkLibValid

setAsrResBin

setAsrResBinPath

setAsrNetBin

setAsrNetBinPath

setSemResFolder

setSemResFolderPath

setSemLuaFolder

setSemLuaFolderPath

notifyWakeup

updateNetBinPath

updateNetBinPath

setDomain

setSkillID

setTask

setVadEnable

setVadRes

setVadResPath

setPauseTime

setUseDelimiter

setUseConf

setUseXbnfRec

setExpandFnPath

setUsePinyin

setUseFormat

setSelectRuleThreshold

setUseSelectRule

setNoSpeechTimeOut

setMaxSpeechTimeS

setUseMaxSpeechResult

setUseFrameSplit

setUseCustomFeed

setUseRefText

setLanguages

setSaveAudioPath

init

init

updateVocabs

getVocab

start

start

startWithRecording

startWithText

startWithText

feedData

feedData

stopRecording

cancel

destroy