3.6.3 流式合成

## 1. 前言
本文档主要介绍在极速超拟人交互链路下，针对`极速超拟人发音人`的`流式合成`（分段合成）做详细说明。

<div style="display: flex; align-items: flex-start; gap: 16px; padding: 16px; background: #fff5f6; border-radius: 5px; border-left: 4px solid #e83e8c; box-shadow: 0 4px 12px rgba(255, 215, 0, 0.08); margin-bottom: 16px; transition: transform 0.2s ease, box-shadow 0.2s ease;">
  <div>
    <div style="font-weight: 600; margin-bottom: 4px;">温馨提示</div>
	<div style="font-size: 14px; line-height: 1.5;">1、极速超拟人交互链路下，<b>普通发音人</b>和<b>超拟人发音人</b>合成调用方式一样，调用方式见 【3.3.4语音合成】 文档说明。</div>
	<div style="font-size: 14px; line-height: 1.5;">2、AIUI平台支持的发音人及分类详见【3.8发音人列表】说明。</div>
  </div>
</div>

## 2. 调用说明

### 2.1  确认参数
在极速超拟人交互链路下，所有极速超拟人都免费开放开发者使用。各极速超拟人发音人信息见发音人列表（添加超链接）。

示例超拟人发音人：聆小玥
- vcn：**x5_lingxiaoyue_flow**

情景模式固定取值：
- scene：**IFLYTEK.tts**

### 2.2  构建请求
确认参数后，构建文本合成请求发送即可,Android 示例代码如下：
~~~ java

/**
 * 流式合成。
 * 
 * @param text 待合成文本
 * @param vcn 发音人（传入极速超拟人发音人取值）
 * @param dts 流状态，首帧取值：0（开始），中间帧取值：1（继续），尾帧取值：2（结束）
 * @param tag 自定义标签（非必选）
 */
void startStreamTTS(String text, String vcn, int dts, String tag) {
    try {
        // 在输入参数中设置tag，则对应结果中也将携带该tag，可用于关联输入输出
        String params = "vcn=" + vcn + ",data_status=" + dts + ",tag=" + tag;
        byte[] textData = text.getBytes("utf-8");

AIUIMessage ttsMessage = new AIUIMessage(AIUIConstant.CMD_TTS, 
            AIUIConstant.START, 0, params, textData);
        mAIUIAgent.sendMessage(ttsMessage);
    } catch (UnsupportedEncodingException e) {
        e.printStackTrace();
    }
}

/**
 * 一次完整示例。
 */
void example() {
	// 待合成分段文本
	String[] reqList = {"好嘞，","音量已经","调到一半","啦。"};

// 极速超拟人
	String vcn = "x5_lingxiaoyue_flow";
	
	int mode;
	for(int i=0 ; i < reqList.length ; i++){
		if (i == 0) {	// 首帧
			mode = 0;
		}else if ( i == (reqList.length-1)) { // 尾帧
			mode = 2;
		} else {	// 中间帧
			mode = 1;
		}
		startStreamTTS(reqList[i], vcn, mode, "");
	}
}

~~~

## 3. 结果解析
AIUI SDK所有类型合成结果处理方式一致，Android 示例如下：
~~~ java
private AIUIListener mAIUIListener = new AIUIListener() {

@Override
	public void onEvent(AIUIEvent event) {
		
			case AIUIConstant.EVENT_RESULT: {
				try {
					JSONObject bizParamJson = new JSONObject(event.info);
					JSONObject data = bizParamJson.getJSONArray("data").getJSONObject(0);
					JSONObject params = data.getJSONObject("params");
					JSONObject content = data.getJSONArray("content").getJSONObject(0);
					
					String sub = params.optString("sub");
					if ("tts".equals(sub)) {
						if (content.has("cnt_id")) {
							String sid = event.data.getString("sid");
							String cnt_id = content.getString("cnt_id");
							byte[] audio = event.data.getByteArray(cnt_id); //合成音频数据
							/**
							*
							* dts：音频块进度信息，取值：
							* - 0（音频开始）
							* - 1（音频中间块，可出现多次）
							* - 2（音频结束)
							* - 3（独立音频,合成短文本时出现）
							* 
							* 举例说明：
							* 常规合成dts顺序：
							*   0 1 1 1 ... 2
							* 短文本合成dts顺序:
							*   3
							**/
							int dts = content.getInt("dts"); 
							int frameId = content.getInt("frame_id");// 音频段id，取值：1,2,3,...
							
							int percent = event.data.getInt("percent"); //合成进度
						
							boolean isCancel = "1".equals(content.getString("cancel"));  //合成过程中是否被取消
						}
					}
				} catch (Throwable e) {
					e.printStackTrace();
				}
			} break；
			default:
				break;
		}
	}
};
~~~