1.1. 使用AIUIAgent

AIUIAgent仅对已开通AIUI功能的APPID可下载使用，未开通的应用，可通过SpeechUnderstander使用语义理解。

创建AIUIAgent实例并开启服务，AIUIAgent需要使用VAD资源，请把 res/vad 目录下的资源文件，拷到由AIUI参数中vad的res_path参数（参考附录说明）指定的工程 assets/res/vad 目录下。

  1. mAIUIAgent = AIUIAgent.createAgent( this, aiuiParams, mAIUIListener );
  2. AIUIMessage startMsg = new AIUIMessage(AIUIConstant.CMD_START
  3.     , 0
  4.     , 0
  5.     , null
  6.     , null );
  7. mAIUIAgent.sendMessage( startMsg );

aiuiParams ，AIUIConsatnt.CMD_START 分别为AIUI参数和消息值，参考附录相应说明。服务开启后，服务的状态和结果消息将通过 AIUIListener 返回，具体事件说明请参考附录。关于AIUIAgent类的更多说明，参考AIUI SDK开发文档。

1.1.1. 文本语义理解示例

通过sendMessage发送要进行语义理解的文本数据，并通过AIUIListener的回调，获取结果或错误信息。

  1. // 先发送唤醒消息，改变AIUI内部状态，只有唤醒状态才能接收语音输入
  2. if( AIUIConstant.STATE_WORKING != this.mAIUIState ){
  3.   AIUIMessage wakeupMsg = new AIUIMessage(AIUIConstant.CMD_WAKEUP
  4.     , 0
  5.     , 0
  6.     , ""
  7.     , null);
  8. mAIUIAgent.sendMessage(wakeupMsg);
  9. }
  11. String params = "data_type=text";
  12. byte[] textData = "今天合肥的天气".getBytes();
  13. AIUIMessage msg = new AIUIMessage(AIUIConstant.CMD_WRITE
  14.     , 0
  15.     , 0
  16.     , params
  17.     , textData);
  18. mAIUIAgent.sendMessage(msg);

1.1.2. 语音语义理解示例

通过sendMessage发送消息，设置AIUI服务为已唤醒状态，再发送开始录音消息，通过麦克风录入音频，并通过AIUIListener的回调，获取结果或错误信息。

  1. // 先发送唤醒消息，改变AIUI内部状态，只有唤醒状态才能接收语音输入
  2. if( AIUIConstant.STATE_WORKING != this.mAIUIState ){
  3.   AIUIMessage wakeupMsg = new AIUIMessage(AIUIConstant.CMD_WAKEUP
  4.     , 0
  5.     , 0
  6.     , ""
  7.     , null);
  8. mAIUIAgent.sendMessage(wakeupMsg);
  9. }
  10. // 打开AIUI内部录音机，开始录音
  11. String params = "sample_rate=16000,data_type=audio";
  12. AIUIMessage writeMsg = new AIUIMessage( AIUIConstant.CMD_START_RECORD
  13.     , 0
  14.     , 0
  15.     , params
  16.     , null );
  17. mAIUIAgent.sendMessage(writeMsg);

返回的语义结果，参考AIUI开放平台语义结果说明文档。

1.1.3. 更新词典

AIUIAgent提供了上传词典的功能。如在线听写词典章节所述，更新词典只在对应的 LANGUAGE，ACCENT或 “ent”下生效，而AIUIAgent在进行语音语义理解时使用的默认参数值，可能与听写的不一样，因此，直接通过AIUIAgent更新词典，可以保证其在使用AIUIAgent 进行语音语义会话时生效。

  1. // 先发送唤醒消息，改变AIUI内部状态，只有唤醒状态才能接收语音输入
  2. if( AIUIConstant.STATE_WORKING != this.mAIUIState ){
  3.   AIUIMessage wakeupMsg = new AIUIMessage(AIUIConstant.CMD_WAKEUP
  4.     , 0
  5.     , 0
  6.     , ""
  7.     , null);
  8. mAIUIAgent.sendMessage(wakeupMsg);
  9. }
  11. AIUIMessage msg = new AIUIMessage(AIUIConstant.CMD_UPLOAD_LEXICON
  12.     , 0
  13.     , 0
  14.     , params
  15.     , null);
  16. mAIUIAgent.sendMessage(msg);

其中，params 为含词典内容JSON数据，参考附录对 CMD_UPLOAD_LEXICON消息的说明。上传成功与否的状态，通过AIUIListener的事件获取。