Agora 教程：在 Cocos Creator 中实时游戏语音

Cocos Creator 从 v2.0.9 版本开始，已经深度集成了声网 Agora Voice SDK，广大 Cocos 开发者可以一键开通、下载并集成声网 SDK 到所需游戏项目，并且能在 Creator 中通过统一 JS APIs 来调用声网 Agora iOS/Android/Web SDK 接口，在各平台项目中快速实现实时语音功能。接下来我们来简单讲解一下。

在 Cocos Creator 中快速实现游戏语音功能

在开始进行开发前，大家需要确保已经安装 Cocos Creator v2.0.9，因为以下操作将通过新版 Cococs Creator 来实现。同时，由于实时语音功能需要调用麦克风，所以大家还需要准备好 Android 或 iOS 真机。为了保证第一次尝试的效果，建议大家关闭设备端的 VPN。

另外，如果你开发的是 Web 游戏，那么你的 Web 端浏览器还需要满足一些特定要求，详见声网文档中心（docs.agora.io）。

首先在 Cocos Creator 中打开你的游戏项目。然后选中 面板，在下拉菜单中选择 服务。

在屏幕右侧出现的 服务面板中选择 AgoraVoice，并点击 启用。Cocos Creator 会自动下载和配置所有声网服务依赖的资源。

至此，我们已经为 Cocos 游戏添加了实时语音服务，接下来需要通过 JS 调用 Agora SDK 的接口来实现实际功能了。

JS 调用 Agora SDK 接口

首先我们需要先登录 Agora DashBoard ，在 项目页面中获取自己的 App ID。然后将它填写到下述代码中。

var agoraCreator = require("agoraCreator");
agoraCreator.createEngine("AGORA APP ID");

我们支持通过 JS 来调用 SDK 接口。例如，可以通过 .setChannelProfile(profile)来设置频道模式，如果你希望在游戏中进行一对一或群聊，并且任何用户都可以自由说话，那么设定 profile 为通信模式（profile 为 0）即可；如果是想实现类似团战指挥的场景，那么可以采用直播模式（profile 为 1），然后利用 setClientRole 来设定“指挥者”的角色。

另外，开发者还可以通过 JS 接口来设置本地语音音效均衡、本地音效混响、音效音量等功能。如果希望了解详细的接口功能，参考 Demo，可以点击「阅读原文」获取。如果在开发过程中遇到疑问，可以在 RTC 开发者社区 （rtcdeveloper.com）提问。

接下来，值得期待的新功能

大家已经可以通过最新版 Cocos Creator 使用以上服务，在游戏中快速实现实时语音功能。接下来，我们还将在 Cocos Creator 中为开发者们提供实现游戏视频通话的功能，敬请期待。

目前，包括小米、完美世界、阿里游戏、SuperEvil 等知名游戏团队，已经采用 Agora SDK 在游戏中实现实时音视频互动功能。

本文转载自声网 Agora 公众号。

原文链接：https://mp.weixin.qq.com/s/YHFsKJRhW1wcG9zEIxbHtA