4.1 ControlResponse
系统控制作为aiLit最重量级的模块,包含大量需要通过回调方式对接的功能,请认真核对避免遗漏期望对接的功能。
因为控制簇回调,即要告知天琴执行结果,也可能要反馈需要播报的文本内容,因此多数控制回调方法的返回值都是控制反馈类(ControlResponse)。为了减少对接的麻烦程度,aiLit提供了以下快捷方法构造反馈对象:
客户: 反馈对象的使用和包装请根据开发人员指导实现.
天琴开发人员(内部): 反馈对象的使用和包装请根据模块需求实现(注意兼容及扩展性).
/**
* @param isSuccess true:执行成功; false:执行失败
* @param extra 播报文本/提示文本; 不需要播报传双引号(双引号="")
*/
public static ControlResponse response(boolean isSuccess, String extra);
/**
* @param isSuccess true:执行成功; false:执行失败
* @param extra 需要根据语音模块及接口逻辑指定(值 -> 不支持客户自定义)
*/
public static ControlResponse response(boolean isSuccess, int extra);
/**
* @param isSuccess true:执行成功; false:执行失败
* @param extra 需要根据语音模块及接口逻辑指定(值 -> 不支持客户自定义)
*/
public static ControlResponse response(boolean isSuccess, float extra);
/**
* @param isSuccess true:执行成功; false:执行失败
* @param extra 根据模块或者接口逻辑定义
*/
public static ControlResponse response(boolean isSuccess, boolean extra);
//以下方法默认执行成功
/**
* 默认执行成功 (isSuccess=true)
* @param extra 播报文本/提示文本; 不需要播报传双引号(双引号="")
*/
public static ControlResponse response(String extra);
/**
* 默认执行成功 (isSuccess=true)
* @param extra 需要根据语音模块及接口逻辑指定(值 -> 不支持客户自定义)
*/
public static ControlResponse response(int extra);
/**
* 默认执行成功 (isSuccess=true)
* @param extra 需要根据语音模块及接口逻辑指定(值 -> 不支持客户自定义)
*/
public static ControlResponse response(float extra);
/**
* @param extra 等同于修改isSuccess值
*/
public static ControlResponse response(boolean extra);
Tips: 其中extra作为String参数位存储,在此节中如果不特别说明,该参数均代表 反馈内容 。详细信息请翻阅JavaDoc中对应回调方法的说明。