实现 AI 变声

本文介绍如何通过 ZEGO Express SDK，实现 AI 变声功能。

前提条件

在实现 AI 变声功能之前，请确保：

已在项目中集成 ZEGO Express SDK，详情请参考快速开始 - 集成。
已在 ZEGO 控制台创建项目，并申请有效的 AppID 和 AppSign，详情请参考控制台 - 项目信息。

使用步骤

开发者可以按照以下步骤完成 AI 变声的相关设置：

1 开启权限

请参考控制台 - 云市场 - 大饼 AI 变声，按照页面指引，自助开通 大饼 AI 变声 相关权限；并在自己的项目中集成 大饼 AI 变声 的 SDK 包。

2 初始化和登录房间

初始化和登录房间的具体流程，请参考实现视频通话文档中的 “创建引擎” 及 “登录房间”。

3 初始化 AI 变声引擎实例

调用 createAIVoiceChanger 接口，创建 AI 变声引擎实例。

当前只支持同时创建一个实例，调用 destroyAIVoiceChanger 接口销毁实例之前，再次创建将返回 null。

// 创建 AI 变声引擎实例
var changer = await ZegoExpressEngine.instance.createAIVoiceChanger();

// 创建 AI 变声引擎实例
var changer = await ZegoExpressEngine.instance.createAIVoiceChanger();

监听 AI 变声引擎事件回调。

// 设置 AI 变声引擎事件回调
ZegoExpressEngine.onAIVoiceChangerInit = (aiVoiceChanger, errorCode) {
  print('📽️ [onAIVoiceChangerInit] '
      'idx: ${aiVoiceChanger.getIndex()}, errorCode: $errorCode');
};

ZegoExpressEngine.onAIVoiceChangerUpdate = (aiVoiceChanger, errorCode) {
  print('📽️ [onAIVoiceChangerUpdate] '
      'idx: ${aiVoiceChanger.getIndex()}, errorCode: $errorCode');
};

ZegoExpressEngine.onAIVoiceChangerGetSpeakerList =
    (aiVoiceChanger, errorCode, speakerList) {
  String content = '';
  int index = 0;
  for (ZegoAIVoiceChangerSpeakerInfo info in speakerList) {
    index += 1;
    content += '$index:[ID:${info.id}][name:${info.name}];';
  }
  print('📽️ [onAIVoiceChangerGetSpeakerList] '
      'idx: ${aiVoiceChanger.getIndex()}, errorCode: $errorCode, speakerList: $content');
};

// 设置 AI 变声引擎事件回调
ZegoExpressEngine.onAIVoiceChangerInit = (aiVoiceChanger, errorCode) {
  print('📽️ [onAIVoiceChangerInit] '
      'idx: ${aiVoiceChanger.getIndex()}, errorCode: $errorCode');
};

ZegoExpressEngine.onAIVoiceChangerUpdate = (aiVoiceChanger, errorCode) {
  print('📽️ [onAIVoiceChangerUpdate] '
      'idx: ${aiVoiceChanger.getIndex()}, errorCode: $errorCode');
};

ZegoExpressEngine.onAIVoiceChangerGetSpeakerList =
    (aiVoiceChanger, errorCode, speakerList) {
  String content = '';
  int index = 0;
  for (ZegoAIVoiceChangerSpeakerInfo info in speakerList) {
    index += 1;
    content += '$index:[ID:${info.id}][name:${info.name}];';
  }
  print('📽️ [onAIVoiceChangerGetSpeakerList] '
      'idx: ${aiVoiceChanger.getIndex()}, errorCode: $errorCode, speakerList: $content');
};

调用 ZegoAIVoiceChanger.initEngine 接口，初始化 AI 变声引擎实例。

注意
ZegoAIVoiceChanger.initEngine 接口需要在 startPublishingStream 接口之前调用才有效。
```
// 初始化 AI 变声引擎
await _changer?.initEngine();
```
```
// 初始化 AI 变声引擎
await _changer?.initEngine();
```

4 更新 AI 变声引擎模型

调用 ZegoAIVoiceChanger.update 接口，更新 AI 变声引擎模型。AI 变声引擎模型文件较大，首次更新时耗时会比较长，请您耐心等待。

// 更新 AI 变声引擎模型
await _changer?.update();

// 更新 AI 变声引擎模型
await _changer?.update();

5 获取音色列表

调用 ZegoAIVoiceChanger.getSpeakerList 接口，获取可用音色列表。

可用音色列表将通过 ZegoExpressEngine.onAIVoiceChangerGetSpeakerList 回调接口返回。

// 获取可用音色列表
await _changer?.getSpeakerList();

// 获取可用音色列表
await _changer?.getSpeakerList();

6 设置目标音色

调用 ZegoAIVoiceChanger.setSpeaker 接口，设置音色，音色的选择可以通过 5 获取音色列表获取。

设置音色 ID 为 0 时，表示使用原声。

// 设置音色
int speakerID = 0; // 音色 ID
await _changer?.setSpeaker(speakerID);

// 设置音色
int speakerID = 0; // 音色 ID
await _changer?.setSpeaker(speakerID);

7 销毁 AI 变声引擎实例

功能使用结束后，调用 destroyAIVoiceChanger 接口，销毁 AI 变声引擎实例，释放麦克风等资源。

// 销毁 AI 变声引擎实例
await ZegoExpressEngine.instance.destroyAIVoiceChanger(_changer);

// 销毁 AI 变声引擎实例
await ZegoExpressEngine.instance.destroyAIVoiceChanger(_changer);