AIUI文档中心

在快速入门一节里，导入SDK时导入的cfg文件就是本节介绍的配置文件。AIUI初始化时会读取这些参数配置，根据配置初始化各个内部模块。

# 配置文件

# 配置文件示例

AIUI的配置内容格式是json，配置了AIUI运行时各方面的参数：

/* AIUI Mobile版本参数配置 */
{
	/* 交互参数 */
	"interact":{
		"interact_timeout":"60000",
		"result_timeout":"5000"
	},
	
	/* 全局设置 */
	"global":{
		"scene":"main",
		"clean_dialog_history":"auto"
	},
	
	/* 业务相关参数 */
	// 本地vad参数
	"vad":{
		"vad_enable":"1", 
		"engine_type":"meta",
		"res_type":"assets",
		"res_path":"vad/meta_vad_16k.jet"
	},
	
	// 识别（音频输入）参数
	"iat":{
		"sample_rate":"16000"
	},

	/* 业务流程相关参数 */
	// 语音业务流程控制
	"speech":{
		"data_source":"sdk"
	}，

	/* 用户参数，透传到后处理(非必须)*/
	"userparams":{
		"xxxx": "xxx" //自定义字段
	}，

	"tts": {
		"play_mode": "sdk",     // 播放模式，取值：sdk（内部播放，默认），user（外部自行播放）
		"buffer_time": "0",     // 音频缓冲时长，当缓冲音频大于该值时才开始播放，默认值：0ms
		"stream_type": "3",     // 播放音频流类型，取值参考AudioManager类，默认值：3
		"audio_focus": "0"      // 播放音频时是否抢占焦点，取值：1, 0（默认值）
	}
}

# 配置字段说明

用户定制的场景参数，不同的场景可对应不同的云端处理流程。

参数类型		参数名称
login	语音云登录参数	appid	在讯飞开放平台上注册的8位应用唯一标识。
global	全局参数设置	scene
global	全局参数设置	clean_dialog_history	清除交互历史设置 auto 自动清除历史（默认模式） user 用户手动清除历史
interact	交互参数	interact_timeout	交互超时(单位：ms) 即唤醒之后，如果在这段时间内无有效交互则重新进入待唤醒状态，取值：[10000,180000)。默认为1min。
interact	交互参数	result_timeout	结果超时（单位：ms）即检测到语音后端点后一段时间内无结果返回则抛出10120错误码。默认值：5000。
speech	业务相关参数	data_source	录音数据来源配置 sdk sdk内部录音 user 外部录音参见录音处理
speech	业务相关参数	interact_mode	交互模式设置 continuous 持续交互，对于语音即“一次唤醒，多次交互” oneshot（默认模式）一次交互，对于语音即“一次唤醒，一次交互” oneshot举例：问：叮咚叮咚，给我唱首歌（说完后AIUI即进入休眠状态）答：请欣赏xxxx。后续AIUI因已休眠不能继续交互,需重新唤醒才能继续交互。
vad	音频端点检测参数	vad_enable	vad开启取值： 1（vad开启） 0（vad关闭）默认值：1。
		engine_type	vad引擎类型取值：meta（模型vad）默认值：meta。
		res_type	资源类型使用模型vad时必须设置，取值： assets资源（apk工程的assets文件） res资源（apk工程的res文件） path资源（sdcard文件）
		res_path	资源文件路径使用模型vad时必须设置。
		vad_bos	VAD前端超时时间单位：毫秒示例 "5000"
		vad_eos	VAD后端超时时间单位：毫秒示例 "1000"
		cloud_vad_eos	云端VAD后端超时时间单位：毫秒示例 "30000"
		cloud_vad_gap	云端VAD分句间隔上限值：1800 单位：毫秒示例 "400"
audioparams	音频透传参数设置	msc.lng	经度示例：117.16334474130745
audioparams	音频透传参数设置	msc.lat	纬度示例：31.821021912318592
log	日志相关参数	debug_log	Debug日志开关取值：1（打开），0（关闭），默认值：0。日志打开时会向logcat打印调试日志。
		save_datalog	是否保存数据日志取值：1（打开），0（关闭），默认值：0。打开之后会将所有上传到云端的音频和云端返回的结果保存到本地，保存的路径位于/sdcard/AIUI/data/，每一次唤醒后的交互音频都保存在此目录下wakeXX开始的文件夹下。
		datalog_path	数据日志的保存路径当不设置或者为空值时，使用默认值：“/sdcard/AIUI/data/”。
		datalog_size	数据日志的大小限制（单位：MB）取值：[-1，+∞) 默认值：-1（表示无大小限制）。注意：设置成-1可能会造成SD卡被日志写满，从而导致AIUI性能下降，影响体验效果。

# 动态配置

配置文件中的情景模式和后台应用定义的情景模式对应，在后台可以为不同情景模式配置不同语义技能、问答库，通过本地的配置文件或者动态设置场景可使用不同情景模式下对应的业务。使用方法如下所示：

Android 示例代码

String setParams = "{\"global\":{\"scene\":\"main\"}}"
AIUIMessage setMsg = new AIUIMessage(CMD_SET_PARAMS, 0 , 0, setParams, "");
mAgent.sendMessage(setMsg);

iOS/Linux/Windows 示例代码

const char* setParams = "{\"global\":{\"scene\":\"main\"}}";
IAIUIMessage* writeMsg=IAIUIMessage::create(AIUIConstant::CMD_SET_PARAMS, 0, 0, setParams, NULL);
m_angent->sendMessage(writeMsg);
writeMsg->destroy();

← SDK介绍消息事件 →