VTuber语音通话开发指南（Agroa/Unity）

1.        软/硬件环境准备

1)      Unity3D 5.5 或更高版本。

2)      两部或多部支持音频功能的 Android 真机 (4.0 或更高版本)。

3)      一个 App ID，详见 https://docs.agora.io/cn/Agora%20Platform/token?platform=All%20Platforms#app-id

2.        Demo配置

1)      下载Agroa Unity语音版SDK及Demo，下载地址：https://docs.agora.io/cn/Interactive%20Gaming/downloads

2)      解压上述文件，用Unity打开samples文件夹下的“Hello-Unity3D-Agora”示例工程。“Hello-Unity3D-Agora”示例工程演示了一下功能：创建/加入频道；自由发言；离开频道

3)      在 [Agora.io 注册](https://dashboard.agora.io/cn/signup/) 注册账号，并创建自己的测试项目，获取到 AppID。将 AppID 填写进 HelloUnity3D.cs

```private static string appId = "YOUR APP ID";```

4)      在项目的根目录下，创建如下文件夹或路径：

Assets/Plugins/Android/AgoraAudioKit.plugin/libs

Assets/Scripts/AgoraGamingSDK

5)      添加如下SDK：

-把SDK中 **libs/Android/** 下的内容，复制到Hello-Unity3D-Agora项目的 **Assets/Plugins/Android/AgoraAudioKit.plugin/libs/** 文件夹下；

- 把SDK中 **libs/iOS/** 下的内容，复制到Hello-Unity3D-Agora项目的 **Assets/Plugins/iOS/** 文件夹下

- 把SDK中 **libs/macOS/** 下的内容，复制到Hello-Unity3D-Agora项目的 **Assets/Plugins/macOS/** 文件夹下

- 把SDK中 **libs/x86/** 下的内容，复制到Hello-Unity3D-Agora项目的 **Assets/Plugins/x86/** 文件夹下

- 把SDK中 **libs/x86_64/** 下的内容，复制到Hello-Unity3D-Agora项目的 **Assets/Plugins/x86_64/** 文件夹下

- 把SDK中 **libs/Scripts/AgoraGamingSDK/** 下的内容，复制到Hello-Unity3D-Agora项目的 **Assets/Scripts/AgoraGamingSDK/** 文件夹下

3.        运行Demo

1)      配置完APPID，添加完SDK后，即可以运行Demo了。可以在Unity Editor里面直接运行，也可以发布到Android手机手机上查看效果，如下图所示。

2)      以发布到Android手机运行为例：

在Hello-Unity3D-Agora Demo界面的文本输入框中输入房间号，如“106”，点击“Join Channel”即进入语音通话房间；另一端也加入“106”房间即可互相即时语音通话。如果需要结束语音通话，点击“Leave Channel”按钮即可结束本次通话。

备注：通话双方的APP ID 及 房间号需要相同。

图1 Demo运行截图

4.        代码说明

1)      HelloUnity3D.cs

public void JoinChannel (){}

将此方法与JoinChannel按钮绑定，点击按钮触发此函数加入语音房间。

public void LeaveChannel (){}

将此方法与LeaveChannel按钮绑定，点击按钮触发此函数离开语音房间。

2)      其他说明

声网语音通话提供多种语音模式，具体参见以下连接中的API使用说明：https://docs.agora.io/cn/Interactive%20Gaming/game_unity?platform=Unity

其中自由通话模式支持双向语音通话，可在加入房间前，在Start（）函数中设置自由语音通话模式：

mRtcEngine.SetChannelProfile (CHANNEL_PROFILE.GAME_FREE_MODE);