3.5.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、通用大模型链路不支持流式文本合成，如果有需要的话，建议创建新应用对接极速超拟人协议</div>
	<div style="font-size: 14px; line-height: 1.5;">2、<b>普通发音人</b>调用方式见 【3.3.4语音合成】 文档说明。</div>
	<div style="font-size: 14px; line-height: 1.5;">3、AIUI平台支持的发音人及分类详见【3.8发音人列表】说明。</div>
  </div>
</div>

## 2. 调用说明

### 2.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;">在通用大模型链路下进行主动超拟人合成时，需要注意情景模式取值（<b>scene：IFLYTEK.hts</b>） </div>
  </div>
</div>

示例超拟人发音人：聆小琪
- vcn：**x4_lingxiaoqi_oral**

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

### 2.2 构建请求
确认参数后，构建文本合成请求发送即可,Android 示例代码如下：
~~~ java
// 合成文本
String text = "今天晚上吃点啥好呢";
byte[] textData = text.getBytes("utf-8");

// 合成参数
String params = "vcn=x4_lingxiaoxuan_oral,volume=100,scene=IFLYTEK.hts";

// 合成事件发送
AIUIMessage ttsMessage = new AIUIMessage(AIUIConstant.CMD_TTS, AIUIConstant.START, 0,params,textData);
mAIUIAgent.sendMessage(ttsMessage);
~~~

## 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;
		}
	}
};
~~~