## 使用AIUIAgent
AIUIAgent仅对已开通AIUI功能的APPID可下载使用，未开通的应用，可通过SpeechUnderstander使用语义理解。
创建AIUIAgent实例并开启服务，AIUIAgent需要使用VAD资源，请把 res/vad 目录下的资源文件，拷到由AIUI参数中vad的res_path参数（参考附录说明）指定的工程 assets/res/vad 目录下。
~~~
mAIUIAgent = AIUIAgent.createAgent( this, aiuiParams, mAIUIListener );
AIUIMessage startMsg = new AIUIMessage(AIUIConstant.CMD_START
, 0
, 0
, null
, null );
mAIUIAgent.sendMessage( startMsg );
~~~
aiuiParams ，AIUIConsatnt.CMD_START 分别为AIUI参数和消息值，参考附录的相应说明。服务开启后，服务的状态和结果消息将通过 AIUIListener 返回，具体事件说明请参考附录。关于AIUIAgent类的更多说明，参考《AIUI Service Kit Manual.html》。
### 文本语义理解示例
通过sendMessage发送要进行语义理解的文本数据，并通过AIUIListener的回调，获取结果或错误信息。
~~~
// 先发送唤醒消息，改变AIUI内部状态，只有唤醒状态才能接收语音输入
if( AIUIConstant.STATE_WORKING != this.mAIUIState ){
AIUIMessage wakeupMsg = new AIUIMessage(AIUIConstant.CMD_WAKEUP
, 0
, 0
, ""
, null);
mAIUIAgent.sendMessage(wakeupMsg);
}
String params = "data_type=text";
byte[] textData = "今天合肥的天气".getBytes();
AIUIMessage msg = new AIUIMessage(AIUIConstant.CMD_WRITE
, 0
, 0
, params
, textData);
mAIUIAgent.sendMessage(msg);
~~~
### 语音语义理解示例
通过sendMessage发送消息，设置AIUI服务为已唤醒状态，再发送开始录音消息，通过麦克风录入音频，并通过AIUIListener的回调，获取结果或错误信息。
~~~
// 先发送唤醒消息，改变AIUI内部状态，只有唤醒状态才能接收语音输入
if( AIUIConstant.STATE_WORKING != this.mAIUIState ){
AIUIMessage wakeupMsg = new AIUIMessage(AIUIConstant.CMD_WAKEUP
, 0
, 0
, ""
, null);
mAIUIAgent.sendMessage(wakeupMsg);
}
// 打开AIUI内部录音机，开始录音
String params = "sample_rate=16000,data_type=audio";
AIUIMessage writeMsg = new AIUIMessage( AIUIConstant.CMD_START_RECORD
, 0
, 0
, params
, null );
mAIUIAgent.sendMessage(writeMsg);
~~~
返回的语义结果，参考[语义结果说明文档](http://aiui.xfyun.cn/info/protocol)。
### 更新词典
AIUIAgent提供了上传词典的功能。如在线听写词典章节所述，更新词典只在对应的 LANGUAGE，ACCENT或 “ent”下生效，而AIUIAgent在进行语音语义理解时使用的默认参数值，可能与听写的不一样，因此，直接通过AIUIAgent更新词典，可以保证其在使用AIUIAgent 进行语音语义会话时生效。
~~~
// 先发送唤醒消息，改变AIUI内部状态，只有唤醒状态才能接收语音输入
if( AIUIConstant.STATE_WORKING != this.mAIUIState ){
AIUIMessage wakeupMsg = new AIUIMessage(AIUIConstant.CMD_WAKEUP
, 0
, 0
, ""
, null);
mAIUIAgent.sendMessage(wakeupMsg);
}
AIUIMessage msg = new AIUIMessage(AIUIConstant.CMD_UPLOAD_LEXICON
, 0
, 0
, params
, null);
mAIUIAgent.sendMessage(msg);
~~~
其中，params 为含词典内容JSON数据，参考附录对 CMD_UPLOAD_LEXICON消息的说明。上传成功与否的状态，通过AIUIListener的事件获取。
