3.6.4 声音复刻

<div style="max-width: 100%; margin: 20px auto;">
    
    <div style="background-color: #ffffff; border-radius: 8px; box-shadow: 0 2px 8px rgba(0,0,0,0.1); overflow: hidden; font-family: 'Comic Sans MS', cursive, sans-serif;">
        
        
        <div style="background-color: #F4F8FA; padding: 1px 10px; border-bottom: 1px solid #dee2e6; display: flex; justify-content: space-between; align-items: center;">
            <div style="color: #0E42D2; font-weight: bold;font-size: 1.3rem;">概述</div>
            <div>
            </div>
        </div>
        
        <div style="padding: 25px; line-height: 29px; background-image: linear-gradient(transparent 26px, #dee2e6 27px, #dee2e6 27px, transparent 27px); background-size: 100% 28px; min-height: 100px; color: #333;">
            <div>声音复刻是录入一段音频生成AI定制音色的能力。</div>
			<a href="#资源注册" style="color: #6f42c1; font-weight: 500;">
			<strong>- 资源注册>>>点击跳转</strong></a>
			<a href="#资源查询" style="color: #6f42c1; font-weight: 500;margin-left: 40px;">&emsp;&emsp;&emsp;<strong>- 资源查询>>>点击跳转</strong></a>
            <div>
			<a href="#资源删除" style="color: #6f42c1; font-weight: 500;">
			<strong>- 资源删除>>>点击跳转</strong></a>
			<a href="#合成调用" style="color: #6f42c1; font-weight: 500;margin-left: 40px;">&emsp;&emsp;&emsp;<strong>- 合成调用>>>点击跳转</strong></a>
			</div>
        </div>
        
        </div>
    </div>
</div>

## 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、声音复刻能力使用前需先联系讯飞商务获取授权或发送邮件到 aiui_support@iflytek.com 提交申请。</div>
    <div style="font-size: 14px; line-height: 1.5;">2、每个设备（SN）最多注册绑定3个资源id。</div>
  </div>
</div>

### 1.1 资源管理
AIUI SDK提供了声音复刻资源管理能力，开发者可以直接进行声音复刻资源相关操作，包括：
- 复刻资源注册
- 复刻资源查询
- 复刻资源删除

####  1.1.1 资源注册

<div style="display: flex; align-items: center; background-color: #fff3cd; border-left: 6px solid #ffc107; border-radius: 4px; padding: 12px 16px; gap: 8px;">
    <div style="width: 30px; height: 30px; flex-shrink: 0;">
        <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2" stroke-linecap="round" stroke-linejoin="round">
            <path d="M12 9v2m0 4h.01m-6.938 4h13.856c1.54 0 2.502-1.667 1.732-3L13.732 4c-.77-1.333-2.694-1.333-3.464 0L3.34 16c-.77 1.333.192 3 1.732 3z"/>
        </svg>
    </div>
    <div style="flex: 1; line-height: 1.6;">
	<h3 style="margin: 0 0 6px 0; font-weight: 600;">注意：</h3>
        <p style="margin: 0; font-size: 0.95rem;">使用时客户端需要自行存储res_id，避免丢失</p>
    </div>
</div>

- 加载音频文件注册，音频要求：
>   时长: 建议20s~40s
>   文件大小范围：[480KB, 3MB]
>   采样率: 24000
>   通道数: 1
>   位深: 16
>   编码格式: 裸音频pcm

- 接口调用方式如下（Android示例）：

```java
// 注册音频保存的路径
// 注意音频文件格式和参数要求
String path = "";

JSONObject paramsJson = new JSONObject();
paramsJson.put(AIUIConstant.KEY_RES_PATH, path);
// 构建注册事件
AIUIMessage regVoice = new AIUIMessage(AIUIConstant.CMD_VOICE_CLONE,AIUIConstant.VOICE_CLONE_REG, 0, paramsJson.toString(), null);

mAIUIAgent.sendMessage(regVoice);

```

####  1.1.2. 资源查询
查询当前设备所注册的所有资源id

- Android示例：

```java
// 构建资源查询事件
AIUIMessage queryVoice = new AIUIMessage(AIUIConstant.CMD_VOICE_CLONE,
	AIUIConstant.VOICE_CLONE_RES_QUERY, 0, "", null);
mAIUIAgent.sendMessage(queryVoice);

```

####  1.1.3. 资源删除
根据指定注册的资源id进行删除。

- Android示例：

```java
// 注册好的资源id
String mCurResId = "resID";

JSONObject paramsJson = new JSONObject();
paramsJson.put(AIUIConstant.KEY_RES_ID, mCurResId);
// 构建资源删除事件
AIUIMessage delVoice = new AIUIMessage(AIUIConstant.CMD_VOICE_CLONE,
        AIUIConstant.VOICE_CLONE_DEL, 0, paramsJson.toString(), null);
mAIUIAgent.sendMessage(delVoice);

```

#### 1.1.4 结果回调解析

- 回调结果处理（Android示例）:

```java
/**
 * AIUI 回调
 */
private final AIUIListener mAIUIListener = new AIUIListener() {
    @Override
    public void onEvent(AIUIEvent aiuiEvent) {
        switch (aiuiEvent.eventType) {
            // 声音复刻：资源注册、资源查询和资源删除回调
            case AIUIConstant.EVENT_CMD_RETURN: {
                if (aiuiEvent.arg1 == AIUIConstant.CMD_VOICE_CLONE) {
                    int retCode = aiuiEvent.arg2;
                    int dtype = aiuiEvent.data.getInt(AIUIConstant.KEY_SYNC_DTYPE, -1);
                    if (dtype == AIUIConstant.VOICE_CLONE_REG) {
                        // 声音注册结果
                        if (retCode == AIUIConstant.SUCCESS) {
                        	String resId = aiuiEvent.data.getString(AIUIConstant.KEY_RES_ID, "");
                            showTip("注册成功，res_id=" + resId);
                        } else {
                            showTip("注册失败，error=" + retCode);
                        }
                    } else if (dtype == AIUIConstant.VOICE_CLONE_DEL) {
                        // 声音删除结果
                        if (retCode == AIUIConstant.SUCCESS) {
                            showTip("删除成功");
                        } else {
                            showTip("删除失败，error=" + retCode);
                        }
                    }else if (dtype == AIUIConstant.VOICE_CLONE_RES_QUERY) {
						// 已注册声音查询结果
						if (retCode == AIUIConstant.SUCCESS) {
							String result = aiuiEvent.data.getString("result", "");
							try {
								JSONObject resultJson = new JSONObject(result);
								if (!resultJson.isNull("data")) {
									JSONArray dataArray = resultJson.getJSONArray("data");
									if (dataArray != null) {
										showTip("查询结果：\n" + dataArray);
									} else {
										showTip("资源id为空");
									}
								} else {
									showTip("没有注册资源");
								}
							} catch (JSONException e) {
								e.printStackTrace();
							}
						} else {
							showTip("查询失败，error=" + retCode + "，" + getErrorDes(retCode));
						}
					}
                }
            }
        }
    }
};

```

### 1.2 能力使用

#### 1.2.1 主动合成请求
根据资源成功后的资源id，进行主动文本合成请求。
**在`极速超拟人交互链路`下进行声音复刻主动合成调用，合成文本除默认支持的`一帧发送完毕`，现升级也支持`分帧发送`。**

- 声音复刻合成参数示例：
> vcn：**x5_clone**
> res_id：**fsdfwee234324**
> scene：**IFLYTEK.tts**

- 合成请求示例（Android）：
下面提供合成文本一帧发送完毕方式，合成文本分帧流式合成调用详见文档【[3.6.3 流式合成](https://aiui-doc.xf-yun.com/project-1/doc-800/ "3.6.3 流式合成")】说明。

```java
// 合成文本
String text = "您好,欢迎使用科大讯飞语音合成技术。";
byte[] textData = text.getBytes("utf-8");

// 注册好的资源id
String mCurResId = "fsdfwee234324";

// 声音复刻vcn固定x5_clone，附带res_id
String params = "vcn=x5_clone,res_id=" + mCurResId;

AIUIMessage startTTS = new AIUIMessage(AIUIConstant.CMD_TTS, AIUIConstant.START, 0,params,textData);
mAIUIAgent.sendMessage(startTTS);
```

#### 1.2.2 全链路合成
全链路合成使用创建的审核复刻资源，集成方式有两种：
声音复刻合成参数示例：
> vcn：**x5_clone**
> res_id：**fsdfwee234324**
> scene：**IFLYTEK.tts**

- 在 aiui.cfg 中直接配置参数资源

``` json
    // 合成参数
    // "vcn" 发音人
	// "res_id" 声音复刻资源id，仅在 vcn=x5_clone时生效
    // "play_mode" 播放模式，取值："sdk"（SDK内部播放，默认），"user"（由开发者自己播放）
	"tts":{
	    "voice_name": "x5_clone",
	    "res_id":"fsdfwee234324",
        "play_mode": "sdk"
    },
```

- 通过动态参数设置指定需要的合成资源
<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、使用tts参数动态设置后，不区分音频和文本请求，全部生效</div>
  <div style="font-size: 14px; line-height: 1.5;">2、注意发音人参数key传值区别（vcn 或 voice_name），与aiui.cfg下tts配置项保持一致，如aiui.cfg配置文件没有传值，则任选。</div>
  </div>
</div>

``` java
================================================================
	场景1：传值voice_name
================================================================
// aiui.cfg 配置文件
"tts":{
	"voice_name": "x5_lingxiaoyue_flow",
	"play_mode": "sdk"
},

// 全链路合成动态参数设置
String setParams = "{\"tts\":{\"voice_name\":\"x5_clone\",\"res_id\":\"fsdfwee234324\",\"volume\":\"50\"}}";
AIUIMessage setMsg = new AIUIMessage(AIUIConstant.CMD_SET_PARAMS, 0 , 0, setParams, null);
mAIUIAgent.sendMessage(setMsg);

================================================================
	场景2：传值vcn
================================================================
// aiui.cfg 配置文件
"tts":{
	"vcn": "x5_lingxiaoyue_flow",
	"play_mode": "sdk"
},

// 全链路合成动态参数设置
String setParams = "{\"tts\":{\"vcn\":\"x5_clone\",\"res_id\":\"fsdfwee234324\",\"volume\":\"50\"}}";
AIUIMessage setMsg = new AIUIMessage(AIUIConstant.CMD_SET_PARAMS, 0 , 0, setParams, null);
mAIUIAgent.sendMessage(setMsg);

```

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