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中对应回调方法的说明。

results matching ""

    No results matching ""